GETKullanılabilir
Ana sayfa ticker şeridi toplamları
Ana sayfa ticker şeridi toplamları (toplam hacim, OI, likidasyonlar; 24h değişimle)
GET
/api/market/home-tickerİstek
Bu uç nokta parametre almaz.
Örnek istek
curl -s "https://www.coinboss.com/api/market/home-ticker"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. |
| now | number | ms | Yanıtın oluşturulduğu andaki sunucu zamanı. |
| data | object | — | Veri yükü. |
| data.volume_24h | object | — | 24h hacim. |
| data.volume_24h.value | number | — | Değer. |
| data.volume_24h.change_pct | number | % | Yüzde değişim. |
| data.open_interest | object | — | Tüm borsaların güncel sözleşme satırları üzerinden toplanan açık pozisyon (`value`, USD) ve 24 saat önceki saatlik anlık görüntüye göre değişimi (`change_pct`). |
| data.open_interest.value | number | — | Değer. |
| data.open_interest.change_pct | number | % | Yüzde değişim. |
| data.liq_24h | object | — | Son 24 saatin likidasyonları: USD cinsinden `value`, `long_usd`, `short_usd` ve önceki 24 saate göre `change_pct`. |
| data.liq_24h.value | number | — | Değer. |
| data.liq_24h.change_pct | number | % | Yüzde değişim. |
| data.liq_24h.long_usd | number | USD | Long taraf. |
| data.liq_24h.short_usd | number | USD | Short taraf. |
| data.long_short | object | — | Long/short bloğu. |
| data.long_short.long_pct | number | % | Long payı. |
| data.long_short.short_pct | number | % | Short payı. |
| data.btc_dominance | number | % | BTC piyasa değeri ÷ izlenen coinlerin toplam piyasa değeri × 100; piyasa değeri anlık görüntüsü kullanılamıyorsa null. |
| data.eth_dominance | number | % | ETH piyasa değeri ÷ izlenen coinlerin toplam piyasa değeri × 100; piyasa değeri anlık görüntüsü kullanılamıyorsa null. |
Üretilme zamanı: 2026-11-11 23:01 UTC; kaynak: 1 gerçek yanıt.
Örnek yanıt
/api/market/home-ticker · Gerçek yanıt, yakalanma zamanı: 2026-11-13 04:03:41 UTC.
- "success"true
- "now"1794542611510
- "data"
- "volume_24h"
- "open_interest"
- "liq_24h"
- "long_short"
- "btc_dominance"57.46
- "eth_dominance"9.8
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
- 60s
- Edge mikro önbelleği
- 10s
- Güncelleme sıklığı
- ticker'lar dakikada bir; OI/fonlama/long-short 5 dakikada bir (ana coinler dakikada bir); likidasyonlar akışla gelir; API önbelleği 60 s
- Pencere
- 24h kayan pencere, önceki 24h ile karşılaştırmalı
- Veri kaynakları
- Vadeli işlem hacmi, açık pozisyon ve long/short oranı borsaların herkese açık API'lerinden derlenir; likidasyonlar borsaların likidasyon akışlarından, BTC/ETH dominansı ise üçüncü taraf piyasa verisi agregatörünün piyasa değerlerinden gelir.
- Borsa kapsamı
- Verisi toplanan tüm türev borsaları; long/short yalnızca hesap oranı yayımlayan borsalar için (binance, okx, bybit, bitget, gate, htx, kraken)
- Sayfalama
- yok
- Birimler
- USD; *_chg in percent; dominance in percent
- Yöntem
- chg = (cur - prev) / prev * 100 (null unless both > 0); long_short = SUM(long_ratio * oi) / SUM(oi) over account-ratio rows; dominance = coin mcap / SUM(mcap of rows refreshed within 24h, outliers removed)
- Zaman damgaları
- Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
- Yanıt biçimi
- json
- Kararlılık
- Kararlı
Canlı durum
KullanılabilirKontrol: 2026-11-13 04:03:41 UTCHTTP 2001 msŞema eşleşiyor
Erişilebilirlik, son 30 gün
409 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
GET
/api/market/home-tickerKullanılabilirParametreler
Parametre yok.
İstek URL'si
https://www.coinboss.com/api/market/home-tickerBir 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.
Bu kategoride daha fazlası
- Küresel türev metrikleri /api/derivatives/global
- Ana sayfa gösterge kartları paketi /api/home/indicator-cards
- Ana sayfa makro kartları /api/home/macro-cards
- Aylık BTC spot hacmi /api/indicators/cm/btc-spot-vol-monthly
- Aylık kripto spot hacmi /api/indicators/cm/crypto-spot-vol-monthly
- Toplam kripto piyasa değeri ve başlıca coinlerin piyasa değeri geçmişi /api/indicators/marketcap
- Türe göre kripto piyasa değeri dağılımı /api/indicators/marketcap-type
- Ana sayfa ticker şeridi toplamları /api/market/home-ticker
- Türev piyasası özeti /api/market/overview
- Günlük sürekli vadeli / spot hacim oranı /api/p3/perp-spot-ratio
- Sürekli vadeli ve spot hacim karşılaştırması /api/p3/perp-spot-volume
- Piyasa geneli hacim zaman serisi /api/p3/volume/history
- Hacim özeti /api/p3/volume/overview
- Toplam stablecoin piyasa değeri geçmişi /api/stablecoins/chart
- Stablecoin listesi /api/stablecoins/list
- BTC dominansı geçmişi /api/volume/btc-dominance-series
- Küresel spot / türev hacim geçmişi /api/volume/global-history