Data API ile tokenize hisse senetleri için günlük zincir üstü metrikler

Robinhood Chain üzerinde sözleşme dağıtımı ve olay dinleme için RPC ve WebSocket rehberini takip edin.

• İlk adım: Aşağıdaki curl komutunu kullanarak en son bloğu bir API key olmadan okuyun.
• Tamamlanma koşulu: Kimlik doğrulamalı hisse senetleri sorgusu data ve meta döndürür; mevcut kayıtlar day, token, transfers ve holder_count içerir, data: [] ise hiçbir etkinlik kaydının bulunmadığı anlamına gelir.

Mainnet parametreleri ve veri kümeleri.

Üç adımlı görev: Robinhood Chain'de hisse senedi etkinliğini sorgulama

En son kaydedilen UTC gününde en aktif tokenize hisse senetlerini bulun, ardından bunların transfer sayılarını ve sahip sayılarını okuyun.

Bir etkinlik panosu için tek bir API key kullanarak mainnet hisse senedi token etkinliğini ve sahiplerini sorgulayın. Bunlar hisse senedi fiyatları değil, zincir üstü etkinlik metrikleridir.

1. En son bloğu API key olmadan okuyun

curl -sS "https://api.blockvectra.com/v1/robinhood_mainnet/public" \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

JSON-RPC result alanı onaltılık formatta en son blok numarasıdır. Bu genel RPC çağrısı anahtar gerektirmez; 3. adımdaki Data API sorgusu bir anahtar gerektirir.

2. Aynı zincir için bir anahtar oluşturun

Konsolda oturum açın ve API Keys sayfasını açın. Bir anahtar oluşturun ve iletişim kutusunda gösterilen gizli anahtarı kaydedin. Aynı anahtar, robinhood_mainnet üzerinde hem JSON-RPC hem de Data API için çalışır.

Tarayıcı olmadan HTTP kullanan bir Yapay Zeka Ajanı için, bir Ethereum cüzdan imzasıyla kaydolmak ve bir anahtar oluşturmak üzere Programatik kayıt rehberini takip edin; kullanıcıdan anahtarı sohbete yapıştırmasını istemeyin.

3. Anahtarınızla hisse senedi etkinliğini sorgulayın

Aşağıdaki replace-with-your-key kısmını kaydettiğiniz anahtarla değiştirin, ardından komutu sunucunuzda veya yerel bir terminalde çalıştırın. day parametresini atlamak en son kaydedilen günü seçer; limit=5, transfer etkinliğine göre azalan sırada sıralanmış en fazla beş hisse senedini döndürür.

export BLOCKVECTRA_API_KEY='replace-with-your-key'

curl -sS "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?limit=5" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

Yanıttaki şu alanları okuyun:

Boş bir data dizisi, hiçbir etkinlik kaydının bulunmadığı anlamına gelir. Sonuçtaki bir hisse senedini incelemek için, aşağıda açıklandığı gibi token değerini GET /robinhood_mainnet/stocks/{token} ile kullanın.

Tokenize hisse senetleri veri kümesi nedir

BlockVectra Data API, tokenize hisse senetleri için günlük zincir üstü metrikler ve meta veriler sağlar. Bu veri kümesi; günlük transferleri, mint işlemlerini, burn işlemlerini, net arz değişikliklerini, sahip dağılımlarını ve merkeziyetsiz borsa (DEX) alım satım metriklerini toplayarak geliştiricilerin tokenize hisse senetlerine yönelik genel etkinliği takip etmelerini sağlar.

Bu veri kümesini sunan zincirler için Desteklenen Zincirler sayfasına bakın.

• Temel URL: https://api.blockvectra.com/v1/data — GET /chains hariç tüm Data API rotaları bir zincir tanımlayıcısı ile ön eklenir (örneğin https://api.blockvectra.com/v1/data/{chain}/…)
• Örnek zincir: robinhood_mainnet (örnek yol parametresi olarak kullanılmıştır; bu veri kümesini sunan tüm zincirler için Desteklenen Zincirler sayfasını kontrol edin)
• Kimlik Doğrulama: API key'inizi x-api-key: $BLOCKVECTRA_API_KEY istek başlığında belirtin
• Faturalandırma ve kapsam: Compute Unit (CU) cinsinden ölçülür; yalnızca 2xx başarılı yanıtlar faturalandırılır. Bir zincirde hisse senedi kapsamı yoksa, uç nokta HTTP 422 no_coverage döndürür (faturalandırılmaz)

Günlük liderlik tablosu (GET /{chain}/stocks)

GET /{chain}/stocks uç noktası, belirtilen bir UTC tarihi için tokenize hisse senetlerinin günlük etkinlik liderlik tablosunu, görüntüleme meta verileriyle (sembol, ad vb.) birlikte, transfer etkinliğine göre azalan sırada (en aktif token'lar başta) döndürür.

İstek parametreleri

• {chain} (yol parametresi, zorunlu): Zincir tanımlayıcısı (örneğin robinhood_mainnet).
• day (sorgu parametresi, isteğe bağlı): YYYY-MM-DD biçiminde UTC takvim tarihi. Belirtilmediğinde varsayılan olarak en son kaydedilen güne ayarlanır (herhangi bir etkinlik kaydedilmemişse data: [] ile 200 döndürür). Belirtilmiş ancak geçerli bir YYYY-MM-DD takvim tarihi değilse HTTP 400 döndürür (error.code = "bad_request").
• limit (sorgu parametresi, isteğe bağlı): Döndürülen kayıt sayısını sınırlar. Varsayılan değer 50'dir; 500'ün üzerindeki değerler 500'e kırpılır; 0 veya tam sayı olmayan bir değer iletildiğinde HTTP 400 döndürür (error.code = "bad_request").

Sayfalama davranışı

Bu uç nokta sayfalanmaz. limit parametresi döndürülen maksimum kayıt sayısını sınırlar. Kapsayıcı StockDailyListEnvelope (data ve meta) içinde, hisse senedi uç noktaları next_cursor döndürmez (anahtar tamamen yoktur, asla null değildir).

Kod örnekleri

Robinhood Chain üzerinde eksiksiz başlangıç şablonu: blockvectra/robinhood-stock-tokens

curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?day=2026-09-29&limit=10" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

Yanıt yapısı

Yanıt zarfı, data ve meta içeren StockDailyListEnvelope nesnesidir:

• data (dizi): Transfer etkinliğine göre azalan sırada (en aktif token'lar ilk sırada) günlük lider tablosu kayıtlarının (StockDaily) bir listesi. Her öğe token tanımlayıcılarını (token, symbol, name), transfer etkinliğini (transfers, unique_senders, unique_receivers), arz metriklerini (mint_raw_amount, burn_raw_amount, net_supply_change), dağıtım metriklerini (holder_count, top10_holder_share_bps), DEX alım satım metriklerini (dex_swap_count, dex_raw_volume) ve yenilenme zaman damgasını (refreshed_at) içerir.
• meta (nesne): Zincir meta verileri (chain, chain_slug, chain_external_id, as_of_block, safe_block, finalized_block, coverage, refreshed_at). meta.refreshed_at değeri null olabilir: null, bu verinin güncelleme zamanının bilinmediği ve güncelliğini yitirmiş kabul edilmesi gerektiği anlamına gelir; blok tabanlı uç noktalar her zaman bir değer döndürür.

Tek bir tokenize hisse senedini getirme (GET /{chain}/stocks/{token})

GET /{chain}/stocks/{token} uç noktası, token adresine göre belirli bir tokenize hisse senedi için meta verileri ve 30 güne kadar olan son günlük metrikleri getirir.

İstek parametreleri

• {chain} (yol parametresi, zorunlu): Zincir tanımlayıcısı (örneğin robinhood_mainnet).
• {token} (yol parametresi, zorunlu): 20 baytlık token sözleşme adresi; 0x ön eki isteğe bağlıdır ve büyük/küçük harf kabul edilir (döndürülen adresler 0x ve ardından 40 küçük harfli onaltılık basamağa normalleştirilir). Geçersiz bir adres biçimi HTTP 400 döndürür (error.code = "bad_request").
• {token} bilinen bir tokenize hisse senedi değilse HTTP 404 döndürür (error.code = "not_found"). {chain} bilinmeyen bir zincir ise HTTP 404 döndürür (error.code = "unknown_chain").

Kod örnekleri

curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks/0x1111111111111111111111111111111111111111" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

Yanıt yapısı

Yanıt zarfı, data ve meta içeren StockTokenEnvelope nesnesidir:

• data (nesne): Token sözleşme meta verilerini (address, symbol, name, decimals, created_block, created_tx_hash, factory, creator, mint_address, burn_address, refreshed_at) ve son günlük metrikler dizisini (daily) içeren bir StockToken nesnesi.
  • daily (dizi): Tarihe göre azalan sırada (en yeniden en eskiye) sıralanmış, 30 güne kadar son günlük metriklerin (StockDailyMetric) bir dizisi. Her günlük öğe, yukarıdaki liderlik tablosuyla aynı metrik şemasını paylaşır (gereksiz token, symbol ve name alanları hariç).
• meta (nesne): Liderlik tablosu yanıtıyla tutarlı zincir meta veri nesnesi.

Temel dönüş alanlarının açıklaması

Günlük metrik alanları (StockDaily ve StockDailyMetric)

Hem liderlik tablosu hem de tek token geçmiş günlük öğeleri aşağıdaki temel alanları içerir:

Token meta veri alanları (StockToken)

Tek bir token sorgulanırken dış data nesnesi sözleşme meta verilerini ve son günlük metrikleri içerir:

Kodlama kuralları

API, sayısal kesinliği ve tutarlılığı korumak için tüm uç noktalarda katı kodlama kurallarına uyar:

• Parasal güvenlik (Money-safety): 2^53 değerini aşabilecek herhangi bir değer (mint_raw_amount, burn_raw_amount, net_supply_change ve dex_raw_volume gibi 256-bit tam sayılar), asla bir JSON sayısı ve asla bilimsel veya onaltılık gösterim olarak değil, ondalık dize olarak serileştirilir. Bu, JavaScript gibi çalışma ortamlarında hassasiyet kaybını önler. JavaScript/TypeScript'te BigInt(str) ile ayrıştırın (örneğin const net = BigInt(body.data.daily[0].net_supply_change)); Python'da int(str) ile ayrıştırın. 2^53 değerinin oldukça altında kalan sayaçlar (transfers, unique_senders, unique_receivers, holder_count, top10_holder_share_bps, dex_swap_count, created_block) düz JSON sayılarıdır.
• İkili ve onaltılık değerler: Adresler 0x ve ardından 40 küçük harfli onaltılık karakterdir; karmalar 0x ve ardından 64 küçük harfli onaltılık karakterdir. Döndürülen tüm onaltılık değerler kesinlikle küçük harflidir.
• Zaman damgaları ve tarihler: refreshed_at gibi zaman damgaları YYYY-MM-DDTHH:MM:SSZ (saniye hassasiyetinde ISO-8601 UTC) kullanır. Günlük toplamlar (day) düz takvim tarihleri (YYYY-MM-DD) kullanır.

Kullanım tahmini (günlük 50 token yenileme)

Data API sorguları, platform yöntem ağırlıklarına göre Compute Unit (CU) tüketir. Aşağıdaki tahmin, 50 token'ın her birinin günde bir kez GET /{chain}/stocks/{token} çağırdığı bir senaryoyu aktif yöntem ağırlıklarına göre değerlendirir:

Başlarken ve yükseltme

Ücretsiz kota; geliştirme, test ve hafif iş yükleri için idealdir. Trafiğiniz genişlediğinde ve daha yüksek eşzamanlılık veya daha fazla işlem birimi gerektirdiğinde, konsolun Faturalandırma sayfasında zincir üstünde bakiye yükleyin; zincir üzerinde onaylanıp hesaba geçtiğinde, hesap genelindeki saniye başına çağrı sınırı kaldırılır. Her anahtar, JSON-RPC belgelerinde açıklandığı gibi CU hız ve patlama limitlerine tabi kalır. Kullanılmayan Ücretsiz Krediler kredilerinizde kalır ve kullanılmaya devam edebilir. Güncel oranlar ve faturalandırma birimleri için lütfen Fiyatlandırma sayfasına bakın.

Sonraki adımlar

• BlockVectra'nın indekslediği her veri kümesini görmek için veri kümeleri dizinine göz atın.
• Hesabınızın neleri içerdiğini kontrol etmek için ücretsiz planı ve fiyatlandırmayı inceleyin.
• Bir API key oluşturmak için konsolda oturum açın.