24s Hacim—Açık pozisyon—24s Likidasyon$1.36B24s Long/Short—BTC Hakimiyeti—ETH Hakimiyeti—
Uygulama
Dil ▾
₺ TRY ▾
/api/sd/etf/history
GETKısmiPARTIAL

Spot ETF geçmişi

Tek bir varlık (kapsanan fonların toplamı) ya da tek bir fon için eldeki varlıkların, net varlıkların veya net akışın günlük serisi. Her nokta kaç fon içerdiğini belirtir.

GET/api/sd/etf/history
Kısmi kapsam. 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.

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
assetstringZorunlu—BTC, ETH, SOL, HYPEDayanak varlık, büyük/küçük harfe duyarsız. `coin` takma ad olarak kabul edilir. Örnek: BTC
metricstringZorunlu—holdings, aum, flowDöndürülecek seri: eldeki varlıklar (coin), net varlıklar (USD) veya net akış (USD). Örnek: flow
rangestringİsteğe bağlı30d30d, 90d, allGeriye dönük aralık.
tickerstringİsteğe bağlı——Varlık için kayıtlı fon ticker'ı (örneğin `ARKB`). Varsayılan: kapsanan tüm fonların toplamı. Kayıtlı olmayan bir ticker 404 döndürür; toplanamayan kayıtlı bir fon ise `series: null` ile 200 döndürür.

Örnek istek

curl -s "https://www.coinboss.com/api/sd/etf/history?asset=BTC&metric=flow"

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.

AlanTürBirimAçıklama
successboolean—İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur.
schemastring—Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir.
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
assetstring—Dayanak varlık.
metricstring—`metric` parametresiyle seçilen seri.
rangestring—Uygulanan geriye dönük aralık.
tickerstring|null—Fon ticker'ı.
unitstring—Seri değerlerinin birimi: `coin` veya `USD`.
funds_totalnumber—Varlık için kayıtlı fonlar.
funds_in_seriesarray—Seriye katkıda bulunan fonlar.
funds_in_series[]string—Seriye katkıda bulunan fonlar.
first_date_by_fundobject—Fon başına mevcut ilk tarih (anahtar, ticker'dır). dinamik anahtarlar: ARKB,EZBC
first_date_by_fund.{*}string—Fon başına mevcut ilk tarih (anahtar, ticker'dır).
pointsnumber—Seri noktaları, en eskiden başlayarak.
seriesarray—Günlük noktalar, en eskiden başlayarak; fon toplanamadığında `null`.
series[]object—Günlük noktalar, en eskiden başlayarak; fon toplanamadığında `null`.
series[].datestring—Noktanın ihraççı veri tarihi.
series[].valuenumber—Seçilen metriğin, o tarihte mevcut olan fonlar üzerinden toplanmış değeri.
series[].fundsnumber—Toplanamayan fonlar dahil, kayıtlı her fon için bir satır. bulunmayabilir
coverageobject—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_exchangesarray—Güncel verisi dahil edilen kaynaklar.
coverage.included_exchanges[]string—Güncel verisi dahil edilen kaynaklar.
coverage.unavailablearray—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[].exchangestring—Borsa kimliği (küçük harf).
coverage.unavailable[].issuerstring—Fon ihraççısının kimliği.
coverage.unavailable[].reasonstring—Makine tarafından okunabilir neden kodu.
coverage.unavailable[].detailstring—Nedenin insan tarafından okunabilir açıklaması.
coverage.stale_excludedarray—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ş
methodobject—Bu yanıtta kullanılan formüllerin düz metin açıklaması; alan başına bir girdi.
method.valuestring—`value` için formül notu, düz metin.
method.fundsstring—`funds` için formül notu, düz metin.
method.multi_daystring—`multi_day` için formül notu, düz metin.
method.history_startstring—`history_start` için formül notu, düz metin.
metaobject—Bu yanıtın veri kökeni ve güncelliği.
meta.schemastring—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.sourcearray—Verinin toplandığı herkese açık kaynak uç noktaları.
meta.source[]object—Verinin toplandığı herkese açık kaynak uç noktaları.
meta.source[].exchangestring—Borsa kimliği (küçük harf).
meta.source[].endpointstring—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_atnumbermsKaynağın veri için verdiği zaman damgası.
meta.received_atnumbermsCoinBoss toplayıcısının veriyi aldığı zaman.
meta.fetched_atnumbermsBu yanıtın oluşturulduğu zaman.
meta.windowstring—Sayıların kapsadığı zaman penceresi.
meta.qualitystring—Veri zaman damgalarına ve kapsama göre değerlendirilen FRESH, PARTIAL, STALE, BROKEN veya UNAVAILABLE.
meta.is_staleboolean—Veri güncellik penceresinden eskiyse true.
meta.cache_ttl_snumbersBu yanıtın önbellek ömrü.
meta.fallbackstring—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/history?asset=BTC&metric=flow · Gerçek yanıt, yakalanma zamanı: 2026-11-13 01:42:50 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: series: 21 öğe içeriyordu; meta.source: 5 öğe içeriyordu; first_date_by_fund: 5 öğe içeriyordu; coverage.unavailable: 7 öğe içeriyordu.

  • {
    • "success": true,
    • "schema": "coinboss.sd.etf/1",
    • "now": 1794533872027,
    • "asset": "BTC",
    • "metric": "flow",
    • "range": "30d",
    • "ticker": null,
    • "unit": "USD",
    • "funds_total": 12,
    • "funds_in_series": [
      • "ARKB",
      • "BITB",
      • "BTCO",
      • "EZBC",
      • "HODL"
      ],
    • "first_date_by_fund": {
      • "ARKB": "2026-10-14",
      • "BITB": "2026-11-11"
      },
    • "points": 21,
    • "series": [
      • { … 3 },
      • { … 3 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 5 ],
      • "unavailable": [ … 2 ],
      • "stale_excluded": []
      },
    • "method": {
      • "value": "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…",
      • "funds": "number of funds contributing to that date; the aggregate is only comparable across dates with the same contributing funds (history starts on different dates per…",
      • "multi_day": "true when a contributing flow spans more than one trading day because the issuer history has no row for the day(s) in between",
      • "history_start": "issuer-provided official history is back-filled where it exists (21Shares valuation history, Franklin price history); other issuers start on the first collectio…"
      },
    • "meta": {
      • "schema": "coinboss.sd.etf/1",
      • "source": [ … 2 ],
      • "observed_at": 1794355200000,
      • "received_at": 1794501317131,
      • "fetched_at": 1794533872027,
      • "window": "30d",
      • "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.

ParametrelerHTTPYanıt süresiSonuç
asset=ETH&range=90d&metric=aum2004 msBaşarılı PARTIAL
asset=BTC&metric=holdings&ticker=ARKB2004 msBaşarılı FRESH
asset=BTC4001 msBaşarılı beklenen hatayı döndürür

Kontrol: 2026-11-13 01:28:14 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
30d / 90d / all, ihraççının her veri tarihi için bir nokta.
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; `range` nokta sayısını sınırlar.
Sıralama
Tarih, 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
A point sums the funds that have a row on that date; `funds` is that count. Points with different `funds` are not directly comparable. Flow is bucketed by its booking date.
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

KısmiKontrol: 2026-11-13 01:37:52 UTCHTTP 2006 msŞema eşleşiyorEn yeni veri noktası 9h öncesine ait

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

380 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ı →

KodHTTPAnlamıNe yapmalı
INVALID_PARAM400Zorunlu 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.
UNAUTHORIZED401`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.
FORBIDDEN403Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel).Yeniden denemeyin.
NOT_FOUND404Bilinmeyen rota ya da istenen coin / borsa / fon yok.Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin.
RATE_LIMITED429Dakika 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.
INTERNAL500Beklenmeyen 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_FAILED503Bu 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.
UNAVAILABLE501 / 503Veri 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_FAILED200Bazı 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

GET/api/sd/etf/historyKısmi
Parametreler

string — Underlying asset, case-insensitive. `coin` is accepted as an alias.

string — Series to return: holdings (coin), net assets (USD) or net flow (USD).

string · varsayılan 30d — Look-back range.

string — Fund ticker registered for the asset (for example `ARKB`). Default: all covered funds summed. An unregistered ticker returns 404; a registered fund that cannot be collected returns 200 with `series: null`.

İstek URL'sihttps://www.coinboss.com/api/sd/etf/history?asset=BTC&metric=flow
Bir uç nokta seçip “İstek gönder” düğmesine basın. Yanıt, başlıklar ve süre bilgisi burada görünür.