# Data API ile tokenize hisse senetleri için günlük zincir üstü metrikler > Source: https://docs.blockvectra.com/tr/guides/stocks/ > Veriler halka açık zincir üstü kayıtlardan elde edilmiştir ve yalnızca bilgilendirme amaçlıdır. Yatırım tavsiyesi niteliği taşımaz. Robinhood Chain üzerinde sözleşme dağıtımı ve olay dinleme için [RPC ve WebSocket rehberini](https://docs.blockvectra.com/tr/guides/robinhood-chain/) takip edin. * **İlk adım:** Aşağıdaki curl komutunu kullanarak [en son bloğu bir API key olmadan okuyun](#1-read-the-latest-block-without-an-api-key). * **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](https://blockvectra.com/tr/chains/robinhood_mainnet/). ## Üç 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 ```bash 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](https://console.blockvectra.com/login/?next=%2Fkeys%2F\&ref=docs-stocks-task). 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](https://docs.blockvectra.com/tr/guides/programmatic-signup/?ref=docs-stocks-task) 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. ```bash 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: | Alan | Anlamı | | --------------------- | --------------------------------------------------------------------------------------------------- | | `data[].day` | Günlük metriklerin UTC tarihi. | | `data[].token` | Sorgu tarafından döndürülen hisse senedi token sözleşme adresi. | | `data[].symbol` | Token sembolü. | | `data[].transfers` | O gündeki zincir üstü transfer sayısı. | | `data[].holder_count` | Toplam sahip adres sayısı. | | `meta.as_of_block` | Günlük metrik anlık görüntüsünün blok yüksekliği yerine, mevcut indekslenmiş başlık. | | `meta.refreshed_at` | Anlık görüntü güncelleme zamanı; bu değer `null` olduğunda veriyi güncelliğini yitirmiş kabul edin. | 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](https://docs.blockvectra.com/tr/chains/) 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](https://docs.blockvectra.com/tr/chains/) 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](https://github.com/blockvectra/robinhood-stock-tokens) **cURL** ```bash curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?day=2026-09-29&limit=10" \ -H "x-api-key: $BLOCKVECTRA_API_KEY" ``` **TypeScript** ```ts const res = await fetch( "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?day=2026-09-29&limit=10", { headers: { "x-api-key": process.env.BLOCKVECTRA_API_KEY! }, }, ); const body = await res.json(); console.log(body); ``` **Python** ```python import os import requests res = requests.get( "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks?day=2026-09-29&limit=10", headers={"x-api-key": os.environ["BLOCKVECTRA_API_KEY"]}, ) print(res.json()) ``` ### 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** ```bash curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks/0x1111111111111111111111111111111111111111" \ -H "x-api-key: $BLOCKVECTRA_API_KEY" ``` **TypeScript** ```ts const token = "0x1111111111111111111111111111111111111111"; const res = await fetch( `https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks/${token}`, { headers: { "x-api-key": process.env.BLOCKVECTRA_API_KEY! }, }, ); const body = await res.json(); console.log(body); ``` **Python** ```python import os import requests token = "0x1111111111111111111111111111111111111111" res = requests.get( f"https://api.blockvectra.com/v1/data/robinhood_mainnet/stocks/{token}", headers={"x-api-key": os.environ["BLOCKVECTRA_API_KEY"]}, ) print(res.json()) ``` ### 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: | Alan | Tür | Açıklama | | ------------------------ | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------- | | `day` | `string` (tarih) | `YYYY-MM-DD` biçiminde UTC toplama tarihi. | | `token` | `string` (adres) | Token sözleşme adresi (yalnızca liderlik tablosu `StockDaily` içinde bulunur), `0x` ön ekiyle 40 küçük harfli onaltılık karakter. | | `symbol` | `string` | Token sembolü (örneğin `"EXMPL"`). | | `name` | `string` | Token görünen adı; eşleşen ad meta verisi bulunmadığında boş dize `""`. | | `transfers` | `integer` (int64) | Bu UTC günündeki toplam zincir üstü transfer sayısı. | | `unique_senders` | `integer` (int64) | Bu gün transfer başlatan benzersiz gönderici adreslerinin sayısı. | | `unique_receivers` | `integer` (int64) | Bu gün transfer alan benzersiz alıcı adreslerinin sayısı. | | `mint_raw_amount` | `string` (ondalık) | Bu gün basılan toplam ham token miktarı. | | `burn_raw_amount` | `string` (ondalık) | Bu gün yakılan toplam ham token miktarı. | | `net_supply_change` | `string` (ondalık) | Bu gündeki net arz değişimi (işaretli ondalık dize, negatif olabilir). | | `holder_count` | `integer` (int64) | Toplam sahip adres sayısı. | | `top10_holder_share_bps` | `integer` | İlk 10 sahibin baz puan cinsinden payı (0–10000, 1 bps = %0,01). | | `dex_swap_count` | `integer` (int64) | Bu gün bu token'ı içeren DEX takaslarının sayısı. | | `dex_raw_volume` | `string` (ondalık) | Bu gündeki toplam DEX ham işlem hacmi. | | `refreshed_at` | `string` (zaman damgası) | Bu günlük kaydın en son yenilendiği zamana ait ISO-8601 UTC zaman damgası. | ### 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: | Alan | Tür | Açıklama | | ----------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------- | | `address` | `string` (adres) | Token sözleşme adresi. | | `symbol` | `string` | Token sembolü. | | `name` | `string` | Tam token adı. | | `decimals` | `integer` veya `null` | Token ondalık basamakları (0–255) veya mevcut değilse `null`. | | `created_block` | `integer` (int64) | Token sözleşmesinin oluşturulduğu blok numarası. | | `created_tx_hash` | `string` (karma) | Sözleşme oluşturma işlem karması, `0x` ön ekiyle 64 küçük harfli onaltılık karakter. | | `factory` | `string` (adres) | Fabrika sözleşme adresi. | | `creator` | `string` (adres) veya `null` | Oluşturucu adresi veya mevcut değilse `null`. | | `mint_address` | `string` (adres) veya `null` | Mint adresi veya mevcut değilse `null`. | | `burn_address` | `string` (adres) veya `null` | Burn adresi veya mevcut değilse `null`. | | `daily` | `array` | Tarihe göre azalan sırada (en yeniden en eskiye) 30 güne kadar son günlük metrikler (`StockDailyMetric`) dizisi. | | `refreshed_at` | `string` (zaman damgası) | Token meta verilerinin en son yenilendiği zamana ait ISO-8601 UTC zaman damgası. | ### 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: - **Çağrı başına yöntem ağırlığı:** Her `data.stock` çağrısı 15 CU tüketir (1M çağrı başına liste fiyatı $1.50). - **Günlük 50 tokenı yenileme** (token başına bir `GET /{chain}/stocks/{token}` çağrısı, 50 çağrı/gün): günlük tüketim 750 CU'dur; 30 günlük bir döngüde bu, 22,500 CU tüketen toplam 1,500 çağrıya ulaşır ve ücretsiz kotanın yaklaşık <0.1%'sini (30,000,000 CU) kullanır. Ücretsiz hak aşılırsa veya ücretli bir planda, liste fiyatı üzerinden toplam kullanım yaklaşık <$0.01/aydır. ## 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](https://console.blockvectra.com/billing/) 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](https://docs.blockvectra.com/tr/api/json-rpc/#method-policy) 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](https://blockvectra.com/tr/pricing/) 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](https://blockvectra.com/tr/data/). * Hesabınızın neleri içerdiğini kontrol etmek için [ücretsiz planı ve fiyatlandırmayı inceleyin](https://blockvectra.com/tr/pricing/#free). * Bir API key oluşturmak için [konsolda oturum açın](https://console.blockvectra.com/login/?next=%2Fkeys%2F).