/api/oi/matrix
GETKullanılabilir

Açık pozisyon matrisi

Açık pozisyon matrisi (coin × borsa)

GET/api/oi/matrix

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
limitintegerİsteğe bağlı100≤ 500Döndürülecek satır sayısı. Örnek: 100

Örnek istek

curl -s "https://www.coinboss.com/api/oi/matrix?limit=100"

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.
nownumbermsYanıtın oluşturulduğu andaki sunucu zamanı.
scopestring—Matrisin sözleşme kapsamı; her zaman `all_contracts` (USDT, USDC ve coin teminatlı sürekli vadeli sözleşmeler, teslimatlı vadeli sözleşmeler ve CME).
exchangesarray—Borsalar.
exchanges[]string—Borsalar.
countnumber—Öğe sayısı.
dataarray—Veri yükü.
data[]object—Veri yükü.
data[].basestring—Temel varlık sembolü.
data[].oiobject—Açık pozisyon.
data[].oi.asternumber—`aster` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.backpacknumber—`backpack` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.binancenumber—`binance` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.bingxnumber—`bingx` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.bitfinexnumber—`bitfinex` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.bitgetnumber—`bitget` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.bybitnumber—`bybit` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.cmenumber—`cme` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.cryptocomnumber—`cryptocom` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.deribitnumber—`deribit` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.dydxnumber—`dydx` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.edgexnumber—`edgex` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.gatenumber—`gate` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.htxnumber—`htx` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.hyperliquidnumber—`hyperliquid` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.krakennumber—`kraken` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.kucoinnumber—`kucoin` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.lighternumber—`lighter` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.mexcnumber—`mexc` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.okxnumber—`okx` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.paradexnumber—`paradex` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].oi.whitebitnumber—`whitebit` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].total_usdnumberUSDToplam.
data[].change_24h_pctnumber%24h yüzde değişim.
data[].pricenumber|null—Kotasyon para birimi cinsinden son fiyat (aksi belirtilmedikçe USD veya USDT).
data[].exchange_countnumber—Borsa sayısı.
data[].oi.tradexyznumberUSDCoinin `tradexyz` kimlikli borsadaki açık pozisyonu; `oi` altındaki anahtarlar borsa kimlikleridir ve bulunmayan anahtarlar güncel veri olmadığı anlamına gelir. bulunmayabilir

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

Örnek yanıt

/api/oi/matrix?limit=100 · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:57:41 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: data: 100 öğe içeriyordu; exchanges: 23 öğe içeriyordu.

  • {
    • "success": true,
    • "now": 1794542261527,
    • "scope": "all_contracts",
    • "exchanges": [
      • "binance",
      • "cme",
      • "okx",
      • "bybit",
      • "bitget",
      • "gate",
      • "htx",
      • "bitfinex"
      ],
    • "count": 2257,
    • "data": [
      • { … 6 },
      • { … 6 }
      ]
    }

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ığı
ç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); 24 saatlik referans saatlik arşivden alınır
Pencere
en güncel anlık görüntü; 24 saatlik değişim, şimdi - 24 saat anına en yakın saatlik dilime göre
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
Sayfalama
limit (varsayılan 100, en çok 500)
Sıralama
total_usd, azalan
Birimler
open interest in USD notional per exchange; change_24h_pct in percent; price in USD
Yöntem
total_usd = SUM(oi_usd) over all fresh contracts of the coin (multiplier contracts such as 1000PEPE folded); change_24h_pct = (cur - prev) / prev x 100 using only exchanges present in both snapshots; contracts whose archived value is frozen for 3 consecutive hours are excluded from both sides
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 03:57:41 UTCHTTP 200137 msŞema eşleşiyor

Erişilebilirlik, son 30 gün

410 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/oi/matrixKullanılabilir
Parametreler

integer · varsayılan 100 · en çok 500 — Number of rows to return.

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