Coin hacim sayfası verileri
Coin hacim sayfası verileri (borsa dağılımı ve 30 günlük günlük seri)
/api/volume/coinİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| symbol | string | Zorunlu | — | — | Coin sembolü (büyük harfe çevrilir, en çok 30 karakter); veri yoksa 404. Örnek: BTC |
Örnek istek
curl -s "https://www.coinboss.com/api/volume/coin?symbol=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. |
| data | object | — | Veri yükü. |
| data.symbol | string | — | CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT). |
| data.total_24h_usd | number | USD | Coinin listelenen borsalardaki (hacme göre en büyük 15 borsa) 24h vadeli hacminin toplamı. |
| data.exchanges | array | — | Borsalar. |
| data.exchanges[] | object | — | Borsalar. |
| data.exchanges[].exchange | string | — | Borsa kimliği, küçük harfle (örneğin `binance`). |
| data.exchanges[].volume_usd | number | USD | USD nominal değeri cinsinden hacim. |
| data.exchanges[].share_pct | number | % | Toplam içindeki pay. |
| data.daily_30d | array | — | Son 30 günün günlük hacim geçmişi, en eskisi başta; her UTC günü için bir kayıt. |
| data.daily_30d[] | object | — | Bir UTC günü: `volume_usd`, o günün son saatlik anlık görüntüsü olan `as_of` anında alınmış kayan 24h hacim anlık görüntüsüdür. |
| data.daily_30d[].date | string | — | Takvim tarihi (UTC). |
| data.daily_30d[].volume_usd | number | USD | USD nominal değeri cinsinden hacim. |
| data.daily_30d[].as_of | number | ms | Bu güne dahil edilen son örneğin zamanı. |
| data.daily_30d_basis | string | — | Günlük serinin nasıl oluşturulduğu (hangi örneklerin kullanıldığı ve geçmişin nerede başladığı). |
Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 4 gerçek yanıt.
Örnek yanıt
/api/volume/coin?symbol=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:17:31 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data.daily_30d: 8 öğe içeriyordu; data.exchanges: 15 öğe içeriyordu.
- "success"true
- "data"
- "symbol""BTC"
- "total_24h_usd"58523832510.53
- "exchanges"
- "daily_30d"
- "daily_30d_basis""rolling_24h_volume_snapshot_last_of_utc_day"
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ç |
|---|---|---|---|
| symbol=ETH | 200 | 18 ms | Başarılı |
| symbol=SOL | 200 | 17 ms | Başarılı |
| symbol=ARKM | 200 | 17 ms | Başarılı |
Kontrol: 2026-11-13 02:57:34 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
- 2m
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- ticker'lar dakikada bir; anlık görüntüler saatlik; bellek içi önbellek 120 s
- Pencere
- borsa bazında 24h; 30 günlük nokta
- Veri kaynakları
- Tek coinin 24h vadeli hacminin, borsaların herkese açık ticker'larına göre borsa bazında dağılımı; ayrıca saatlik hacim anlık görüntülerimizden üretilen 30 günlük bir günlük seri.
- Borsa kapsamı
- Coin için hacme göre ilk 15 borsa
- Sayfalama
- yok
- Sıralama
- hacim, azalan
- Birimler
- USD; share in percent
- Yöntem
- share_pct = exchange volume / SUM(top 15 exchanges) * 100
- 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
403 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/volume/coinKullanılabilirstring — Coin symbol (upper-cased, max 30); 404 when no data.
https://www.coinboss.com/api/volume/coin?symbol=BTCBu kategoride daha fazlası
- Coin ısı haritası verileri /api/coin-heatmap
- Tam coin listesi /api/coins/all
- Coin arama /api/coins/search
- Coin sayfası borsa tablosu /api/currency/ex-table
- Coin para akışı /api/currency/flows
- Gezinme için coin listesi /api/currency/list
- Tek coin için borsa bazında piyasalar /api/currency/markets
- Coin ayrıntı özeti /api/currency/overview
- Dönemlere göre coin fiyat performansı /api/currency/performance
- Tek coin için spot taker net girişi /api/currency/spot-netflow
- Marj borçlanma oranı matrisi /api/margin-fee/matrix
- Marj borçlanma oranları /api/margin/rates
- Yükselenler ve düşenler (hacim alt sınırıyla) /api/market/gainers-losers
- Piyasa değeri en yüksek coinlerde hızlı hareket özeti /api/market/top-movers
- Aylık / çeyreklik / yıllık getiri matrisi /api/p3/btc-returns
- Günlük getiri matrisi /api/p3/btc-returns-daily
- Haftalık getiri matrisi /api/p3/btc-returns-weekly
- Yükselenler ve düşenler (vadeli veya spot) /api/p3/gainers-losers
- Saatlik mumlar /api/p3/klines
- Volatilite özeti /api/p3/volatility
- Tek coin için volatilite geçmişi /api/p3/volatility/series
- Spot coin piyasa listesi /api/spot/coins
- Coin hacim sayfası verileri /api/volume/coin