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

Vadeli işlem bazı (tüm borsalar)

Sözleşme bazında sürekli vadeli bazı (işaret fiyatı ile endeks fiyatı arasında), aynı borsadaki sürekli vadeli–spot bazı ve yıllıklandırılmış oranıyla teslimatlı vadeli bazı; ayrıca OI ağırlıklı, hacim ağırlıklı ve medyan toplu değerler.

GET/api/sd/basis
Aksamalı. Uç nokta veri kalitesini STALE olarak bildiriyor

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
coinstringZorunlu——Coin sembolü, büyük/küçük harfe duyarsız (örneğin `BTC`). Eksik veya hatalı biçimli değerler 400 döndürür. Örnek: BTC

Örnek istek

curl -s "https://www.coinboss.com/api/sd/basis?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.
schemastring—Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir.
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
coinstring—Coin sembolü (büyük harf).
perpobject—Sürekli vadeli bazı: işaret fiyatının aynı borsanın endeks fiyatına göre farkı.
perp.unitstring—Baz değerlerinin birimi (yüzde).
perp.aggregateobject—Bölümün borsalar arası toplu değeri.
perp.aggregate.oi_weighted_pctnumber%Açık pozisyonla ağırlıklandırılmış baz; OI ağırlığı olmayan satırlar dışarıda bırakılır.
perp.aggregate.oi_weight_usdnumberUSDKullanılan açık pozisyon ağırlıklarının toplamı.
perp.aggregate.n_oi_weightednumber—OI ağırlığı taşıyan satırlar.
perp.aggregate.vol_weighted_pctnumber%24h nominal hacimle ağırlıklandırılmış baz.
perp.aggregate.vol_weight_usdnumberUSDKullanılan hacim ağırlıklarının toplamı.
perp.aggregate.n_vol_weightednumber—Hacim ağırlığı taşıyan satırlar.
perp.aggregate.median_pctnumber%Borsa başına bir ana sözleşme üzerinden medyan baz.
perp.aggregate.mean_pctnumber%Medyanla aynı küme üzerinden basit ortalama.
perp.aggregate.n_exchangesnumber—Toplu değerdeki borsalar.
perp.aggregate.n_contractsnumber—Toplu değerdeki sözleşmeler.
perp.aggregate.minobject—Bazı en düşük olan borsa ve sözleşme.
perp.aggregate.min.exchangestring—Borsa kimliği (küçük harf).
perp.aggregate.min.symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
perp.aggregate.min.basis_pctnumber%Sürekli vadeli ve teslimatlı sözleşmeler için (mark − index) ÷ index × 100; sıralamalarda borsalar arası medyan.
perp.aggregate.maxobject—Bazı en yüksek olan borsa ve sözleşme.
perp.aggregate.max.exchangestring—Borsa kimliği (küçük harf).
perp.aggregate.max.symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
perp.aggregate.max.basis_pctnumber%Sürekli vadeli ve teslimatlı sözleşmeler için (mark − index) ÷ index × 100; sıralamalarda borsalar arası medyan.
perp.aggregate.median_last_pctnumber%Son fiyat bazının medyanı.
perp.aggregate.n_exchanges_lastnumber—Son fiyat medyanındaki borsalar.
perp.aggregate.weightsobject—Ağırlıkların nereden geldiği, güncellik pencereleri ve en eski ağırlığın yaşı.
perp.aggregate.weights.oiobject—Açık pozisyon.
perp.aggregate.weights.oi.sourcestring—Verinin toplandığı herkese açık kaynak uç noktaları.
perp.aggregate.weights.oi.fresh_window_snumbersBundan daha eski bir ağırlık kullanılmaz.
perp.aggregate.weights.oi.oldest_age_snumbersKullanılan en eski ağırlığın yaşı.
perp.aggregate.weights.oi.sidestring—Açık pozisyon ağırlığının tek taraflı olup olmadığı.
perp.aggregate.weights.volobject—Hacim.
perp.aggregate.weights.vol.sourcestring—Verinin toplandığı herkese açık kaynak uç noktaları.
perp.aggregate.weights.vol.fresh_window_snumbersBundan daha eski bir ağırlık kullanılmaz.
perp.aggregate.weights.vol.oldest_age_snumbersKullanılan en eski ağırlığın yaşı.
perp.contractsarray—Sözleşme başına bir satır.
perp.contracts[]object—Sözleşme başına bir satır.
perp.contracts[].exchangestring—Borsa kimliği (küçük harf).
perp.contracts[].symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
perp.contracts[].native_symbolstring—Borsanın yazdığı biçimiyle sözleşme sembolü.
perp.contracts[].quotestring—Sözleşmenin kotasyon para birimi.
perp.contracts[].margin_typestring—Sözleşmenin teminat türü (örneğin USDT teminatlı, coin teminatlı).
perp.contracts[].multipliernumber—Kote edilen birim başına coin sayısı (`1000PEPE` tarzı sözleşmeler için 1000). Baz bundan etkilenmez.
perp.contracts[].mark_pricenumber|null—Borsanın yayımladığı işaret fiyatı.
perp.contracts[].index_pricenumber|null—Borsanın yayımladığı endeks fiyatı.
perp.contracts[].last_pricenumber|null—Son işlem fiyatı.
perp.contracts[].index_kindstring|null—Endeksin ne olduğu: `exchange_index`, `oracle` veya gösterilen ama toplu değere katılmayan başka bir tür.
perp.contracts[].basis_pctnumber|null%Sürekli vadeli ve teslimatlı sözleşmeler için (mark − index) ÷ index × 100; sıralamalarda borsalar arası medyan.
perp.contracts[].basis_absnumber|null—mark − index, kotasyon para birimi cinsinden.
perp.contracts[].basis_last_pctnumber|null%(last − index) ÷ index × 100; yakın zamanda işlem yoksa `null`.
perp.contracts[].basis_last_reasonstring|null—`basis_last_pct` değerinin neden null olduğu.
perp.contracts[].index_lag_snumber|nullsSatırın işaret fiyatı zaman damgası ile endeks fiyatı zaman damgası arasındaki saniye.
perp.contracts[].oi_usdnumber|nullUSDSözleşmenin tek taraflı açık pozisyonu; ağırlık olarak kullanılır.
perp.contracts[].vol_usd_24hnumber|nullUSDSözleşmenin 24h nominal hacmi; ağırlık olarak kullanılır.
perp.contracts[].primaryboolean—Medyan ve ortalamada borsasını temsil eden sözleşme için true.
perp.contracts[].in_aggregateboolean—Satır dahil etme kurallarını geçtiyse true.
perp.contracts[].excluded_reasonstring|null—Satırın neden toplu değerde yer almadığı.
perp.contracts[].last_tsnumber|nullmsSon işlemin zamanı.
perp.contracts[].observed_atnumber|nullmsKaynağın veri için verdiği zaman damgası.
perp.contracts[].received_atnumbermsCoinBoss toplayıcısının veriyi aldığı zaman.
perp.contracts[].age_snumbersSatırın alınmasından bu yana geçen saniye.
spot_perpobject—Sürekli vadeli fiyatının aynı borsanın spot fiyatına göre farkı.
spot_perp.unitstring—Baz değerlerinin birimi (yüzde).
spot_perp.aggregateobject—Bölümün borsalar arası toplu değeri.
spot_perp.aggregate.oi_weighted_pctnumber%Açık pozisyonla ağırlıklandırılmış baz; OI ağırlığı olmayan satırlar dışarıda bırakılır.
spot_perp.aggregate.oi_weight_usdnumberUSDKullanılan açık pozisyon ağırlıklarının toplamı.
spot_perp.aggregate.n_oi_weightednumber—OI ağırlığı taşıyan satırlar.
spot_perp.aggregate.vol_weighted_pctnumber%24h nominal hacimle ağırlıklandırılmış baz.
spot_perp.aggregate.vol_weight_usdnumberUSDKullanılan hacim ağırlıklarının toplamı.
spot_perp.aggregate.n_vol_weightednumber—Hacim ağırlığı taşıyan satırlar.
spot_perp.aggregate.median_pctnumber%Borsa başına bir ana sözleşme üzerinden medyan baz.
spot_perp.aggregate.mean_pctnumber%Medyanla aynı küme üzerinden basit ortalama.
spot_perp.aggregate.n_exchangesnumber—Toplu değerdeki borsalar.
spot_perp.aggregate.n_contractsnumber—Toplu değerdeki sözleşmeler.
spot_perp.aggregate.minobject—Bazı en düşük olan borsa ve sözleşme.
spot_perp.aggregate.min.exchangestring—Borsa kimliği (küçük harf).
spot_perp.aggregate.min.symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
spot_perp.aggregate.min.basis_pctnumber%Sürekli vadeli ve teslimatlı sözleşmeler için (mark − index) ÷ index × 100; sıralamalarda borsalar arası medyan.
spot_perp.aggregate.maxobject—Bazı en yüksek olan borsa ve sözleşme.
spot_perp.aggregate.max.exchangestring—Borsa kimliği (küçük harf).
spot_perp.aggregate.max.symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
spot_perp.aggregate.max.basis_pctnumber%Sürekli vadeli ve teslimatlı sözleşmeler için (mark − index) ÷ index × 100; sıralamalarda borsalar arası medyan.
spot_perp.pairsarray—Aynı borsanın her sürekli vadeli / spot çifti için bir satır.
spot_perp.pairs[]object—Aynı borsanın her sürekli vadeli / spot çifti için bir satır.
spot_perp.pairs[].exchangestring—Borsa kimliği (küçük harf).
spot_perp.pairs[].symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
spot_perp.pairs[].spot_symbolstring—Spot bacağı olarak kullanılan spot piyasa.
spot_perp.pairs[].quotestring—Sözleşmenin kotasyon para birimi.
spot_perp.pairs[].spot_multnumber—Her iki bacak da aynı miktarı kote etsin diye spot fiyata uygulanan çarpan.
spot_perp.pairs[].futures_pricenumber|null—Kullanılan sürekli vadeli fiyatı; bkz. `price_kind`.
spot_perp.pairs[].price_kindstring|null—Hangi sürekli vadeli fiyatının kullanıldığı: `last` veya `mark`.
spot_perp.pairs[].spot_pricenumber—`spot_mult` uygulandıktan sonraki spot son fiyat.
spot_perp.pairs[].basis_pctnumber|null%Sürekli vadeli ve teslimatlı sözleşmeler için (mark − index) ÷ index × 100; sıralamalarda borsalar arası medyan.
spot_perp.pairs[].basis_last_pctnumber|null%(last − index) ÷ index × 100; yakın zamanda işlem yoksa `null`.
spot_perp.pairs[].basis_mark_pctnumber|null%(mark − spot) ÷ spot × 100.
spot_perp.pairs[].leg_gap_snumbersİki bacağın zaman damgaları arasındaki saniye.
spot_perp.pairs[].spot_time_kindstring—Spot zaman damgasının ne olduğu (işlem zamanı veya alım zamanı).
spot_perp.pairs[].spot_vol_24hnumber|null—Spot piyasanın kendi kotasyon para birimi cinsinden 24h işlem hacmi.
spot_perp.pairs[].oi_usdnumber|nullUSDSözleşmenin tek taraflı açık pozisyonu; ağırlık olarak kullanılır.
spot_perp.pairs[].vol_usd_24hnumber|nullUSDSözleşmenin 24h nominal hacmi; ağırlık olarak kullanılır.
spot_perp.pairs[].primaryboolean—Medyan ve ortalamada borsasını temsil eden sözleşme için true.
spot_perp.pairs[].in_aggregateboolean—Satır dahil etme kurallarını geçtiyse true.
spot_perp.pairs[].excluded_reasonstring|null—Satırın neden toplu değerde yer almadığı.
spot_perp.pairs[].received_atnumbermsCoinBoss toplayıcısının veriyi aldığı zaman.
spot_perp.pairs[].spot_received_atnumbermsSpot bacağının alındığı zaman.
deliveryobject—Teslimatlı (belirli vadeli) vadeli sözleşme bazı.
delivery.unitstring—Baz değerlerinin birimi (yüzde).
delivery.contractsarray—Sözleşme başına bir satır.
delivery.contracts[]object—Sözleşme başına bir satır.
delivery.contracts[].exchangestring—Borsa kimliği (küçük harf).
delivery.contracts[].symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
delivery.contracts[].native_symbolstring—Borsanın yazdığı biçimiyle sözleşme sembolü.
delivery.contracts[].quotestring—Sözleşmenin kotasyon para birimi.
delivery.contracts[].margin_typestring—Sözleşmenin teminat türü (örneğin USDT teminatlı, coin teminatlı).
delivery.contracts[].expiry_tsnumbermsTeslimatlı vadeli sözleşmenin vade sonu zamanı.
delivery.contracts[].days_to_expirynumberdaysVade sonuna kalan gün sayısı.
delivery.contracts[].mark_pricenumber—Borsanın yayımladığı işaret fiyatı.
delivery.contracts[].last_pricenumber|null—Son işlem fiyatı.
delivery.contracts[].index_pricenumber—Borsanın yayımladığı endeks fiyatı.
delivery.contracts[].index_kindstring—Endeksin ne olduğu: `exchange_index`, `oracle` veya gösterilen ama toplu değere katılmayan başka bir tür.
delivery.contracts[].basis_pctnumber%Sürekli vadeli ve teslimatlı sözleşmeler için (mark − index) ÷ index × 100; sıralamalarda borsalar arası medyan.
delivery.contracts[].annualized_pctnumber|null% per yearbasis_pct × 365 ÷ vade sonuna kalan gün, basit faiz; son gün içinde `null`.
delivery.contracts[].basis_reasonnull—`basis_pct` değerinin neden null olduğu.
delivery.contracts[].index_lag_snumbersSatırın işaret fiyatı zaman damgası ile endeks fiyatı zaman damgası arasındaki saniye.
delivery.contracts[].basis_last_pctnumber|null%(last − index) ÷ index × 100; yakın zamanda işlem yoksa `null`.
delivery.contracts[].annualized_last_pctnumber|null% per yearSon işlem fiyatı kullanılarak yıllıklandırılmış baz.
delivery.contracts[].spot_symbolstring|null—Spot bacağı olarak kullanılan spot piyasa.
delivery.contracts[].spot_pricenumber|null—`spot_mult` uygulandıktan sonraki spot son fiyat.
delivery.contracts[].spot_price_kindstring|null—Spot ile hangi vadeli fiyatın karşılaştırıldığı.
delivery.contracts[].basis_spot_pctnumber|null%(futures − aynı borsanın spot fiyatı) ÷ spot × 100.
delivery.contracts[].annualized_spot_pctnumber|null% per yearAynı borsanın spot fiyatına göre yıllıklandırılmış baz.
delivery.contracts[].annualized_reasonstring|null—Yıllıklandırılmış değerin neden null olduğu (örneğin `expiry_lt_1d`).
delivery.contracts[].oi_usdnumber|nullUSDSözleşmenin tek taraflı açık pozisyonu; ağırlık olarak kullanılır.
delivery.contracts[].vol_usd_24hnumber|nullUSDSözleşmenin 24h nominal hacmi; ağırlık olarak kullanılır.
delivery.contracts[].last_tsnumber|nullmsSon işlemin zamanı.
delivery.contracts[].observed_atnumber|nullmsKaynağın veri için verdiği zaman damgası.
delivery.contracts[].received_atnumbermsCoinBoss toplayıcısının veriyi aldığı zaman.
delivery.contracts[].age_snumbersSatırın alınmasından bu yana geçen saniye.
coverageobject—Sayılara nelerin dahil olduğu ve nelerin olmadığı. Toplamları başka bir kaynakla karşılaştırmadan önce bunu karşılaştırın.
coverage.included_exchangesarray—Güncel verisi dahil edilen kaynaklar.
coverage.included_exchanges[]string—Güncel verisi dahil edilen kaynaklar.
coverage.unavailablearray—Dahil edilemeyen kaynaklar; her biri nedeniyle birlikte. Hiçbir zaman 0 olarak sayılmazlar.
coverage.unavailable[]object—Dahil edilemeyen kaynaklar; her biri nedeniyle birlikte. Hiçbir zaman 0 olarak sayılmazlar.
coverage.unavailable[].exchangestring—Borsa kimliği (küçük harf).
coverage.unavailable[].reasonstring—Makine tarafından okunabilir neden kodu.
coverage.unavailable[].detailstring—Nedenin insan tarafından okunabilir açıklaması.
coverage.stale_excludedarray—Son güncellemesi güncellik penceresinin dışında kaldığı için hariç bırakılan satırlar. bu tabloyu üretmek için kullanılan örneklerde boş
coverage.missing_fieldsarray—Fiyatlardan birini yayımlamayan borsalar.
coverage.excluded_from_aggregatearray—Gösterilen ama toplu değerin dışında bırakılan satırlar; her biri nedeniyle birlikte.
coverage.excluded_from_aggregate[]object—Gösterilen ama toplu değerin dışında bırakılan satırlar; her biri nedeniyle birlikte.
coverage.excluded_from_aggregate[].exchangestring—Borsa kimliği (küçük harf).
coverage.excluded_from_aggregate[].symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
coverage.excluded_from_aggregate[].sectionstring—Satırın ait olduğu bölüm.
coverage.excluded_from_aggregate[].reasonstring—Makine tarafından okunabilir neden kodu.
coverage.stock_excludedarray—Aynı ticker'ı paylaşan ve çıkarılan hisse sürekli vadeli sözleşmeleri. bu tabloyu üretmek için kullanılan örneklerde boş
coverage.dropped_delisted_rowsnumber—Sözleşme güncellenmeyi bıraktığı için atılan satırlar.
coverage.delivery_unavailablearray—Teslimatlı vadeli sözleşmeleri toplanmayan borsalar.
coverage.delivery_unavailable[]object—Teslimatlı vadeli sözleşmeleri toplanmayan borsalar.
coverage.delivery_unavailable[].exchangestring—Borsa kimliği (küçük harf).
coverage.delivery_unavailable[].reasonstring—Makine tarafından okunabilir neden kodu.
coverage.delivery_unavailable[].detailstring—Nedenin insan tarafından okunabilir açıklaması.
methodobject—Bu yanıtta kullanılan formüllerin düz metin açıklaması; alan başına bir girdi.
method.perp.basis_pctstring—`perp.basis_pct` için formül notu, düz metin.
method.perp.basis_last_pctstring—`perp.basis_last_pct` için formül notu, düz metin.
method.perp.aggregate.oi_weighted_pctstring—`perp.aggregate.oi_weighted_pct` için formül notu, düz metin.
method.perp.aggregate.vol_weighted_pctstring—`perp.aggregate.vol_weighted_pct` için formül notu, düz metin.
method.perp.aggregate.median_pctstring—`perp.aggregate.median_pct` için formül notu, düz metin.
method.perp.aggregate.inclusionstring—`perp.aggregate.inclusion` için formül notu, düz metin.
method.spot_perp.basis_pctstring—`spot_perp.basis_pct` için formül notu, düz metin.
method.spot_perp.aggregate.inclusionstring—`spot_perp.aggregate.inclusion` için formül notu, düz metin.
method.delivery.basis_pctstring—`delivery.basis_pct` için formül notu, düz metin.
method.delivery.annualized_pctstring—`delivery.annualized_pct` için formül notu, düz metin.
method.index_lag_sstring—`index_lag_s` için formül notu, düz metin.
method.multiplierstring—`multiplier` için formül notu, düz metin.
metaobject—Bu yanıtın veri kökeni ve güncelliği.
meta.schemastring—Bu yanıtın şema kimliği. Yalnızca mevcut bir alanın anlamı veya türü değiştiğinde değişir.
meta.sourcearray—Verinin toplandığı herkese açık kaynak uç noktaları.
meta.source[]object—Verinin toplandığı herkese açık kaynak uç noktaları.
meta.source[].exchangestring—Borsa kimliği (küçük harf).
meta.source[].endpointstring—Toplayıcının okuduğu kaynağın herkese açık uç noktası (veri kökeni için gösterilir; istemciler bunu hiçbir zaman çağırmaz).
meta.observed_atnumbermsKaynağın veri için verdiği zaman damgası.
meta.received_atnumbermsCoinBoss toplayıcısının veriyi aldığı zaman.
meta.fetched_atnumbermsBu yanıtın oluşturulduğu zaman.
meta.windowstring—Sayıların kapsadığı zaman penceresi.
meta.qualitystring—Veri zaman damgalarına ve kapsama göre değerlendirilen FRESH, PARTIAL, STALE, BROKEN veya UNAVAILABLE.
meta.is_staleboolean—Veri güncellik penceresinden eskiyse true.
meta.cache_ttl_snumbersBu yanıtın önbellek ömrü.
meta.fallbackstring—Toplayıcı veya bir kaynak başarısız olduğunda uç noktanın ne döndürdüğü.
meta.collector_heartbeat_age_snumbersToplayıcının çalıştığını en son bildirmesinden bu yana geçen saniye.
coverage.missing_fields[]object—Fiyatlardan birini yayımlamayan borsalar.
coverage.missing_fields[].exchangestring—Borsa kimliği (küçük harf).
coverage.missing_fields[].symbolstring—CoinBoss'un depolama biçimindeki sözleşme sembolü.
coverage.missing_fields[].missingstring—Borsanın yayımlamadığı fiyat (`mark` veya `index`).

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

Örnek yanıt

/api/sd/basis?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:52:48 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: meta.source: 20 öğe içeriyordu; perp.contracts: 37 öğe içeriyordu; spot_perp.pairs: 22 öğe içeriyordu; delivery.contracts: 53 öğe içeriyordu; coverage.unavailable: 4 öğe içeriyordu; coverage.included_exchanges: 20 öğe içeriyordu.

  • {
    • "success": true,
    • "schema": "coinboss.sd.basis/1",
    • "now": 1794541956692,
    • "coin": "BTC",
    • "perp": {
      • "unit": "percent",
      • "aggregate": { … 15 },
      • "contracts": [ … 1 ]
      },
    • "spot_perp": {
      • "unit": "percent",
      • "aggregate": { … 12 },
      • "pairs": [ … 1 ]
      },
    • "delivery": {
      • "unit": "percent",
      • "contracts": [ … 1 ]
      },
    • "coverage": {
      • "included_exchanges": [ … 8 ],
      • "unavailable": [ … 1 ],
      • "stale_excluded": [],
      • "missing_fields": [],
      • "excluded_from_aggregate": [ … 1 ],
      • "stock_excluded": [],
      • "dropped_delisted_rows": 0,
      • "delivery_unavailable": [ … 1 ]
      },
    • "method": {
      • "perp.basis_pct": "(mark_price - index_price) / index_price * 100, percent; mark and index are both published by the same exchange for that…",
      • "perp.basis_last_pct": "(last_price - index_price) / index_price * 100; null when the exchange gives no last-trade price or the last trade is mo…",
      • "perp.aggregate.oi_weighted_pct": "sum(basis_pct * oi_usd) / sum(oi_usd) over all included perpetual contracts that have an open-interest weight; oi_usd fr…",
      • "perp.aggregate.vol_weighted_pct": "same with 24h notional volume (market_tickers.volume_usd / sd_contract_latest.vol_usd_24h, <= 1 h old) as weight",
      • "perp.aggregate.median_pct": "median of basis_pct over one primary contract per exchange (largest OI, then volume, then USDT-margined); mean_pct is th…",
      • "perp.aggregate.inclusion": "row is fresh (<= 180 s), basis_pct is not null, index_kind is exchange_index or oracle, the contract traded within 24 h …",
      • "spot_perp.basis_pct": "(perp last_price, or mark_price when last is unusable - spot last price * spot_mult) / (spot last price * spot_mult) * 1…",
      • "spot_perp.aggregate.inclusion": "as perp, plus spot 24h turnover >= 10000 (quote currency) when the exchange reports it",
      • "delivery.basis_pct": "(F - S) / S * 100 with F = mark_price and S = the exchange index price of the underlying; basis_last_pct uses F = last_p…",
      • "delivery.annualized_pct": "basis_pct * 365 / days_to_expiry, simple (not compounded); null when days_to_expiry < 1; days_to_expiry = (expiry_ts - p…",
      • "index_lag_s": "seconds between the mark timestamp and the index timestamp of the row; 0 when the exchange returns both in one response;…",
      • "multiplier": "contract units per coin (1000PEPE, kPEPE = 1000); mark and index carry the same multiplier so basis_pct is unaffected; s…"
      },
    • "meta": {
      • "schema": "coinboss.sd.basis/1",
      • "source": [ … 1 ],
      • "observed_at": 1794539247345,
      • "received_at": 1794539247425,
      • "fetched_at": 1794541956692,
      • "window": "latest",
      • "quality": "STALE",
      • "is_stale": true,
      • "cache_ttl_s": 20,
      • "fallback": "rows older than 180 s are excluded; if no exchange is fresh the last stored rows (<= 1 h old) are served with is_stale=t…",
      • "collector_heartbeat_age_s": 2759
      }
    }

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=ETH20028 msBaşarılı STALE
coin=SOL20026 msBaşarılı STALE
coin=PEPE20026 msBaşarılı STALE
—4002 msBaşarılı beklenen hatayı döndürür

Kontrol: 2026-11-13 03:28:06 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
20s
Edge mikro önbelleği
10s
Güncelleme sıklığı
Toplayıcı turu 60 saniyede bir; bir satır 180 saniye boyunca güncel sayılır. Geçmiş, saatlik anlık görüntülerden beslenir.
Pencere
Sözleşme başına en güncel değer.
Veri kaynakları
21 türev borsasının yayımladığı işaret fiyatı, endeks fiyatı ve son fiyat ile aynı borsanın spot fiyatı; CoinBoss tarafından toplanır ve saklanır (sd_px_latest, sd_px_hourly).
Borsa kapsamı
21 borsa. Endeks fiyatı veya işaret fiyatı yayımlamayan borsalar `coverage.unavailable` altında listelenir; iki fiyat bacağı arasında 60 saniyeden fazla fark olan satırlar `null` döndürür. Toplu değerin dışında bırakılan satırlar, nedeniyle birlikte `coverage.excluded_from_aggregate` altında listelenir.
Sayfalama
Sayfalama yok.
Sıralama
Açık pozisyonu en büyük olan sözleşmeler önce.
Birimler
All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
Yöntem
Perpetual: basis_pct = (mark − index) ÷ index × 100. Spot-perp: (perpetual price − spot price) ÷ spot price × 100, same exchange and quote currency. Delivery: basis_pct = (futures − index) ÷ index × 100; annualized_pct = basis_pct × 365 ÷ days to expiry (simple interest; `null` inside the last day). Aggregates use one primary contract per exchange; a row enters only if it is fresh, traded within 24 hours and |basis| ≤ 10 %.
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

AksamalıKontrol: 2026-11-13 03:52:48 UTCHTTP 2001 msŞema eşleşiyorEn yeni veri noktası 45m öncesine ait

Uç nokta veri kalitesini STALE olarak bildiriyor

Erişilebilirlik, son 30 gün

406 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/basisAksamalı
Parametreler

string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.

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