24s Hacim—Açık pozisyon—24s Likidasyon$1.36B24s Long/Short—BTC Hakimiyeti—ETH Hakimiyeti—
Uygulama
Dil ▾
₺ TRY ▾
/api/sd/volume
GETKullanılabilir

Tek coin için vadeli işlem hacmi

Kendi veri katmanı: tek coin için vadeli işlem hacmi

GET/api/sd/volume

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
coinstringZorunlu——Coin sembolü; eksikse 400. Takma ad: `base`. Örnek: BTC

Örnek istek

curl -s "https://www.coinboss.com/api/sd/volume?coin=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.

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.
coinstring—Coin sembolü, büyük harfle (örneğin BTC).
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
futuresobject—Vadeli piyasa bloğu veya değeri.
futures.total_usdnumberUSDBorsalar genelinde 24h vadeli hacim (USD nominal değeri).
futures.n_exchangesnumber—Katkıda bulunan borsa sayısı.
futures.by_exchangearray—Borsa bazında dağılım.
futures.by_exchange[]object—Borsa bazında dağılım.
futures.by_exchange[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
futures.by_exchange[].vol_usdnumberUSDUSD nominal değeri cinsinden hacim.
futures.by_exchange[].legacy_usdnumberUSDHacmin USDT sürekli vadeli ticker kümesinden gelen bölümü.
futures.by_exchange[].sd_usdnumberUSDHâlihazırda dahil edilmiş ek sözleşmelerden (USDC, coin teminatlı, teslimatlı) gelen bölüm.
futures.by_exchange[].share_pctnumber%Toplam içindeki pay.
futures.change_24hobject—24h değişim.
futures.change_24h.pctnumber%Yüzde.
futures.change_24h.curnumber—Güncel değer.
futures.change_24h.prevnumber—Önceki değer (referans).
futures.change_24h.n_matchednumber—Karşılaştırmanın her iki ucunda da bulunan öğeler.
futures.change_24h.n_totalnumber—Şu anda bulunan öğeler.
futures.change_24h.prev_tsnumbermsReferans anlık görüntünün zamanı.
futures.change_24h.basisstring—Vadeli fiyat eksi spot fiyat ya da baz bloğu.
futures.selfdata_contractsobject—Ek sözleşmeler: nelerin hâlihazırda dahil olduğu ve nelerin hâlâ beklemede olduğu.
futures.selfdata_contracts.included_usdnullUSDEk olarak toplanan ve vadeli toplamına zaten dahil edilmiş sözleşmelerin (coin teminatlı, USDC, teslimatlı) 24h hacmi; henüz hiçbiri dahil edilmemişse null.
futures.selfdata_contracts.n_includednumbercountVadeli toplamına dahil edilen, ek olarak toplanan sözleşme sayısı (yaklaşık 24 saat öncesine ait kendi anlık görüntüsü olanlar).
futures.selfdata_contracts.pending_usdnumber|nullUSDBeklemedeki öğelerin toplamı; toplama dahil değildir.
futures.selfdata_contracts.n_pendingnumbercount24 saat öncesine ait kendi referansları bulunmadığı için henüz dahil edilmeyen, ek olarak toplanan sözleşme sayısı; en büyükleri `pending` içinde listelenir.
futures.selfdata_contracts.pendingarray—Toplanan ama henüz dahil edilmeyen öğeler.
futures.selfdata_contracts.pending[]object—Toplanan ama henüz dahil edilmeyen öğeler.
futures.selfdata_contracts.pending[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
futures.selfdata_contracts.pending[].symbolstring—CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT).
futures.selfdata_contracts.pending[].marginstring—Teminat para birimi sınıfı.
futures.selfdata_contracts.pending[].contract_typestring—`perpetual` veya `delivery`.
futures.selfdata_contracts.pending[].vol_usdnumberUSDUSD nominal değeri cinsinden hacim.
futures.selfdata_contracts.pending[].reasonstring—Neden kodu.
spotobject—Spot piyasa bloğu veya değeri.
spot.total_usdnumberUSDBorsalar genelinde 24h spot hacim.
spot.n_exchangesnumber—Katkıda bulunan borsa sayısı.
spot.asofnumbermsKullanılan en yeni verinin zamanı.
spot.by_exchangearray—Borsa bazında dağılım.
spot.by_exchange[]object—Borsa bazında dağılım.
spot.by_exchange[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
spot.by_exchange[].vol_usdnumberUSDUSD nominal değeri cinsinden hacim.
spot.by_exchange[].quotestring—Bu borsa için dahil edilen kotasyon para birimleri.
spot.by_exchange[].tsnumbermsZaman damgası.
spot.by_exchange[].pricenumber—Kotasyon para birimi cinsinden son fiyat (aksi belirtilmedikçe USD veya USDT).
spot.by_exchange[].age_snumbersBu satırın son güncellenmesinden bu yana geçen saniye.
spot.by_exchange[].share_pctnumber%Toplam içindeki pay.
spot.change_24hobject—24h değişim.
spot.change_24h.pctnumber%Yüzde.
spot.change_24h.curnumber—Güncel değer.
spot.change_24h.prevnumber—Önceki değer (referans).
spot.change_24h.n_matchednumber—Karşılaştırmanın her iki ucunda da bulunan öğeler.
spot.change_24h.n_totalnumber—Şu anda bulunan öğeler.
spot.change_24h.prev_tsnumbermsReferans anlık görüntünün zamanı.
spot.change_24h.basisstring—Vadeli fiyat eksi spot fiyat ya da baz bloğu.
ratiosobject—Hacim oranları: `futures_to_spot` (24h vadeli hacim ÷ 24h spot hacim) ve `oi_to_futures_volume`; girdilerden biri eksikse ilgili oran null olur.
ratios.futures_to_spotnumber—Vadeli hacmin spot hacme bölümü.
ratios.oi_to_futures_volumenumber—Açık pozisyonun 24h vadeli hacme bölümü.
methodobject—Bu yanıtta kullanılan formüllerin düz metin açıklaması.
method.futuresstring—Vadeli piyasa bloğu veya değeri.
method.spotstring—Spot piyasa bloğu veya değeri.
method.changestring—Belirtilen dönemdeki değişim.
method.oi_to_futures_volumestring—`ratios.oi_to_futures_volume` değerinin düz metin tanımı: USD cinsinden toplam açık pozisyon ÷ USD cinsinden 24h vadeli hacim.

Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 4 gerçek yanıt.

Örnek yanıt

/api/sd/volume?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 01:42:33 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: spot.by_exchange: 14 öğe içeriyordu; futures.by_exchange: 23 öğe içeriyordu; futures.selfdata_contracts.pending: 6 öğe içeriyordu.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794534153174,
    • "futures": {
      • "total_usd": 62289204744.73,
      • "n_exchanges": 23,
      • "by_exchange": [ … 2 ],
      • "change_24h": { … 7 },
      • "selfdata_contracts": { … 5 }
      },
    • "spot": {
      • "total_usd": 6451059841.45,
      • "n_exchanges": 14,
      • "asof": 1794534000000,
      • "by_exchange": [ … 2 ],
      • "change_24h": { … 7 }
      },
    • "ratios": {
      • "futures_to_spot": 9.6557,
      • "oi_to_futures_volume": 0.8113
      },
    • "method": {
      • "futures": "SUM of each exchange 24h quote turnover in USD for this coin's contracts (ticker fresh within 1h); self-collected coin-margined/USDC/delivery contracts are adde…",
      • "spot": "per exchange: 24h quote turnover summed over that exchange's USD/USDT/USDC-quoted spot pairs of the coin (quote = the largest pair); total = SUM over exchanges …",
      • "change": "same-exchange pairing: only exchanges with both a current value and a snapshot ~24h ago enter numerator and denominator",
      • "oi_to_futures_volume": "total open interest (USD) / 24h futures turnover (USD)"
      }
    }

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ç
coin=ETH20041 msBaşarılı
coin=SOL20054 msBaşarılı
coin=ARKM20034 msBaşarılı
—4001 msBaşarılı beklenen hatayı döndürür

Kontrol: 2026-11-13 01:27:36 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
30s
Edge mikro önbelleği
10s
Güncelleme sıklığı
vadeli ticker'lar 60 s'de bir (coin teminatlı / USDC / teslimatlı vadeli sözleşmeler 120 s'de bir); spot anlık görüntüler 10 dakikada bir
Pencere
her borsanın bildirdiği kayan 24 saatlik hacim; 24 saatlik değişim, yaklaşık 24 saat önceki kendi arşiviyle karşılaştırılır
Veri kaynakları
24h vadeli hacim kurum içi ticker toplayıcılarından (24 türev borsası), 24h spot hacim ise kurum içi spot ticker toplayıcılarından (14 spot borsası, ör. binance, okx, bybit, coinbase, kraken, upbit) gelir.
Borsa kapsamı
vadeli: en çok 24 borsa; spot: 14 borsa, USD / USDT / USDC kotasyonlu çiftler
Birimler
volumes in USD; changes in percent; ratios dimensionless
Yöntem
futures total = SUM(volume_usd) of tickers fresh within 1 h, plus non-USDT-perp contracts once they have their own ~24 h baseline; spot total = SUM of the latest per-exchange snapshot within 30 min; 24 h change by same-exchange pairing; ratios futures_to_spot and oi_to_futures_volume
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

KullanılabilirKontrol: 2026-11-13 01:42:33 UTCHTTP 20043 msŞema eşleşiyorEn yeni veri noktası 3m öncesine ait

Erişilebilirlik, son 30 gün

384 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/volumeKullanılabilir
Parametreler

string — Coin symbol; 400 when missing. Alias: `base`.

İstek URL'sihttps://www.coinboss.com/api/sd/volume?coin=BTC
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.