/api/funding/heatmap
GETVerfügbar

Funding-Rate-Heatmap

Funding-Rate-Heatmap (Coin × Tag)

GET/api/funding/heatmap

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
daysintegerOptional30≥ 7 · ≤ 90Rückblickfenster in Tagen. Beispiel: 30
exchangestringOptionalbinance—Börsenkennung (Kleinbuchstaben, z. B. binance). Beispiel: binance
limitintegerOptional50≤ 100Anzahl der zurückzugebenden Zeilen.

Beispielanfrage

curl -s "https://www.coinboss.com/api/funding/heatmap?exchange=binance&days=30"

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 }`.
exchangestring—Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`).
daysnumber—Tageswerte oder Anzahl der Tage.
coinsarray—Coins.
coins[]string—Coins.
day_tsarray—Zeitstempel.
day_ts[]numbermsZeitstempel.
matrixarray—Matrix mit Zeile und Spalte als Schlüssel.
matrix[]array—Matrix mit Zeile und Spalte als Schlüssel.
matrix[][]number|null—Matrix mit Zeile und Spalte als Schlüssel.

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

Beispielantwort

/api/funding/heatmap?exchange=binance&days=30 · Echte Antwort, erfasst 2026-11-13 03:57:47 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: coins hatte 50 Elemente; day_ts hatte 30 Elemente; matrix hatte 50 Elemente; matrix[] hatte 30 Elemente.

  • {
    • "success": true,
    • "exchange": "binance",
    • "days": 30,
    • "coins": [
      • "BTC",
      • "ETH",
      • "ZEC",
      • "SOL",
      • "XAU",
      • "XRP",
      • "HYPE",
      • "XAG"
      ],
    • "day_ts": [
      • 1792022400000,
      • 1792108800000,
      • 1792195200000,
      • 1792281600000,
      • 1792368000000,
      • 1792454400000,
      • 1792540800000,
      • 1792627200000
      ],
    • "matrix": [
      • [ … 8 ],
      • [ … 8 ]
      ]
    }

Geprüfte Stichproben

Neben dem obigen Beispiel ruft die Prüfsonde diesen Endpunkt mit den folgenden Parametern auf und prüft jedes Mal das Schema.

ParameterHTTPLatenzErgebnis
days=30&exchange=okx20065 msBestanden
days=30&exchange=hyperliquid20078 msBestanden

Geprüft 2026-11-13 03:57:47 UTC

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
5m
Edge-Micro-Cache
10s
Aktualisierungsintervall
stündlich (Derivate-Collector mit 60-min-Timer; Abrechnungsjob der eigenen Datenschicht ab Minute >= 6 jeder Stunde)
Zeitfenster
Parameter days, Standard 30, Bereich 7..90; eine Zelle je Coin und UTC-Tag
Datenquellen
Abgerechnete Funding-Rate-Datensätze, von den eigenen Collectoren stündlich über die öffentlichen Funding-Historien-Endpunkte von 16 Börsen abgefragt (z. B. binance, bybit, okx, gate, bitget, hyperliquid).
Börsenabdeckung
eine Börse pro Anfrage (Parameter exchange, Standard binance); Top-Coins nach Futures-Volumen; Nicht-Krypto-Symbole werden über eine Krypto-Whitelist herausgefiltert; 16 Börsen; binance deckt alle USDT-Perpetual-Kontrakte ab; bybit / okx / gate / bitget decken die Top 60 Coins nach Futures-Volumen ab, htx die Top 20; bei aster, hyperliquid, kucoin, mexc, bingx, kraken, dydx, deribit, whitebit, cryptocom wird ein Hauptkontrakt je Coin geführt; bitfinex hat keine öffentliche Abrechnungshistorie; die Tiefe der Historie unterscheidet sich je Börse (binance / bybit / okx / bitget ab 2026-04-04, andere später)
Paginierung
limit = Anzahl der Coins (Standard 50, max. 100)
Sortierung
Futures-Volumen absteigend
Einheiten
cumulative settled funding in percent per UTC day; day_ts in Unix ms
Methode
cell = SUM(settled rate) x 100 over all settlements of that coin on that UTC day for the selected exchange
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:47 UTCHTTP 200318 msSchema stimmt übereinNeuester Datenpunkt 4h alt

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/funding/heatmapVerfügbar
Parameter

integer · Standard 30 · min. 7 · max. 90 — Look-back window in days.

string · Standard binance — Exchange id (lowercase, e.g. binance).

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

Anfrage-URLhttps://www.coinboss.com/api/funding/heatmap?days=30&exchange=binance
Wählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.