/api/oi/matrix
GETVerfügbar

Open-Interest-Matrix

Open-Interest-Matrix (Coin × Börse)

GET/api/oi/matrix

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
limitintegerOptional100≤ 500Anzahl der zurückzugebenden Zeilen. Beispiel: 100

Beispielanfrage

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

Antwortfelder

Die Feldtabelle wird aus echten Antworten erzeugt und führt daher genau das auf, was der Endpunkt zurückgibt. In Pfaden steht a[] für Array-Elemente und {*} für Objekte, deren Schlüssel ein dynamischer Name ist, etwa ein Coin oder eine Börse.

FeldTypEinheitBeschreibung
successboolean—true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`.
nownumbermsServerzeit beim Erstellen der Antwort.
scopestring—Kontraktumfang der Matrix; immer `all_contracts` (USDT-, USDC- und coin-marginierte Perpetual-Kontrakte, Terminkontrakte mit Fälligkeit und CME).
exchangesarray—Börsen.
exchanges[]string—Börsen.
countnumber—Anzahl der Elemente.
dataarray—Nutzdaten.
data[]object—Nutzdaten.
data[].basestring—Symbol des Basis-Assets.
data[].oiobject—Open Interest.
data[].oi.asternumber—Wert für die Börse `aster` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.backpacknumber—Wert für die Börse `backpack` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.binancenumber—Wert für die Börse `binance` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.bingxnumber—Wert für die Börse `bingx` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.bitfinexnumber—Wert für die Börse `bitfinex` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.bitgetnumber—Wert für die Börse `bitget` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.bybitnumber—Wert für die Börse `bybit` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.cmenumber—Wert für die Börse `cme` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.cryptocomnumber—Wert für die Börse `cryptocom` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.deribitnumber—Wert für die Börse `deribit` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.dydxnumber—Wert für die Börse `dydx` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.edgexnumber—Wert für die Börse `edgex` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.gatenumber—Wert für die Börse `gate` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.htxnumber—Wert für die Börse `htx` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.hyperliquidnumber—Wert für die Börse `hyperliquid` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.krakennumber—Wert für die Börse `kraken` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.kucoinnumber—Wert für die Börse `kucoin` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.lighternumber—Wert für die Börse `lighter` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.mexcnumber—Wert für die Börse `mexc` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.okxnumber—Wert für die Börse `okx` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.paradexnumber—Wert für die Börse `paradex` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].oi.whitebitnumber—Wert für die Börse `whitebit` (der Schlüssel ist die Börsenkennung). kann fehlen
data[].total_usdnumberUSDGesamtzahl.
data[].change_24h_pctnumber%Prozentuale Veränderung über 24h.
data[].pricenumber|null—Letzter Preis in der Kurswährung (USD oder USDT, sofern nicht anders angegeben).
data[].exchange_countnumber—Anzahl der Börsen.
data[].oi.tradexyznumberUSDOpen Interest des Coins an der Börse mit der Kennung `tradexyz`; die Schlüssel unter `oi` sind Börsenkennungen, und fehlende Schlüssel bedeuten, dass keine aktuellen Daten vorliegen. kann fehlen

Erzeugt 2026-11-11 23:00 UTC aus 1 echten Antworten.

Beispielantwort

/api/oi/matrix?limit=100 · Echte Antwort, erfasst 2026-11-13 03:57:41 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: data hatte 100 Elemente; exchanges hatte 23 Elemente.

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

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
30s
Edge-Micro-Cache
10s
Aktualisierungsintervall
bei den meisten Börsen alle 60 s (zusammen mit den Tickern geschrieben; binance Top 50 und okx mit eigenen 60-s-Jobs); vollständige Durchläufe für binance / bingx / aster / gate / htx alle 5 min; coin-marginierte / USDC- / Terminkontrakte mit Fälligkeit alle 120 s (Übernahme in die gemeinsame Tabelle alle 5 min); cme einmal pro Handelstag (04:10 UTC); 24-h-Vergleichsbasis aus dem stündlichen Archiv
Zeitfenster
letzter Snapshot; 24-h-Veränderung gegenüber dem Stunden-Bucket, der dem Zeitpunkt jetzt - 24 h am nächsten liegt
Datenquellen
Open Interest, von den eigenen Collectoren über die öffentlichen REST-APIs von 22 Derivatebörsen abgefragt (z. B. binance, okx, bybit, gate, bitget, hyperliquid), dazu der offizielle Tagesbericht der CME zu Volumen und Open Interest.
Börsenabdeckung
23 Quellen mit aktuellen Zeilen (22 Börsen + cme); alle Kontrakttypen (linear in USDT / USDC / USD, invers coin-marginiert, Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit); bybit und gate melden doppelseitig gezähltes Open Interest, wie von der Börse offengelegt; Zeilen, die älter als 3 h sind (cme: 120 h), werden ausgeschlossen
Paginierung
limit (Standard 100, max. 500)
Sortierung
total_usd absteigend
Einheiten
open interest in USD notional per exchange; change_24h_pct in percent; price in USD
Methode
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
Zeitstempel
Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
Antwortformat
json
Stabilität
Stabil

Live-Status

VerfügbarGeprüft 2026-11-13 03:57:41 UTCHTTP 200137 msSchema stimmt überein

Verfügbarkeit, letzte 30 Tage

100 % von 410 Prüfungen bestanden

Fehler

Fehlgeschlagene Aufrufe haben auf jedem Endpunkt denselben Aufbau. Die vollständige Liste steht auf der Fehlerseite. Fehler und Rate-Limits →

CodeHTTPBedeutungEmpfohlene Reaktion
INVALID_PARAM400Ein erforderlicher Parameter fehlt oder ein Wert wird nicht akzeptiert. `param` nennt den Parameter, sofern er bekannt ist.Nicht unverändert wiederholen; die Anfrage korrigieren.
UNAUTHORIZED401Der Header `CB-API-KEY` wurde gesendet, der Schlüssel ist jedoch unbekannt oder widerrufen. Öffentliche Daten erfordern keinen Schlüssel – lassen Sie den Header weg oder verwenden Sie einen gültigen Schlüssel.Nicht unverändert wiederholen.
FORBIDDEN403Die Route gehört nicht zur öffentlichen API (intern oder nur für Konten).Nicht wiederholen.
NOT_FOUND404Unbekannte Route, oder der angefragte Coin / die Börse / der Fonds existiert nicht.Nicht wiederholen; Pfad und Kennungen mit dem Katalog abgleichen.
RATE_LIMITED429Mehr Anfragen, als das Limit pro Minute zulässt. `Retry-After` gibt die Wartezeit in Sekunden an.`Retry-After` abwarten, dann mit Backoff wiederholen.
INTERNAL500Unerwarteter Serverfehler. Die Meldung ist bewusst allgemein gehalten; geben Sie `request_id` an, wenn Sie den Fehler melden.Einmal nach einigen Sekunden wiederholen; wenn der Fehler bestehen bleibt, mit der Request-ID melden.
UPSTREAM_FAILED503Die Datenquelle hinter diesem Endpunkt hat nicht rechtzeitig geantwortet. Es werden ersatzweise keine veralteten oder stellvertretenden Zahlen zurückgegeben.Mit Backoff wiederholen; die Statusseite prüfen.
UNAVAILABLE501 / 503Der Datensatz ist vorübergehend nicht bereit (Cache wird aufgewärmt), oder der Endpunkt hat noch keine rechtmäßige öffentliche Quelle.Später wiederholen; der Katalog kennzeichnet Endpunkte, die konzeptbedingt nicht verfügbar sind.
REQUEST_FAILED200Einige ältere Endpunkte antworten mit HTTP 200 und `success: false`. Prüfen Sie immer `success`, nicht nur den HTTP-Status.Hängt von der Meldung ab; als fehlgeschlagene Anfrage behandeln.

Ausprobieren

GET/api/oi/matrixVerfügbar
Parameter

integer · Standard 100 · max. 500 — Number of rows to return.

Anfrage-URLhttps://www.coinboss.com/api/oi/matrix?limit=100
Wählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.