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

Tek coin için toplu açık pozisyon geçmişi

Tek coin için toplu açık pozisyon geçmişi

GET/api/oi/history

İstek

Sorgu parametreleri

AdTürZorunluVarsayılanİzin verilen değerlerAçıklama
basestringZorunlu——Temel coin sembolü (büyük harf, ör. BTC). Örnek: BTC
hoursintegerİsteğe bağlı168≥ 1 · ≤ 2160Saat cinsinden geriye dönük pencere. Örnek: 168

Örnek istek

curl -s "https://www.coinboss.com/api/oi/history?base=BTC&hours=168"

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.
basestring—Temel varlık sembolü.
hoursnumber—Saatlik değerler veya saat sayısı.
exchangesarray—Borsalar.
exchanges[]string—Borsalar.
countnumber—Öğe sayısı.
dataarray—Veri yükü.
data[]object—Veri yükü.
data[].hour_tsnumbermsSaatlik dilimin başlangıcı.
data[].total_usdnumberUSDToplam.
data[].byExchangeobject—O saatlik anlık görüntüde borsa bazında açık pozisyon; anahtarlar borsa kimlikleridir, değerler coinin o borsadaki sözleşmeleri üzerinden toplanmış USD tutarıdır.
data[].byExchange.bitfinexnumber—`bitfinex` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].byExchange.edgexnumber—`edgex` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].byExchange.asternumber—`aster` borsasının değeri (anahtar, borsa kimliğidir).
data[].byExchange.bingxnumber—`bingx` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].byExchange.kucoinnumber—`kucoin` borsasının değeri (anahtar, borsa kimliğidir).
data[].byExchange.deribitnumber—`deribit` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].byExchange.okxnumber—`okx` borsasının değeri (anahtar, borsa kimliğidir).
data[].byExchange.dydxnumber—`dydx` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].byExchange.hyperliquidnumber—`hyperliquid` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].byExchange.backpacknumber—`backpack` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].byExchange.bitgetnumber—`bitget` borsasının değeri (anahtar, borsa kimliğidir).
data[].byExchange.htxnumber—`htx` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].byExchange.lighternumber—`lighter` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].byExchange.bybitnumber—`bybit` borsasının değeri (anahtar, borsa kimliğidir).
data[].byExchange.binancenumber—`binance` borsasının değeri (anahtar, borsa kimliğidir).
data[].byExchange.gatenumber—`gate` borsasının değeri (anahtar, borsa kimliğidir).
data[].byExchange.mexcnumber—`mexc` borsasının değeri (anahtar, borsa kimliğidir).
data[].byExchange.cryptocomnumber—`cryptocom` borsasının değeri (anahtar, borsa kimliğidir).
data[].byExchange.krakennumber—`kraken` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].byExchange.paradexnumber—`paradex` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir
data[].byExchange.whitebitnumber—`whitebit` borsasının değeri (anahtar, borsa kimliğidir).
data[].byExchange.cmenumber—`cme` borsasının değeri (anahtar, borsa kimliğidir). bulunmayabilir

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

Örnek yanıt

/api/oi/history?base=BTC&hours=168 · 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: 168 öğe içeriyordu; exchanges: 22 öğe içeriyordu.

  • {
    • "success": true,
    • "base": "BTC",
    • "hours": 168,
    • "exchanges": [
      • "aster",
      • "backpack",
      • "binance",
      • "bingx",
      • "bitfinex",
      • "bitget",
      • "bybit",
      • "cme"
      ],
    • "count": 168,
    • "data": [
      • { … 3 },
      • { … 3 }
      ]
    }

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ç
base=ETH&hours=16820032 msBaşarılı
base=SOL&hours=16820032 msBaşarılı
base=ARKM&hours=16820034 msBaşarılı

Kontrol: 2026-11-13 03:57:41 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
5m
Edge mikro önbelleği
10s
Güncelleme sıklığı
her UTC saat değişiminde saatlik arşiv (en güncel tablonun anlık görüntüsü); ClickHouse kopyası 5 dakikada bir eşitlenir
Pencere
hours parametresi, varsayılan 168 h, aralık 1..2160 h; saatlik noktalar
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ı
coin için saatlik arşivde bulunan borsalar; 2026-11-11'den itibaren yalnızca güncel satırlar arşivlenir (OI 3 saat, cme 120 saat); cme'nin günlük değeri saatlik olarak ileri taşınır
Birimler
open interest in USD notional; hour_ts in Unix ms
Yöntem
per hour and exchange: SUM(oi_usd) over all contract symbols of the coin; total_usd = sum over exchanges
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 20035 msŞema eşleşiyorEn yeni veri noktası 58m öncesine ait

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

string — Base coin symbol (uppercase, e.g. BTC).

integer · varsayılan 168 · en az 1 · en çok 2160 — Look-back window in hours.

İstek URL'sihttps://www.coinboss.com/api/oi/history?base=BTC&hours=168
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.