Halka açık şirketlerin / kurumların coin hazineleri
Halka açık şirketlerin / kurumların coin hazineleri
/api/treasuries/:coinİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| coin path | string | Zorunlu | bitcoin | bitcoin, ethereum | ethereum dışındaki her değer bitcoin sayılır. Örnek: bitcoin |
“path” olarak işaretlenen parametreler URL'nin parçasıdır.
Örnek istek
curl -s "https://www.coinboss.com/api/treasuries/bitcoin"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. |
| coin | string | — | Coin sembolü, büyük harfle (örneğin BTC). |
| total_holdings | number | coin | Listelenen tüm halka açık şirketlerin elindeki toplam coin; 6 saatte bir yenilenen üçüncü taraf bir anlık görüntüden alınır. |
| total_value_usd | number | USD | `total_holdings` değerinin güncel USD karşılığı. |
| market_cap_dominance | number | % | `total_holdings` değerinin coin arzına oranı, yüzde olarak; kaynağın yayımladığı biçimiyle. |
| count | number | — | Öğe sayısı. |
| companies | array | — | Coini tutan halka açık şirketler; her şirket için bir kayıt. |
| companies[] | object | — | Tek bir şirket: ad, ticker, ülke, eldeki varlıklar, maliyet ve güncel değer. |
| companies[].name | string | — | Ad. |
| companies[].symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| companies[].country | string | — | Şirketin iki harfli ülke kodu. |
| companies[].holdings | number | coin | Şirketin elindeki coin miktarı. |
| companies[].entry_value_usd | number | USD | Şirketin elindeki varlıkların toplam alım maliyeti. |
| companies[].current_value_usd | number | USD | Şirketin elindeki varlıkların güncel piyasa değeri. |
| companies[].pct_supply | number | % | Şirketin elindeki varlıkların coinin toplam arzına oranı, yüzde olarak. |
Üretilme zamanı: 2026-11-11 23:01 UTC; kaynak: 1 gerçek yanıt.
Örnek yanıt
/api/treasuries/bitcoin · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:59:24 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: companies: 181 öğe içeriyordu.
- "success"true
- "coin""bitcoin"
- "total_holdings"1301532.2192943657
- "total_value_usd"89970988447.37521
- "market_cap_dominance"6.2
- "count"181
- "companies"
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
- 30m
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- istek anında, 6 saat önbelleğe alınır
- Pencere
- en güncel anlık görüntü
- Veri kaynakları
- Halka açık şirketlerin kripto hazinelerindeki varlıklar; herkese açık bir piyasa verisi API'sinden alınır.
- Borsa kapsamı
- BTC veya ETH tutan halka açık şirketler (`bitcoin` | `ethereum`; diğer tüm değerlerde bitcoin kullanılır).
- Birimler
- coins held; USD value; percent of total supply
- Zaman damgaları
- Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
- Yanıt biçimi
- json
- Kararlılık
- Kararlı
Canlı durum
Erişilebilirlik, son 30 gün
408 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/treasuries/:coinKullanılabilirstring · varsayılan bitcoin — Anything other than ethereum is bitcoin.
https://www.coinboss.com/api/treasuries/bitcoinBu kategoride daha fazlası
- Çok zincirli adres sorgusu /api/browser/:chain/address/:addr
- Çok zincirli blok sorgusu /api/browser/:chain/block/:hashOrHeight
- Çok zincirli işlem sorgusu /api/browser/:chain/tx/:txid
- Bir adresin hangi EVM zincirlerinde aktif olduğunu saptar /api/browser/detect
- BTC zenginler listesi adreslerindeki bakiye değişimleri /api/btc/rich-flow
- BTC zenginler listesi /api/btc/rich-list
- BTC zenginler listesi istatistikleri /api/btc/rich-stat
- BTC zenginler listesi varlık trendi /api/btc/rich-trend
- Bitcoin adres özeti /api/explorer/address/:addr
- Bitcoin adres işlemleri /api/explorer/address/:addr/txs
- Bitcoin blok ayrıntısı /api/explorer/block/:hashOrHeight
- Bitcoin zincir ucu /api/explorer/tip
- Bitcoin işlem ayrıntısı /api/explorer/tx/:txid
- Belirli bir eşikten fazla BTC tutan adres sayısı /api/indicators/addr-above/:tier
- BTC zincir üstü değerleme göstergesi serisi /api/indicators/bdc/:name
- Erişilebilir Bitcoin düğümü sayısı ve dağılımı /api/indicators/bitnodes
- BTC sahipleri karşılaştırma serisi /api/indicators/btccmp/:pair
- BTC zincir üstü grafik serisi /api/indicators/chain
- Borsalara BTC girişi / çıkışı geçmişi /api/indicators/cm/exchange-flows
- Borsalarda tutulan BTC arzı /api/indicators/cm/exchange-supply
- Bakiyesi sıfırdan büyük BTC adresi sayısı geçmişi /api/indicators/cm/nonzero-addresses
- Devletlerin BTC varlıkları /api/indicators/gov-treasuries
- Bitcoin yarılanma geri sayımı ve geçmişi /api/indicators/halving
- N yıldan uzun süredir hareketsiz BTC arzının payı /api/indicators/hodl-wave-above/:years
- Bitcoin madencilik havuzlarının blok payı /api/indicators/mempool/pools
- Strategy BTC maliyet tabanı ve varlık geçmişi /api/indicators/mstr-cost
- Kârda olan BTC arzının payı /api/indicators/supply-profit-pct
- WBTC rezerv bakiyesi geçmişi /api/indicators/wbtc-balance
- Çok zincirli zenginler listesi /api/rich-list/:chain
- Çok zincirli zenginler listesi bakiye değişimleri /api/rich-list/:chain/flow
- Çok zincirli zenginler listesi istatistikleri /api/rich-list/:chain/stat
- Çok zincirli zenginler listesi varlık trendi /api/rich-list/:chain/trend
- Halka açık şirketlerin / kurumların coin hazineleri /api/treasuries/:coin