Fon bazında ETF'lerin elindeki coin varlıkları
Fon bazında ETF'lerin elindeki coin varlıkları
/api/etf/holdingsİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| asset | string | İsteğe bağlı | BTC | BTC, ETH, SOL, HYPE | Dayanak varlık. Başka herhangi bir değer 400 `INVALID_PARAM` döndürür. Örnek: BTC |
Örnek istek
curl -s "https://www.coinboss.com/api/etf/holdings?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. |
| asset | string | — | Varlık sembolü. |
| unit | string | — | Bu nesnedeki değerlerin birimi. |
| count | number | — | Öğe sayısı. |
| latest | object | — | En son kayıt. |
| latest.date | string | — | Takvim tarihi (UTC). |
| latest.holdings | number | — | Fonun elinde tuttuğu coin miktarı. |
| latest.aum_pct_of_mcap | number | % | Varlığın spot ETF'lerinin toplam AUM değerinin, `data` içindeki en son tarihte coinin piyasa değerine yüzde olarak oranı. |
| data | array | — | Veri yükü. |
| data[] | object | — | Veri yükü. |
| data[].date | string | — | Takvim tarihi (UTC). |
| data[].holdings | number | — | Fonun elinde tuttuğu coin miktarı. |
| data[].aum_pct_of_mcap | number | % | Varlığın spot ETF'lerinin toplam AUM değerinin, o tarihte coinin piyasa değerine yüzde olarak oranı; üçüncü taraf bir kaynaktan alınır. |
Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 1 gerçek yanıt.
Örnek yanıt
/api/etf/holdings?asset=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:58:19 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data: 64 öğe içeriyordu.
- "success"true
- "asset""BTC"
- "unit""token_count"
- "count"64
- "latest"
- "date""2026-10-08"
- "holdings"1282351.4417
- "aum_pct_of_mcap"6.3813
- "data"
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ığı
- toplayıcı saatlik çalışır, ancak kaynak 2026-10-08'den beri devre dışıdır
- Pencere
- depolanan günlük geçmişin tamamı (2026-10-08'de biter)
- Veri kaynakları
- Bir varlığın tüm ABD spot ETF'lerinin elinde tuttuğu toplam coin miktarı; üçüncü taraf bir ETF veri sitesinden alınır.
- Borsa kapsamı
- BTC, ETH, SOL (depolandığı biçimiyle); 2026-10-08'den sonra veri yok.
- Sıralama
- tarih, artan
- Birimler
- holdings in coins (token count); aum_pct_of_mcap in percent
- Zaman damgaları
- Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
- Yanıt biçimi
- json
- Kararlılık
- Kararlı
Canlı durum
En yeni veri noktası 3124699 s öncesine ait (beklenen: 345600 s içinde)
Erişilebilirlik, son 30 gün
410 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/etf/holdingsAksamalıstring · varsayılan BTC — Underlying asset. Any other value returns 400 `INVALID_PARAM`.
https://www.coinboss.com/api/etf/holdings?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