Spot ETF fonları
Bir varlığın kayıtlı her fonu için bir satır: ihraççı, veri tarihi, eldeki varlıklar, net varlıklar, pay sayısı, NAV, piyasa fiyatı, prim, ücret ve CoinBoss'un hesapladığı akış ya da fonun toplanamama nedeni.
/api/sd/etf/fundsİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| asset | string | Zorunlu | — | BTC, ETH, SOL, HYPE | Dayanak varlık, büyük/küçük harfe duyarsız. `coin` takma ad olarak kabul edilir. Örnek: BTC |
Örnek istek
curl -s "https://www.coinboss.com/api/sd/etf/funds?asset=BTC"Yanıt alanları
Alan tablosu gerçek yanıtlardan üretilir; dolayısıyla uç noktanın tam olarak ne döndürdüğünü listeler. Yollarda a[] dizi öğelerini, {*} ise coin veya borsa gibi dinamik bir adla anahtarlanan nesneleri gösterir.
| Alan | Tür | Birim | Açıklama |
|---|---|---|---|
| success | boolean | — | İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur. |
| schema | string | — | Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir. |
| now | number | ms | Yanıtın oluşturulduğu andaki sunucu zamanı. |
| asset | string | — | Dayanak varlık. |
| as_of | string | — | Kapsanan fonlar arasında ihraççının en yeni veri tarihi. |
| expected_as_of | string | — | Yayım süresi dolmuş olan en son ABD işlem günü. |
| funds_total | number | — | Varlık için kayıtlı fonlar. |
| funds_covered | number | — | İhraççı verisi güncel olan fonlar. |
| funds | array | — | Toplanamayan fonlar dahil, kayıtlı her fon için bir satır. |
| funds[] | object | — | Toplanamayan fonlar dahil, kayıtlı her fon için bir satır. |
| funds[].ticker | string | — | Fon ticker'ı. |
| funds[].issuer | string | — | Fon ihraççısının kimliği. |
| funds[].name | string | — | Fon adı. |
| funds[].status | string | — | OK, STALE, ERROR veya UNAVAILABLE. |
| funds[].as_of_date | string|null | — | Satırın ihraççı veri tarihi. |
| funds[].holdings_coin | number|null | coin | İhraççının açıkladığı biçimiyle elde tutulan coin miktarı. |
| funds[].holdings_usd | number|null | USD | İhraççının açıkladığı biçimiyle eldeki varlıkların piyasa değeri. |
| funds[].ref_price | number|null | USD | İhraççının kullandığı coin başına referans fiyat. |
| funds[].aum_usd | number|null | USD | Fonun net varlıkları. |
| funds[].aum_src | string|null | — | Net varlıkların nasıl elde edildiği: `reported`, `nav_x_shares` veya `holdings_mv_sum`. |
| funds[].shares_out | number|null | shares | Dolaşımdaki pay sayısı. |
| funds[].shares_src | string|null | — | Dolaşımdaki pay sayısının nasıl elde edildiği: `reported` veya net varlıklar ile NAV'dan türetilmiş. |
| funds[].nav | number|null | USD | Pay başına net varlık değeri. |
| funds[].market_price | number|null | USD | Pay başına kapanış piyasa fiyatı. |
| funds[].premium_pct | number|null | % | İhraççının yayımladığı biçimiyle piyasa fiyatının NAV'a göre primi (+) veya iskontosu (−). |
| funds[].fee_pct | number|null | % | Yıllık sponsor ücreti; yayımlanmıyorsa `null`. |
| funds[].flow_usd | number|null | USD | Fonun akış tarihindeki net pay oluşturma / itfa tutarı. CoinBoss yöntemi. |
| funds[].flow_shares | number|null | shares | Dolaşımdaki pay sayısındaki değişim. |
| funds[].flow_coin | null | coin | Eldeki coin miktarındaki değişim; coin olarak ödenen ücret tahakkukunu içerir, yalnızca bilgi amaçlıdır. |
| funds[].flow_method | string|null | — | Kullanılan formül: `shares_x_nav` veya `aum_nav_ratio_t1`. |
| funds[].flow_as_of | string|null | — | Akışın kaydedildiği tarih. |
| funds[].flow_obs_date | string|null | — | Kullanılan iki satırdan yeni olanının veri tarihi. |
| funds[].flow_prev_date | string|null | — | Kullanılan iki satırdan eski olanının veri tarihi. |
| funds[].flow_note | string|null | — | Akışın neden eksik veya özel olduğu (örneğin `no_previous_row`, `multi_day_gap`). |
| funds[].is_stale | boolean|null | — | Veri güncellik penceresinden eskiyse true. |
| funds[].source_url | string|null | — | Satırın toplandığı ihraççı uç noktası (yalnızca veri kökeni için). |
| funds[].observed_at | number|null | ms | Kaynağın veri için verdiği zaman damgası. |
| funds[].received_at | number|null | ms | CoinBoss toplayıcısının veriyi aldığı zaman. |
| funds[].unavailable_reason | string|null | — | Fon toplanamadığında neden kodu. |
| funds[].unavailable_detail | string|null | — | Fon toplanamadığında açıklama. |
| coverage | object | — | Sayılara nelerin dahil olduğu ve nelerin olmadığı. Toplamları başka bir kaynakla karşılaştırmadan önce bunu karşılaştırın. |
| coverage.included_exchanges | array | — | Güncel verisi dahil edilen kaynaklar. |
| coverage.included_exchanges[] | string | — | Güncel verisi dahil edilen kaynaklar. |
| coverage.unavailable | array | — | Dahil edilemeyen kaynaklar; her biri nedeniyle birlikte. Hiçbir zaman 0 olarak sayılmazlar. |
| coverage.unavailable[] | object | — | Dahil edilemeyen kaynaklar; her biri nedeniyle birlikte. Hiçbir zaman 0 olarak sayılmazlar. |
| coverage.unavailable[].exchange | string | — | Borsa kimliği (küçük harf). |
| coverage.unavailable[].issuer | string | — | Fon ihraççısının kimliği. |
| coverage.unavailable[].reason | string | — | Makine tarafından okunabilir neden kodu. |
| coverage.unavailable[].detail | string | — | Nedenin insan tarafından okunabilir açıklaması. |
| coverage.stale_excluded | array | — | Son güncellemesi güncellik penceresinin dışında kaldığı için hariç bırakılan satırlar. bu tabloyu üretmek için kullanılan örneklerde boş |
| method | object | — | Bu yanıtta kullanılan formüllerin düz metin açıklaması; alan başına bir girdi. |
| method.holdings_coin_total | string | — | `holdings_coin_total` için formül notu, düz metin. |
| method.aum_usd_total | string | — | `aum_usd_total` için formül notu, düz metin. |
| method.net_flow_usd | string | — | `net_flow_usd` için formül notu, düz metin. |
| method.net_flow_missing | string | — | `net_flow_missing` için formül notu, düz metin. |
| method.flow_coin | string | — | `flow_coin` için formül notu, düz metin. |
| method.premium_pct | string | — | `premium_pct` için formül notu, düz metin. |
| method.is_stale | string | — | `is_stale` için formül notu, düz metin. |
| method.units | string | — | `units` için formül notu, düz metin. |
| meta | object | — | Bu yanıtın veri kökeni ve güncelliği. |
| meta.schema | string | — | Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir. |
| meta.source | array | — | Verinin toplandığı herkese açık kaynak uç noktaları. |
| meta.source[] | object | — | Verinin toplandığı herkese açık kaynak uç noktaları. |
| meta.source[].exchange | string | — | Borsa kimliği (küçük harf). |
| meta.source[].endpoint | string | — | Toplayıcının okuduğu kaynağın herkese açık uç noktası (veri kökeni için gösterilir; istemciler bunu hiçbir zaman çağırmaz). |
| meta.observed_at | number | ms | Kaynağın veri için verdiği zaman damgası. |
| meta.received_at | number | ms | CoinBoss toplayıcısının veriyi aldığı zaman. |
| meta.fetched_at | number | ms | Bu yanıtın oluşturulduğu zaman. |
| meta.window | string | — | Sayıların kapsadığı zaman penceresi. |
| meta.quality | string | — | Veri zaman damgalarına ve kapsama göre değerlendirilen FRESH, PARTIAL, STALE, BROKEN veya UNAVAILABLE. |
| meta.is_stale | boolean | — | Veri güncellik penceresinden eskiyse true. |
| meta.cache_ttl_s | number | s | Bu yanıtın önbellek ömrü. |
| meta.fallback | string | — | Toplayıcı veya bir kaynak başarısız olduğunda uç noktanın ne döndürdüğü. |
Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 3 gerçek yanıt.
Örnek yanıt
/api/sd/etf/funds?asset=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:58:17 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: funds: 12 öğe içeriyordu; meta.source: 5 öğe içeriyordu; coverage.unavailable: 7 öğe içeriyordu.
- "success"true
- "schema""coinboss.sd.etf/1"
- "now"1794542297570
- "asset""BTC"
- "as_of""2026-11-12"
- "expected_as_of""2026-11-11"
- "funds_total"12
- "funds_covered"5
- "funds"
- "coverage"
- "included_exchanges"
- "unavailable"
- "stale_excluded"
- "method"
- "holdings_coin_total""sum of issuer-reported coin holdings over covered (non-stale) funds only; NOT a whole-market total, see funds_covered/funds_total"
- "aum_usd_total""sum of fund net assets (USD) over covered funds; aum_src per fund: reported | nav_x_shares (NAV x shares outstanding) | holdings_mv_sum (sum of issuer holdings …"
- "net_flow_usd""own method, per fund between two consecutive issuer as-of rows: shares_x_nav = (shares_out[t] - shares_out[t-1]) x NAV[t], dated t; aum_nav_ratio_t1 (issuer pub…"
- "net_flow_missing""covered funds not included in net_flow_usd and why: no_previous_row (needs two consecutive issuer rows), t1_booking_available_next_trading_day (Franklin: flow o…"
- "flow_coin""holdings_coin[t] - holdings_coin[t-1]; includes daily sponsor-fee accrual paid in coin, informational only"
- "premium_pct""issuer-reported premium/discount to NAV in percent; null when the issuer does not publish it"
- "is_stale""fund as_of_date older than the trading day before expected_as_of (expected_as_of = latest NYSE trading day whose T+1 16:00 UTC publication deadline has passed)"
- "units""holdings in coins; aum/flow in USD; nav/market_price in USD per share; fee_pct/premium_pct in percent"
- "meta"
- "schema""coinboss.sd.etf/1"
- "source"
- "observed_at"1794441600000
- "received_at"1794537318126
- "fetched_at"1794542297570
- "window""latest"
- "quality""PARTIAL"
- "is_stale"false
- "cache_ttl_s"300
- "fallback""collector failure keeps the last issuer row with its real as_of_date; a fund whose as_of_date is more than 1 trading day behind the expected as-of is flagged is…"
Doğrulanmış örnekler
Yoklama, yukarıdaki örneğin yanı sıra bu uç noktayı aşağıdaki parametrelerle de çağırır ve her seferinde şemayı kontrol eder.
| Parametreler | HTTP | Yanıt süresi | Sonuç |
|---|---|---|---|
| asset=ETH | 200 | 3 ms | Başarılı PARTIAL |
| asset=HYPE | 200 | 4 ms | Başarılı PARTIAL |
| asset=DOGE | 400 | 2 ms | Başarılı beklenen hatayı döndürür |
Kontrol: 2026-11-13 03:58:17 UTC
Ayrıntılar
- Kimlik doğrulama
- Yok. Herkese açık uç nokta.
- İstek sınırı
- IP başına dakikada 1200 istek
- Sunucu önbelleği
- 5m
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- Günde üç toplayıcı turu (02:35, 10:35, 16:35 UTC). İhraççılar ABD işlem günü başına bir kez, genellikle işlem tarihinin akşamında yayım yapar.
- Pencere
- Fon başına ihraççının en güncel veri tarihi.
- Veri kaynakları
- Fon ihraççılarının kendilerinin yayımladığı günlük bildirimler (eldeki varlıklar, net varlıklar, dolaşımdaki pay sayısı, NAV); CoinBoss tarafından toplanır ve saklanır (sd_etf_fund_daily). Net akış, bu bildirimlerden CoinBoss tarafından hesaplanır.
- Borsa kapsamı
- Yalnızca ihraççısı makine tarafından okunabilir günlük veri yayımlayan fonlar kapsanır. `funds_total` ve `funds_covered` bunların sayısını belirtir; kapsanmayan her fon, nedeniyle birlikte `coverage.unavailable` altında listelenir. Toplamlar piyasanın tamamını değil, yalnızca kapsanan fonların toplamını ifade eder (`totals_scope = "covered_funds_only"`).
- Sayfalama
- Sayfalama yok; varlığın kayıtlı tüm fonları döndürülür.
- Sıralama
- Ticker, artan.
- Birimler
- Amounts in USD; holdings in units of the underlying coin; NAV and market price in USD per share; `premium_pct` and `fee_pct` in percent.
- Yöntem
- `aum_src` tells how net assets were obtained: `reported`, `nav_x_shares` (NAV × shares outstanding) or `holdings_mv_sum` (sum of the issuer's holdings market values). `flow_method` tells which flow formula was used.
- Zaman damgaları
- Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
- Yanıt biçimi
- json
- Kararlılık
- Kararlı
- Kullanıma sunulma
- 2026-11-11
Canlı durum
Uç nokta veri kalitesini PARTIAL olarak bildiriyor — Kısmi kapsam: birkaç büyük ihraççı, bir sunucudan toplanabilecek, makine tarafından okunabilir herkese açık bir bildirim sunmuyor. Bu ihraççıların fonları mevcut değil olarak listelenir ve toplamlar yalnızca geri kalan fonları kapsar. Toplamları başka kaynaklarla karşılaştırmadan önce `funds_covered` / `funds_total` değerlerini karşılaştırın.
Erişilebilirlik, son 30 gün
407 kontrolde başarı oranı: %100
Hatalar
Başarısız çağrılar tüm uç noktalarda aynı yapıyı paylaşır. Tam liste hatalar sayfasındadır. Hatalar ve istek sınırları →
| Kod | HTTP | Anlamı | Ne yapmalı |
|---|---|---|---|
| INVALID_PARAM | 400 | Zorunlu bir parametre eksik ya da bir değer kabul edilmiyor. Biliniyorsa `param` parametrenin adını verir. | Değiştirmeden yeniden denemeyin; isteği düzeltin. |
| UNAUTHORIZED | 401 | `CB-API-KEY` başlığı gönderildi, ancak anahtar bilinmiyor veya iptal edilmiş. Herkese açık veriler anahtar gerektirmez; başlığı kaldırın veya geçerli bir anahtar kullanın. | Değiştirmeden yeniden denemeyin. |
| FORBIDDEN | 403 | Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel). | Yeniden denemeyin. |
| NOT_FOUND | 404 | Bilinmeyen rota ya da istenen coin / borsa / fon yok. | Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin. |
| RATE_LIMITED | 429 | Dakika başına sınırdan fazla istek gönderildi. `Retry-After`, beklenecek saniye sayısını verir. | `Retry-After` süresi kadar bekleyin, ardından artan beklemeyle yeniden deneyin. |
| INTERNAL | 500 | Beklenmeyen sunucu hatası. Mesaj bilinçli olarak geneldir; hatayı bildirirken `request_id` değerini belirtin. | Birkaç saniye sonra bir kez yeniden deneyin; sorun sürerse istek kimliğiyle birlikte bildirin. |
| UPSTREAM_FAILED | 503 | Bu uç noktanın arkasındaki veri kaynağı zamanında yanıt vermedi. Yerine eskimiş veya ikame rakamlar döndürülmez. | Artan beklemeyle yeniden deneyin; durum sayfasını kontrol edin. |
| UNAVAILABLE | 501 / 503 | Veri kümesi geçici olarak hazır değil (önbellek ısınıyor) ya da uç noktanın henüz yasal bir herkese açık kaynağı yok. | Daha sonra yeniden deneyin; katalog, tasarım gereği mevcut olmayan uç noktaları işaretler. |
| REQUEST_FAILED | 200 | Bazı eski uç noktalar HTTP 200 ile `success: false` yanıtı verir. Yalnızca HTTP durumunu değil, her zaman `success` değerini de kontrol edin. | Mesaja bağlıdır; başarısız bir istek olarak ele alın. |
Deneyin
/api/sd/etf/fundsKısmistring — Underlying asset, case-insensitive. `coin` is accepted as an alias.
https://www.coinboss.com/api/sd/etf/funds?asset=BTCBu kategoride daha fazlası
- Spot ETF fonları /api/sd/etf/funds
- Spot ETF geçmişi /api/sd/etf/history
- Spot ETF özeti (ihraççı açıklamaları) /api/sd/etf/overview
- Fon bazında günlük spot ETF net akışları /api/etf/detail
- Günlük spot ETF net akış geçmişi /api/etf/flows
- Tek ETF ayrıntısı /api/etf/fund/:ticker
- ETF fon listesi /api/etf/funds
- Fon bazında ETF'lerin elindeki coin varlıkları /api/etf/holdings
- Tek ihraççının ETF / trust ürünleri /api/etf/issuer
- ETF özeti /api/etf/overview
- Grayscale trust primi / iskontosu /api/grayscale/premium
- Vadeli işlem tabanlı ETF hacimleri /api/indicators/futures-etf-volumes