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

Tek coin için açık pozisyon

Kendi veri katmanı: tek coin için açık pozisyon (borsa / sözleşme bazında, kalite bayraklarıyla)

GET/api/sd/oi

İ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/oi?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ı.
total_usdnumberUSDDahil edilen tüm borsa ve sözleşmelerdeki açık pozisyon; her borsanın bildirdiği biçimiyle (USD nominal değeri).
n_exchangesnumber—Toplamdaki borsa sayısı.
n_contractsnumber—Toplamdaki sözleşme sayısı.
asofnumbermsDahil edilen satırlar arasındaki en yeni güncelleme zamanı.
total_usd_single_adjustednumberUSDHer iki tarafı bildiren borsaların (`double_sided.exchanges`) rakamları yarıya indirilmiş `total_usd` değeri; böylece her borsa tek taraf olarak sayılır.
double_sidedobject—Long + short açık pozisyonu tek bir sayı olarak yayımladığı bilinen borsalar.
double_sided.exchangesarray—Borsalar.
double_sided.exchanges[]string—Borsalar.
double_sided.oi_usdnumberUSDBu borsaların yarıya indirilmeden önceki, bildirilen açık pozisyonu.
by_kindobject—Doğrusal / ters dağılımı.
by_kind.linear_usdnumberUSDDoğrusal sözleşmelerin (teminatı ve uzlaşması stablecoin veya USD cinsinden olan) açık pozisyonu.
by_kind.inverse_usdnumberUSDTers (coin teminatlı) sözleşmelerin, sözleşme fiyatından USD'ye çevrilmiş açık pozisyonu.
by_marginobject—Teminat para birimine göre dağılım.
by_margin.othernumberUSDDiğer teminat para birimleri (örneğin CME gibi USD ile uzlaşan borsalar).
by_margin.usdtnumberUSDUSDT teminatlı sözleşmeler.
by_margin.usdcnumberUSDUSDC teminatlı sözleşmeler. bulunmayabilir
by_margin.coinnumberUSDCoin teminatlı sözleşmeler. bulunmayabilir
by_contract_typeobject—Sürekli vadeli / teslimatlı dağılımı.
by_contract_type.perpetual_usdnumberUSDSürekli vadeli sözleşmeler.
by_contract_type.delivery_usdnumberUSDBelirli vadeli sözleşmeler (teslimatlı vadeli sözleşmeler).
changeobject—Açık pozisyonun 1h / 4h / 24h içindeki değişimi; her iki uçta da aynı sözleşme kümesi üzerinden hesaplanır. dinamik anahtarlar: h1,h4,h24
change.{*}object—Belirtilen dönemdeki değişim.
change.{*}.pctnumber%`prev` ile `cur` arasındaki yüzde değişim.
change.{*}.curnumberUSDEşleşen sözleşmelerin güncel toplamı.
change.{*}.prevnumberUSDAynı sözleşmelerin `prev_ts` anındaki toplamı.
change.{*}.n_matchednumber—Her iki uçta da bulunan sözleşmeler (veya borsalar).
change.{*}.n_totalnumber—Şu anda bulunan sözleşmeler (veya borsalar).
change.{*}.matched_share_pctnumber%Eşleşen kümenin güncel açık pozisyonda kapsadığı pay. bulunmayabilir
change.{*}.prev_tsnumbermsReferans anlık görüntünün zamanı.
change.{*}.span_minnumberminReferans ile şimdiki an arasındaki gerçek süre.
change.{*}.basisstring—Referansın hangi anlık görüntü serisinden geldiği.
change.{*}.frozen_excludedobject—İki anlık görüntü arasında değeri değişmediği (kaynak güncellenmediği) için değişim hesabının dışında bırakılan satırlar. bulunmayabilir
change.{*}.frozen_excluded.n_baselinenumber—Referans anlık görüntüdeki öğeler. bulunmayabilir
change.{*}.frozen_excluded.n_currentnumber—Güncel anlık görüntüdeki öğeler. bulunmayabilir
change.{*}.frozen_excluded.cur_usdnumberUSDGüncel değer. bulunmayabilir
change.{*}.frozen_excluded.prev_usdnumberUSDReferans değer. bulunmayabilir
by_exchangearray—Borsa bazında dağılım.
by_exchange[]object—Borsa bazında dağılım.
by_exchange[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
by_exchange[].oi_usdnumberUSDUSD nominal değeri cinsinden açık pozisyon.
by_exchange[].share_pctnumber%Toplam içindeki pay.
by_exchange[].n_contractsnumber—Sözleşme sayısı.
by_exchange[].linear_usdnumberUSDDoğrusal sözleşmeler.
by_exchange[].inverse_usdnumberUSDTers (coin teminatlı) sözleşmeler.
by_exchange[].perpetual_usdnumberUSDSürekli vadeli sözleşmeler.
by_exchange[].delivery_usdnumberUSDTeslimatlı vadeli sözleşmeler.
by_exchange[].oi_sidestring—Borsa her iki tarafı tek bir sayıda bildiriyorsa `double`, tek tarafı bildiriyorsa `single`, borsa bunu belgelemiyorsa `unstated`.
by_exchange[].oi_usd_single_adjustednumber|nullUSDTek taraflı eşdeğer; taraf kuralı belirtilmemişse null.
by_exchange[].updated_atnumbermsBu satırın en son güncellendiği zaman.
by_exchange[].age_snumbersBu satırın son güncellenmesinden bu yana geçen saniye.
by_exchange[].is_staleboolean—Satır güncellik penceresinden eskiyse true; eskimiş satırlar toplamlarda kullanılmaz.
contractsarray—Sözleşme bazında satırlar.
contracts[]object—Sözleşme bazında satırlar.
contracts[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
contracts[].symbolstring—CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT).
contracts[].native_symbolstring|null—Borsanın yazdığı biçimiyle birebir sembol.
contracts[].oi_usdnumberUSDUSD nominal değeri cinsinden açık pozisyon.
contracts[].oi_sidestring—`double`, `single` veya `unstated`: borsanın açık pozisyonun her iki tarafını tek bir sayıda bildirip bildirmediği.
contracts[].oi_usd_singlenumber|nullUSD`oi_usd` değerinin tek taraflı eşdeğeri; taraf kuralı belirtilmemişse null.
contracts[].marginstring—Teminat para birimi sınıfı: `usdt`, `usdc`, `coin` veya `other`.
contracts[].kindstring—`linear` veya `inverse`.
contracts[].contract_typestring—`perpetual` veya `delivery`.
contracts[].expiry_tsnumber|nullmsTeslimatlı vadeli sözleşmenin vade sonu; sürekli vadeli sözleşmelerde veya yayımlanmadığında null.
contracts[].margin_basisstring—Teminat sınıfının nasıl belirlendiği (sözleşme şartnamesinden veya borsanın varsayılanından).
contracts[].updated_atnumbermsBu satırın en son güncellendiği zaman.
contracts[].age_snumbersBu satırın son güncellenmesinden bu yana geçen saniye.
contracts[].is_staleboolean—Satır güncellik penceresinden eskiyse true; eskimiş satırlar toplamlarda kullanılmaz.
contracts[].collectorstring—Satırı üreten dahili toplayıcı.
contracts[].included_sincenumber|nullmsBu sözleşmenin toplamlara girdiği zaman; temel küme için null.
coverageobject—Yukarıdaki 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—Verileri toplamlara dahil edilen borsalar.
coverage.included_exchanges[]string—Toplamlara dahil edilen borsalar.
coverage.pendingarray—Toplanan ama henüz toplamlara dahil edilmeyen sözleşmeler (örneğin kendi 25 saatlik geçmişleri hâlâ oluşurken). Aradaki fark görünür olsun diye güncel değerleriyle listelenir.
coverage.pending[]object—Toplanan ama henüz dahil edilmeyen öğeler.
coverage.pending[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
coverage.pending[].symbolstring—CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT).
coverage.pending[].native_symbolstring—Borsanın yazdığı biçimiyle birebir sembol.
coverage.pending[].marginstring—Teminat para birimi sınıfı.
coverage.pending[].contract_typestring—`perpetual` veya `delivery`.
coverage.pending[].oi_usdnumberUSDUSD nominal değeri cinsinden açık pozisyon.
coverage.pending[].age_snumbersBu satırın son güncellenmesinden bu yana geçen saniye.
coverage.pending[].reasonstring—Neden kodu.
coverage.pending[].detailstring|null—Ayrıntı.
coverage.pending_usdnumber|nullUSDBeklemedeki sözleşmelerin toplamı; `total_usd` değerine dahil değildir.
coverage.stale_excludedarray—Son güncellemesi kullanılabilirlik penceresinin dışında kaldığı için hariç bırakılan satırlar. bu tabloyu üretmek için kullanılan örneklerde boş
coverage.unavailablearray—Dahil edilemeyen borsa / sözleşme çiftleri; her biri nedeniyle birlikte. Hiçbir zaman 0 olarak sayılmazlar.
coverage.unavailable[]object—Verisi bulunmayan öğeler, nedenleriyle birlikte. Hiçbir zaman 0 olarak bildirilmez.
coverage.unavailable[].exchangestring—Borsa kimliği, küçük harfle (örneğin `binance`).
coverage.unavailable[].symbolstring—CoinBoss'un normalize ettiği biçimiyle enstrüman sembolü (örneğin BTCUSDT).
coverage.unavailable[].native_symbolstring—Borsanın yazdığı biçimiyle birebir sembol.
coverage.unavailable[].marginstring—Teminat para birimi sınıfı.
coverage.unavailable[].contract_typestring—`perpetual` veya `delivery`.
coverage.unavailable[].reasonstring—Neden kodu.
coverage.unavailable[].detailstring—Ayrıntı.
methodobject—Bu yanıtta kullanılan formüllerin düz metin açıklaması.
method.totalstring—Toplam.
method.usdstringUSDDeğer.
method.change_h1_h4string—1h ve 4h açık pozisyon değişimlerinin düz metin tanımı: her sözleşme, pencere başlangıcına en yakın kendi anlık görüntüsüyle karşılaştırılır.
method.change_h24string—24h açık pozisyon değişiminin düz metin tanımı: 24 saat öncesine en yakın saatlik anlık görüntüyle aynı borsa içinde eşleştirme; donmuş referanslar hariç tutulur.
method.oi_sidestring—`double`, `single` veya `unstated`: borsanın açık pozisyonun her iki tarafını tek bir sayıda bildirip bildirmediği.

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

Örnek yanıt

/api/sd/oi?coin=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:57:39 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: change: 3 öğe içeriyordu; contracts: 95 öğe içeriyordu; by_exchange: 22 öğe içeriyordu; coverage.included_exchanges: 22 öğe içeriyordu.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542259643,
    • "total_usd": 49005713133.94,
    • "n_exchanges": 22,
    • "n_contracts": 95,
    • "asof": 1794542258000,
    • "total_usd_single_adjusted": 43766392634.71,
    • "double_sided": {
      • "exchanges": [ … 2 ],
      • "oi_usd": 10478640998.46
      },
    • "by_kind": {
      • "linear_usd": 44169662162.94,
      • "inverse_usd": 4836050971
      },
    • "by_margin": {
      • "other": 8250815931.650002,
      • "usdt": 30919742583.03,
      • "usdc": 4999103648.259998,
      • "coin": 4836050971
      },
    • "by_contract_type": {
      • "perpetual_usd": 40820877874.21,
      • "delivery_usd": 8184835259.73
      },
    • "change": {
      • "h1": { … 9 },
      • "h4": { … 9 }
      },
    • "by_exchange": [
      • { … 13 },
      • { … 13 }
      ],
    • "contracts": [
      • { … 16 },
      • { … 16 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 8 ],
      • "pending": [],
      • "pending_usd": null,
      • "stale_excluded": [ … 2 ],
      • "unavailable": [ … 1 ]
      },
    • "method": {
      • "total": "SUM(oi_usd) over fresh contracts (non-CME updated within 3h; CME within 120h)",
      • "usd": "linear: contracts × contract_size × mark/last price; inverse: contracts × contract_face_value_usd (or coin amount × price)",
      • "change_h1_h4": "same-contract pairing vs own snapshot nearest to now−W (15-minute snapshots, hourly fallback)",
      • "change_h24": "same-exchange pairing vs hourly snapshot nearest to now−24h (site-wide convention); contracts whose baseline snapshot is a frozen carry-over (identical to the c…",
      • "oi_side": "as disclosed by each exchange; double = exchange API itself reports open interest as twice the single-sided figure"
      }
    }

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=ETH20024 msBaşarılı
coin=SOL20021 msBaşarılı
coin=ARKM20020 msBaşarılı
—4001 msBaşarılı beklenen hatayı döndürür

Kontrol: 2026-11-13 03:57:39 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ığı
çoğu borsa için 60 s'de bir (ticker'larla birlikte yazılır; binance ilk 50 ve okx için ayrılmış 60 s'lik görevler); binance / bingx / aster / gate / htx tam taramaları 5 dakikada bir; coin teminatlı / USDC / teslimatlı vadeli sözleşmeler 120 s'de bir (5 dakikada bir ortak tabloya aktarılır); cme işlem günü başına bir kez (04:10 UTC); kısa pencereli değişimler için sözleşme düzeyinde 15 dakikalık anlık görüntüler
Pencere
en güncel anlık görüntü (son 3 saat içindeki satırlar, cme için 120 saat; is_stale bayrağı 15 dakikadan sonra, cme için 36 saat); 1 saatlik / 4 saatlik (15 dakikalık anlık görüntüler) ve 24 saatlik (saatlik arşiv) değişimler
Veri kaynakları
Kurum içi toplayıcıların 22 türev borsasının (ör. binance, okx, bybit, gate, bitget, hyperliquid) herkese açık REST API'lerinden sorguladığı açık pozisyon; buna CME'nin resmî günlük hacim/açık pozisyon raporu eklenir.
Borsa kapsamı
güncel satırı olan 23 kaynak (22 borsa + cme); tüm sözleşme türleri (USDT / USDC / USD doğrusal, coin teminatlı ters, sürekli vadeli ve teslimatlı); bybit ve gate, borsanın açıkladığı üzere açık pozisyonu çift taraflı bildirir; 3 saatten (cme: 120 saat) eski satırlar hariç tutulur; coverage bloğu dahil edilen, beklemedeki (25 saatlik kendi geçmişini bekleyen), eskimiş olduğu için hariç tutulan ve mevcut olmayan borsaları listeler
Birimler
open interest in USD notional; total_usd_single_adjusted halves venues that report double-sided OI; changes in percent
Yöntem
total_usd = SUM(oi_usd) over fresh contracts (multiplier contracts folded); breakdowns by kind / margin / contract type; h1 / h4 change by same-contract pairing against 15-minute snapshots (+/- 10 min, fallback hourly archive) and only when >= 50% of OI is matched; h24 change by same-exchange pairing against the hourly bucket nearest now - 24 h
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 03:57:39 UTCHTTP 20032 msŞema eşleşiyorEn yeni veri noktası 2s öncesine ait

Erişilebilirlik, son 30 gün

411 kontrolde başarı oranı: %100

Son yoklamanın saptadığı şema sapması
  • Dönüyor ama belgelenmemiş: coverage.stale_excluded[], coverage.stale_excluded[].exchange, coverage.stale_excluded[].symbol, coverage.stale_excluded[].oi_usd, coverage.stale_excluded[].age_s, coverage.stale_excluded[].reason

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

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

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