GETKullanılabilir
Açık pozisyon matrisi
Açık pozisyon matrisi (coin × borsa)
GET
/api/oi/matrixİstek
Sorgu parametreleri
| Ad | Tür | Zorunlu | Varsayılan | İzin verilen değerler | Açıklama |
|---|---|---|---|---|---|
| limit | integer | İsteğe bağlı | 100 | ≤ 500 | Dö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.
| 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ı. |
| scope | string | — | 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). |
| exchanges | array | — | Borsalar. |
| exchanges[] | string | — | Borsalar. |
| count | number | — | Öğe sayısı. |
| data | array | — | Veri yükü. |
| data[] | object | — | Veri yükü. |
| data[].base | string | — | Temel varlık sembolü. |
| data[].oi | object | — | Açık pozisyon. |
| data[].oi.aster | number | — | `aster` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.backpack | number | — | `backpack` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.binance | number | — | `binance` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.bingx | number | — | `bingx` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.bitfinex | number | — | `bitfinex` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.bitget | number | — | `bitget` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.bybit | number | — | `bybit` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.cme | number | — | `cme` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.cryptocom | number | — | `cryptocom` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.deribit | number | — | `deribit` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.dydx | number | — | `dydx` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.edgex | number | — | `edgex` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.gate | number | — | `gate` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.htx | number | — | `htx` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.hyperliquid | number | — | `hyperliquid` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.kraken | number | — | `kraken` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.kucoin | number | — | `kucoin` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.lighter | number | — | `lighter` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.mexc | number | — | `mexc` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.okx | number | — | `okx` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.paradex | number | — | `paradex` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].oi.whitebit | number | — | `whitebit` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir |
| data[].total_usd | number | USD | Toplam. |
| data[].change_24h_pct | number | % | 24h yüzde değişim. |
| data[].price | number|null | — | Kotasyon para birimi cinsinden son fiyat (aksi belirtilmedikçe USD veya USDT). |
| data[].exchange_count | number | — | Borsa sayısı. |
| data[].oi.tradexyz | number | USD | Coinin `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"
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ı →
| 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/oi/matrixKullanılabilirParametreler
integer · varsayılan 100 · en çok 500 — Number of rows to return.
İstek URL'si
https://www.coinboss.com/api/oi/matrix?limit=100Bir 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ı
- Tek coin için açık pozisyon /api/sd/oi
- Borsalar genelinde coin bazında açık pozisyon sıralaması /api/market/open-interest
- Tek coin için yığılmış OI grafik serisi /api/oi/chart
- Tek coin için toplu açık pozisyon geçmişi /api/oi/history
- Açık pozisyon matrisi /api/oi/matrix
- Tek coin için açık pozisyon özeti /api/oi/summary