Funding-Rate-Heatmap
Funding-Rate-Heatmap (Coin × Tag)
/api/funding/heatmapAnfrage
Query-Parameter
| Name | Typ | Erforderlich | Standard | Zulässige Werte | Beschreibung |
|---|---|---|---|---|---|
| days | integer | Optional | 30 | ≥ 7 · ≤ 90 | Rückblickfenster in Tagen. Beispiel: 30 |
| exchange | string | Optional | binance | — | Börsenkennung (Kleinbuchstaben, z. B. binance). Beispiel: binance |
| limit | integer | Optional | 50 | ≤ 100 | Anzahl 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.
| Feld | Typ | Einheit | Beschreibung |
|---|---|---|---|
| success | boolean | — | true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`. |
| exchange | string | — | Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`). |
| days | number | — | Tageswerte oder Anzahl der Tage. |
| coins | array | — | Coins. |
| coins[] | string | — | Coins. |
| day_ts | array | — | Zeitstempel. |
| day_ts[] | number | ms | Zeitstempel. |
| matrix | array | — | 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"
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.
| Parameter | HTTP | Latenz | Ergebnis |
|---|---|---|---|
| days=30&exchange=okx | 200 | 65 ms | Bestanden |
| days=30&exchange=hyperliquid | 200 | 78 ms | Bestanden |
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ü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 →
| Code | HTTP | Bedeutung | Empfohlene Reaktion |
|---|---|---|---|
| INVALID_PARAM | 400 | Ein erforderlicher Parameter fehlt oder ein Wert wird nicht akzeptiert. `param` nennt den Parameter, sofern er bekannt ist. | Nicht unverändert wiederholen; die Anfrage korrigieren. |
| UNAUTHORIZED | 401 | Der 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. |
| FORBIDDEN | 403 | Die Route gehört nicht zur öffentlichen API (intern oder nur für Konten). | Nicht wiederholen. |
| NOT_FOUND | 404 | Unbekannte Route, oder der angefragte Coin / die Börse / der Fonds existiert nicht. | Nicht wiederholen; Pfad und Kennungen mit dem Katalog abgleichen. |
| RATE_LIMITED | 429 | Mehr Anfragen, als das Limit pro Minute zulässt. `Retry-After` gibt die Wartezeit in Sekunden an. | `Retry-After` abwarten, dann mit Backoff wiederholen. |
| INTERNAL | 500 | Unerwarteter 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_FAILED | 503 | Die 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. |
| UNAVAILABLE | 501 / 503 | Der 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_FAILED | 200 | Einige ä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
/api/funding/heatmapVerfügbarinteger · 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.
https://www.coinboss.com/api/funding/heatmap?days=30&exchange=binanceMehr in dieser Kategorie
- Funding für einen Coin /api/sd/funding
- OI-gewichtete / volumengewichtete Funding-Historie /api/currency/funding-weighted
- Funding-Rate-Details je Börse für einen Coin /api/derivatives/funding-detail
- Kumuliertes Funding je Börse für einen Coin /api/funding/accumulated
- Funding-Arbitrage-Gelegenheiten /api/funding/arbitrage
- Funding-Rate-Chartreihen für einen Coin /api/funding/chart
- Aktuelle Funding-Rates für einen Coin über alle Börsen /api/funding/coin
- Kumulierte Funding-Gebühren /api/funding/fees
- Funding-Rate-Heatmap /api/funding/heatmap
- Funding-Rate-Historie für einen Coin an einer Börse /api/funding/history
- Funding-Rate-Matrix /api/funding/matrix
- Funding-Rate-Liste je Coin /api/market/funding
- Ranking der börsenübergreifenden Funding-Rate-Spreads /api/market/funding-spread