Funding für einen Coin
Eigene Datenschicht: Funding für einen Coin (auf 8h normalisiert, gewichtet)
/api/sd/fundingAnfrage
Query-Parameter
| Name | Typ | Erforderlich | Standard | Zulässige Werte | Beschreibung |
|---|---|---|---|---|---|
| coin | string | Erforderlich | — | — | Coin-Symbol; 400, wenn es fehlt. Alias: `base`. Beispiel: BTC |
Beispielanfrage
curl -s "https://www.coinboss.com/api/sd/funding?coin=BTC"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 }`. |
| coin | string | — | Coin-Symbol in Großbuchstaben (zum Beispiel BTC). |
| now | number | ms | Serverzeit beim Erstellen der Antwort. |
| unit | string | — | Einheit aller Ratenfelder in dieser Antwort: `fraction` (0.0001 = 0,01 %). |
| avg_8h | number | fraction per 8h | Einfacher Mittelwert der auf 8h normalisierten Raten, ein Kontrakt je Börse. |
| oi_weighted_8h | number | fraction per 8h | Mit dem Open Interest gewichteter Mittelwert der auf 8h normalisierten Raten. |
| apr_pct | number | % per year | Einfache Annualisierung: 8h-Rate × 3 × 365 × 100. |
| apr_basis | string | — | Gibt an, auf welchem Aggregat der Hauptwert `apr_pct` beruht. |
| n_exchanges | number | — | Anzahl der beitragenden Börsen. |
| n_normalized | number | — | Börsen, deren Funding-Intervall bekannt ist und auf 8h normalisiert werden konnte. |
| n_unknown_interval | number | — | Börsen, die aus den Aggregaten herausgenommen wurden, weil ihr Funding-Intervall unbekannt ist. |
| settled_cum_7d | object | — | Summe der tatsächlich abgerechneten Funding-Rates der letzten 7 Tage, gemittelt über die Börsen mit Abrechnungshistorie. |
| settled_cum_7d.avg | number | fraction | Einfacher Mittelwert über die Börsen. |
| settled_cum_7d.oi_weighted | number | fraction | Mit dem Open Interest gewichteter Mittelwert. |
| settled_cum_7d.n | number | — | Börsen mit vollständigem Zeitfenster. |
| settled_cum_30d | object | — | Dasselbe über 30 Tage. |
| settled_cum_30d.avg | number | fraction | Einfacher Mittelwert über die Börsen. |
| settled_cum_30d.oi_weighted | number | fraction | Mit dem Open Interest gewichteter Mittelwert. |
| settled_cum_30d.n | number | — | Börsen mit vollständigem Zeitfenster. |
| by_exchange | array | — | Eine Zeile je Börse: ihr Hauptkontrakt für diesen Coin (der mit dem größten Open Interest). |
| by_exchange[] | object | — | Aufschlüsselung je Börse. |
| by_exchange[].exchange | string | — | Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`). |
| by_exchange[].symbol | string | — | Instrumentensymbol in der von CoinBoss normalisierten Form (zum Beispiel BTCUSDT). |
| by_exchange[].margin | string | — | Klasse der Margin-Währung. |
| by_exchange[].kind | string | — | Art. |
| by_exchange[].primary | boolean | — | true für den Kontrakt, der die Börse in den Aggregaten repräsentiert. |
| by_exchange[].rate | number | — | Funding-Rate der laufenden Periode, wie von der Börse veröffentlicht. |
| by_exchange[].interval_h | number | h | Funding-Intervall. |
| by_exchange[].rate_8h | number | — | Auf einen 8-Stunden-Zeitraum normalisierte Rate: rate × 8 / interval_h. |
| by_exchange[].apr_pct | number | % per year | Annualisierter Prozentwert. |
| by_exchange[].next_funding_time | number|null | ms | Nächster Abrechnungszeitpunkt. |
| by_exchange[].next_derived | boolean | — | true, wenn der nächste Abrechnungszeitpunkt aus dem Intervall abgeleitet und nicht von der Börse veröffentlicht wurde. |
| by_exchange[].predicted_rate | null | — | Indikative Rate der nächsten Periode, sofern die Börse eine veröffentlicht; andernfalls null. |
| by_exchange[].oi_usd | number|null | USD | Open Interest als Nominalwert in USD. |
| by_exchange[].updated_at | number | ms | Zeitpunkt der letzten Aktualisierung dieser Zeile. |
| by_exchange[].age_s | number | s | Sekunden seit der letzten Aktualisierung dieser Zeile. |
| by_exchange[].is_stale | boolean | — | true, wenn die Zeile älter als das Aktualitätsfenster ist; veraltete Zeilen fließen nicht in die Summen ein. |
| by_exchange[].settled | object|null | — | Tatsächliche Abrechnungsdatensätze für diesen Kontrakt; null, wenn die Börse keine öffentliche Historie hat. |
| by_exchange[].settled.last_rate | number | — | Rate der jüngsten Abrechnung. kann fehlen |
| by_exchange[].settled.last_time | number | ms | Zeitpunkt der jüngsten Abrechnung. kann fehlen |
| by_exchange[].settled.interval_h | number | h | Funding-Intervall. kann fehlen |
| by_exchange[].settled.cum_7d | number | — | Summe der abgerechneten Raten der letzten 7 Tage. kann fehlen |
| by_exchange[].settled.n_7d | number | — | In den letzten 7 Tagen gefundene Abrechnungen. kann fehlen |
| by_exchange[].settled.n_7d_expected | number | — | In 7 Tagen bei diesem Intervall erwartete Abrechnungen. kann fehlen |
| by_exchange[].settled.cum_7d_complete | boolean | — | true, wenn im 7-Tage-Fenster keine Abrechnung fehlt. kann fehlen |
| by_exchange[].settled.cum_30d | number | — | Summe der abgerechneten Raten der letzten 30 Tage. kann fehlen |
| by_exchange[].settled.n_30d | number | — | In den letzten 30 Tagen gefundene Abrechnungen. kann fehlen |
| by_exchange[].settled.n_30d_expected | number | — | In 30 Tagen bei diesem Intervall erwartete Abrechnungen. kann fehlen |
| by_exchange[].settled.cum_30d_complete | boolean | — | true, wenn im 30-Tage-Fenster keine Abrechnung fehlt. kann fehlen |
| by_exchange[].settled.history_from | number | ms | Frühester für diesen Kontrakt vorhandener Abrechnungsdatensatz. kann fehlen |
| other_contracts | array | — | Weitere Kontrakte desselben Coins (USDC, coin-marginiert, …). Nicht Teil der Aggregate. |
| other_contracts[] | object | — | Ein zusätzlicher Funding-Kontrakt einer Börse (coin-marginiert, USDC, …), der nicht ihr Hauptkontrakt ist und von den Aggregaten ausgeschlossen bleibt. |
| other_contracts[].exchange | string | — | Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`). |
| other_contracts[].symbol | string | — | Instrumentensymbol in der von CoinBoss normalisierten Form (zum Beispiel BTCUSDT). |
| other_contracts[].margin | string | — | Klasse der Margin-Währung. |
| other_contracts[].kind | string | — | Art. |
| other_contracts[].primary | boolean | — | true für den Kontrakt, der die Börse in den Aggregaten repräsentiert. |
| other_contracts[].rate | number | — | Funding-Rate der laufenden Periode, wie von der Börse veröffentlicht. |
| other_contracts[].interval_h | number|null | h | Funding-Intervall. |
| other_contracts[].rate_8h | number|null | — | Auf einen 8-Stunden-Zeitraum normalisierte Rate: rate × 8 / interval_h. |
| other_contracts[].apr_pct | number|null | % per year | Annualisierter Prozentwert. |
| other_contracts[].next_funding_time | number|null | ms | Nächster Abrechnungszeitpunkt. |
| other_contracts[].next_derived | boolean | — | true, wenn der nächste Abrechnungszeitpunkt aus dem Intervall abgeleitet und nicht von der Börse veröffentlicht wurde. |
| other_contracts[].predicted_rate | number|null | — | Indikative Rate der nächsten Periode, sofern die Börse eine veröffentlicht; andernfalls null. |
| other_contracts[].oi_usd | number|null | USD | Open Interest als Nominalwert in USD. |
| other_contracts[].updated_at | number | ms | Zeitpunkt der letzten Aktualisierung dieser Zeile. |
| other_contracts[].age_s | number | s | Sekunden seit der letzten Aktualisierung dieser Zeile. |
| other_contracts[].is_stale | boolean | — | true, wenn die Zeile älter als das Aktualitätsfenster ist; veraltete Zeilen fließen nicht in die Summen ein. |
| other_contracts[].settled | object|null | — | Tatsächliche Abrechnungsdatensätze für diesen Kontrakt; null, wenn die Börse keine öffentliche Historie hat. |
| other_contracts[].settled.last_rate | number | — | Rate der jüngsten Abrechnung. kann fehlen |
| other_contracts[].settled.last_time | number | ms | Zeitpunkt der jüngsten Abrechnung. kann fehlen |
| other_contracts[].settled.interval_h | number | h | Funding-Intervall. kann fehlen |
| other_contracts[].settled.cum_7d | number | — | Summe der abgerechneten Raten der letzten 7 Tage. kann fehlen |
| other_contracts[].settled.n_7d | number | — | In den letzten 7 Tagen gefundene Abrechnungen. kann fehlen |
| other_contracts[].settled.n_7d_expected | number | — | In 7 Tagen bei diesem Intervall erwartete Abrechnungen. kann fehlen |
| other_contracts[].settled.cum_7d_complete | boolean | — | true, wenn im 7-Tage-Fenster keine Abrechnung fehlt. kann fehlen |
| other_contracts[].settled.cum_30d | number | — | Summe der abgerechneten Raten der letzten 30 Tage. kann fehlen |
| other_contracts[].settled.n_30d | number | — | In den letzten 30 Tagen gefundene Abrechnungen. kann fehlen |
| other_contracts[].settled.n_30d_expected | number | — | In 30 Tagen bei diesem Intervall erwartete Abrechnungen. kann fehlen |
| other_contracts[].settled.cum_30d_complete | boolean | — | true, wenn im 30-Tage-Fenster keine Abrechnung fehlt. kann fehlen |
| other_contracts[].settled.history_from | number | ms | Frühester für diesen Kontrakt vorhandener Abrechnungsdatensatz. kann fehlen |
| coverage | object | — | Was in den obigen Zahlen enthalten ist und was nicht. Vergleichen Sie dies, bevor Sie Summen mit einer anderen Quelle vergleichen. |
| coverage.settle_history_exchanges | array | — | Börsen, für die tatsächliche Abrechnungsdatensätze erhoben werden. |
| coverage.settle_history_exchanges[] | string | — | Kennung einer Börse, für die bei diesem Coin tatsächliche Funding-Abrechnungsdatensätze erhoben werden. |
| coverage.no_settle_history | array | — | Börsen ohne öffentliche Quelle für die Abrechnungshistorie; ihr `settled` ist null. |
| coverage.no_settle_history[] | string | — | Börsenkennung eines Hauptkontrakts, für den keine Abrechnungshistorie erhoben wurde, sodass sein `settled`-Block null ist. |
| coverage.unknown_interval | array | — | Zeilen, deren Funding-Intervall nicht ermittelt werden konnte. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde |
| coverage.no_liveness_excluded | array | — | Zeilen, die ausgeschlossen wurden, weil der Kontrakt keine Anzeichen von Handel zeigt (kein aktueller Ticker, kein Open Interest, kein Kurs). leer in den Stichproben, aus denen diese Tabelle erzeugt wurde |
| method | object | — | Klartextangabe der Formeln, die für diese Antwort verwendet wurden. |
| method.rate | string | — | Funding-Rate der laufenden Periode, wie von der Börse veröffentlicht. |
| method.rate_8h | string | — | Auf einen 8-Stunden-Zeitraum normalisierte Rate: rate × 8 / interval_h. |
| method.apr_pct | string | % per year | Annualisierter Prozentwert. |
| method.aggregate | string | — | Aggregat über die Börsen. |
| method.settled | string | — | Tatsächliche Abrechnungsdatensätze für diesen Kontrakt; null, wenn die Börse keine öffentliche Historie hat. |
| method.predicted_rate | string | — | Indikative Rate der nächsten Periode, sofern die Börse eine veröffentlicht; andernfalls null. |
| method.liveness | string | — | Klartextregel zum Ausschluss toter Kontrakte: Eine Funding-Zeile zählt nur mit einem Ticker innerhalb von 1h, Open Interest innerhalb von 3h oder einer eigenen Quote innerhalb von 3h. |
Erzeugt 2026-11-11 23:00 UTC aus 4 echten Antworten.
Beispielantwort
/api/sd/funding?coin=BTC · Echte Antwort, erfasst 2026-11-13 03:57:42 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: by_exchange hatte 23 Elemente; other_contracts hatte 18 Elemente; coverage.settle_history_exchanges hatte 16 Elemente.
- "success"true
- "coin""BTC"
- "now"1794542262267
- "unit""fraction"
- "avg_8h"0.00006731782608695654
- "oi_weighted_8h"0.00005745116946489526
- "apr_pct"6.2909
- "apr_basis""oi_weighted_8h"
- "n_exchanges"23
- "n_normalized"23
- "n_unknown_interval"0
- "settled_cum_7d"
- "avg"0.0016089506666666666
- "oi_weighted"0.0015317230977727185
- "n"15
- "settled_cum_30d"
- "avg"0.0066857086666666675
- "oi_weighted"0.006362887957085279
- "n"15
- "by_exchange"
- "other_contracts"
- "coverage"
- "settle_history_exchanges"
- "no_settle_history"
- "unknown_interval"
- "no_liveness_excluded"
- "method"
- "rate""current funding-period rate as published by the exchange (charged at next settlement; may change until then)"
- "rate_8h""rate × 8 / interval_h (rows with unknown interval excluded from aggregates)"
- "apr_pct""per exchange: rate_8h × 3 × 365 × 100; headline apr_pct = oi_weighted_8h × 3 × 365 × 100 (falls back to avg_8h when no OI weights; see apr_basis). Simple annual…"
- "aggregate""one contract per exchange (largest OI); avg_8h = simple mean; oi_weighted_8h = Σ(rate_8h × oi_usd)/Σoi_usd"
- "settled""actual settlement records collected from each exchange funding-history endpoint; cum = Σ settled rates in window"
- "predicted_rate""exchange-published indicative/next-period rate where available"
- "liveness""a funding row is used only if the same contract on the same exchange has a ticker within 1h, open interest within 3h, or a self-collected quote within 3h; rows …"
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 |
|---|---|---|---|
| coin=ETH | 200 | 43 ms | Bestanden |
| coin=SOL | 200 | 44 ms | Bestanden |
| coin=ARKM | 200 | 41 ms | Bestanden |
| — | 400 | 1 ms | Bestanden liefert den erwarteten Fehler |
Geprüft 2026-11-13 03:57:42 UTC
Details
- Authentifizierung
- Keine. Öffentlicher Endpunkt.
- Rate-Limit
- 1200 Anfragen pro Minute und IP
- Server-Cache
- 20s
- Edge-Micro-Cache
- 10s
- Aktualisierungsintervall
- bei den meisten Börsen alle 60 s (zusammen mit den Tickern geschrieben; binance mit eigenem 60-s-Job); übrige Funding-Jobs und coin-marginierte Kontrakte alle 5 min; Abrechnungsdatensätze stündlich
- Zeitfenster
- letzter Snapshot (Funding-Zeilen innerhalb von 4 h bei Kontrakten mit aktivem Ticker / OI); abgerechnete Summen über 7 d und 30 d
- Datenquellen
- Aktuelle Funding-Rates, von den eigenen Collectoren über die öffentlichen REST-APIs von 24 Börsen mit Perpetual-Kontrakten abgefragt (z. B. binance, okx, bybit, bitget, gate, hyperliquid).
- Börsenabdeckung
- 24 Börsen für aktuelle Raten; Abrechnungshistorie von 16 Börsen (coin-marginierte Perpetual-Kontrakte von binance, okx, bybit werden getrennt geführt)
- Einheiten
- unit = 'fraction' (0.0001 = 0.01%); rate_8h normalized to 8 h; apr_pct in percent; times in Unix ms
- Methode
- one contract per exchange (largest OI); rate_8h = rate x 8 / interval_hours; avg_8h = simple mean; oi_weighted_8h = SUM(rate_8h x oi_usd) / SUM(oi_usd); apr_pct = rate_8h x 3 x 365 x 100; settled 7 d / 30 d = SUM of settlement records with a completeness flag (>= 90% of expected settlements)
- Zeitstempel
- Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
- Antwortformat
- json
- Stabilität
- Stabil
- Verfügbar seit
- 2026-11-11
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/sd/fundingVerfügbarstring — Coin symbol; 400 when missing. Alias: `base`.
https://www.coinboss.com/api/sd/funding?coin=BTCMehr 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