Futures-Basis (alle Börsen)
Basis von Perpetual-Kontrakten (Mark-Preis gegenüber Indexpreis), Basis zwischen Perpetual-Kontrakt und Spot an derselben Börse sowie Basis von Terminkontrakten mit Fälligkeit samt annualisierter Rate, jeweils je Kontrakt, dazu OI-gewichtete, volumengewichtete und Median-Aggregate.
/api/sd/basisAnfrage
Query-Parameter
| Name | Typ | Erforderlich | Standard | Zulässige Werte | Beschreibung |
|---|---|---|---|---|---|
| coin | string | Erforderlich | — | — | Coin-Symbol, Groß-/Kleinschreibung wird nicht beachtet (zum Beispiel `BTC`). Fehlende oder fehlerhafte Werte liefern 400. Beispiel: BTC |
Beispielanfrage
curl -s "https://www.coinboss.com/api/sd/basis?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 }`. |
| schema | string | — | Schema-ID dieser Antwort. Sie ändert sich nur, wenn ein bestehendes Feld seine Bedeutung oder seinen Typ ändert. |
| now | number | ms | Serverzeit beim Erstellen der Antwort. |
| coin | string | — | Coin-Symbol (Großbuchstaben). |
| perp | object | — | Perpetual-Basis: Mark-Preis gegenüber dem Indexpreis derselben Börse. |
| perp.unit | string | — | Einheit der Basiswerte (Prozent). |
| perp.aggregate | object | — | Börsenübergreifendes Aggregat des Abschnitts. |
| perp.aggregate.oi_weighted_pct | number | % | Mit dem Open Interest gewichtete Basis; Zeilen ohne OI-Gewicht bleiben unberücksichtigt. |
| perp.aggregate.oi_weight_usd | number | USD | Summe der verwendeten Open-Interest-Gewichte. |
| perp.aggregate.n_oi_weighted | number | — | Zeilen, die ein OI-Gewicht hatten. |
| perp.aggregate.vol_weighted_pct | number | % | Mit dem 24h-Nominalvolumen gewichtete Basis. |
| perp.aggregate.vol_weight_usd | number | USD | Summe der verwendeten Volumengewichte. |
| perp.aggregate.n_vol_weighted | number | — | Zeilen, die ein Volumengewicht hatten. |
| perp.aggregate.median_pct | number | % | Median der Basis über einen Hauptkontrakt je Börse. |
| perp.aggregate.mean_pct | number | % | Einfacher Mittelwert über dieselbe Menge wie beim Median. |
| perp.aggregate.n_exchanges | number | — | Börsen im Aggregat. |
| perp.aggregate.n_contracts | number | — | Kontrakte im Aggregat. |
| perp.aggregate.min | object | — | Börse und Kontrakt mit der niedrigsten Basis. |
| perp.aggregate.min.exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| perp.aggregate.min.symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. |
| perp.aggregate.min.basis_pct | number | % | (mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median. |
| perp.aggregate.max | object | — | Börse und Kontrakt mit der höchsten Basis. |
| perp.aggregate.max.exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| perp.aggregate.max.symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. |
| perp.aggregate.max.basis_pct | number | % | (mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median. |
| perp.aggregate.median_last_pct | number | % | Median der Basis zum letzten Preis. |
| perp.aggregate.n_exchanges_last | number | — | Börsen im Median zum letzten Preis. |
| perp.aggregate.weights | object | — | Woher die Gewichte stammen, ihr Aktualitätsfenster und das Alter des ältesten Gewichts. |
| perp.aggregate.weights.oi | object | — | Open Interest. |
| perp.aggregate.weights.oi.source | string | — | Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden. |
| perp.aggregate.weights.oi.fresh_window_s | number | s | Ein Gewicht, das älter ist, wird nicht verwendet. |
| perp.aggregate.weights.oi.oldest_age_s | number | s | Alter des ältesten verwendeten Gewichts. |
| perp.aggregate.weights.oi.side | string | — | Ob das Open-Interest-Gewicht einseitig gezählt ist. |
| perp.aggregate.weights.vol | object | — | Volumen. |
| perp.aggregate.weights.vol.source | string | — | Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden. |
| perp.aggregate.weights.vol.fresh_window_s | number | s | Ein Gewicht, das älter ist, wird nicht verwendet. |
| perp.aggregate.weights.vol.oldest_age_s | number | s | Alter des ältesten verwendeten Gewichts. |
| perp.contracts | array | — | Eine Zeile je Kontrakt. |
| perp.contracts[] | object | — | Eine Zeile je Kontrakt. |
| perp.contracts[].exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| perp.contracts[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. |
| perp.contracts[].native_symbol | string | — | Kontraktsymbol in der Schreibweise der Börse. |
| perp.contracts[].quote | string | — | Kurswährung des Kontrakts. |
| perp.contracts[].margin_type | string | — | Margin-Typ des Kontrakts (zum Beispiel USDT-marginiert, coin-marginiert). |
| perp.contracts[].multiplier | number | — | Coins je notierter Einheit (1000 bei Kontrakten nach dem Muster `1000PEPE`). Die Basis bleibt davon unberührt. |
| perp.contracts[].mark_price | number|null | — | Von der Börse veröffentlichter Mark-Preis. |
| perp.contracts[].index_price | number|null | — | Von der Börse veröffentlichter Indexpreis. |
| perp.contracts[].last_price | number|null | — | Zuletzt gehandelter Preis. |
| perp.contracts[].index_kind | string|null | — | Art des Index: `exchange_index`, `oracle` oder eine andere Art, die angezeigt, aber nicht aggregiert wird. |
| perp.contracts[].basis_pct | number|null | % | (mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median. |
| perp.contracts[].basis_abs | number|null | — | mark − index, in der Kurswährung. |
| perp.contracts[].basis_last_pct | number|null | % | (last − index) ÷ index × 100; `null`, wenn es keinen aktuellen Trade gibt. |
| perp.contracts[].basis_last_reason | string|null | — | Warum `basis_last_pct` null ist. |
| perp.contracts[].index_lag_s | number|null | s | Sekunden zwischen dem Mark-Zeitstempel und dem Index-Zeitstempel der Zeile. |
| perp.contracts[].oi_usd | number|null | USD | Open Interest des Kontrakts, einseitig gezählt; als Gewicht verwendet. |
| perp.contracts[].vol_usd_24h | number|null | USD | 24h-Nominalvolumen des Kontrakts; als Gewicht verwendet. |
| perp.contracts[].primary | boolean | — | True für den Kontrakt, der seine Börse in Median und Mittelwert repräsentiert. |
| perp.contracts[].in_aggregate | boolean | — | True, wenn die Zeile die Einbeziehungsregeln erfüllt hat. |
| perp.contracts[].excluded_reason | string|null | — | Warum die Zeile nicht im Aggregat enthalten ist. |
| perp.contracts[].last_ts | number|null | ms | Zeitpunkt des letzten Trades. |
| perp.contracts[].observed_at | number|null | ms | Von der Quelle für die Daten angegebener Zeitstempel. |
| perp.contracts[].received_at | number | ms | Zeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat. |
| perp.contracts[].age_s | number | s | Sekunden seit dem Empfang der Zeile. |
| spot_perp | object | — | Perpetual-Preis gegenüber dem Spot-Preis derselben Börse. |
| spot_perp.unit | string | — | Einheit der Basiswerte (Prozent). |
| spot_perp.aggregate | object | — | Börsenübergreifendes Aggregat des Abschnitts. |
| spot_perp.aggregate.oi_weighted_pct | number | % | Mit dem Open Interest gewichtete Basis; Zeilen ohne OI-Gewicht bleiben unberücksichtigt. |
| spot_perp.aggregate.oi_weight_usd | number | USD | Summe der verwendeten Open-Interest-Gewichte. |
| spot_perp.aggregate.n_oi_weighted | number | — | Zeilen, die ein OI-Gewicht hatten. |
| spot_perp.aggregate.vol_weighted_pct | number | % | Mit dem 24h-Nominalvolumen gewichtete Basis. |
| spot_perp.aggregate.vol_weight_usd | number | USD | Summe der verwendeten Volumengewichte. |
| spot_perp.aggregate.n_vol_weighted | number | — | Zeilen, die ein Volumengewicht hatten. |
| spot_perp.aggregate.median_pct | number | % | Median der Basis über einen Hauptkontrakt je Börse. |
| spot_perp.aggregate.mean_pct | number | % | Einfacher Mittelwert über dieselbe Menge wie beim Median. |
| spot_perp.aggregate.n_exchanges | number | — | Börsen im Aggregat. |
| spot_perp.aggregate.n_contracts | number | — | Kontrakte im Aggregat. |
| spot_perp.aggregate.min | object | — | Börse und Kontrakt mit der niedrigsten Basis. |
| spot_perp.aggregate.min.exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| spot_perp.aggregate.min.symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. |
| spot_perp.aggregate.min.basis_pct | number | % | (mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median. |
| spot_perp.aggregate.max | object | — | Börse und Kontrakt mit der höchsten Basis. |
| spot_perp.aggregate.max.exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| spot_perp.aggregate.max.symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. |
| spot_perp.aggregate.max.basis_pct | number | % | (mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median. |
| spot_perp.pairs | array | — | Eine Zeile je Perpetual-/Spot-Paar derselben Börse. |
| spot_perp.pairs[] | object | — | Eine Zeile je Perpetual-/Spot-Paar derselben Börse. |
| spot_perp.pairs[].exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| spot_perp.pairs[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. |
| spot_perp.pairs[].spot_symbol | string | — | Spot-Markt, der als Spot-Leg verwendet wird. |
| spot_perp.pairs[].quote | string | — | Kurswährung des Kontrakts. |
| spot_perp.pairs[].spot_mult | number | — | Faktor, der auf den Spot-Preis angewendet wird, damit beide Legs dieselbe Menge notieren. |
| spot_perp.pairs[].futures_price | number|null | — | Verwendeter Perpetual-Preis; siehe `price_kind`. |
| spot_perp.pairs[].price_kind | string|null | — | Welcher Perpetual-Preis verwendet wurde: `last` oder `mark`. |
| spot_perp.pairs[].spot_price | number | — | Letzter Spot-Preis, nach Anwendung von `spot_mult`. |
| spot_perp.pairs[].basis_pct | number|null | % | (mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median. |
| spot_perp.pairs[].basis_last_pct | number|null | % | (last − index) ÷ index × 100; `null`, wenn es keinen aktuellen Trade gibt. |
| spot_perp.pairs[].basis_mark_pct | number|null | % | (mark − spot) ÷ spot × 100. |
| spot_perp.pairs[].leg_gap_s | number | s | Sekunden zwischen den Zeitstempeln der beiden Legs. |
| spot_perp.pairs[].spot_time_kind | string | — | Was der Spot-Zeitstempel angibt (Handelszeit oder Empfangszeit). |
| spot_perp.pairs[].spot_vol_24h | number|null | — | 24h-Umsatz des Spot-Markts, in dessen Kurswährung. |
| spot_perp.pairs[].oi_usd | number|null | USD | Open Interest des Kontrakts, einseitig gezählt; als Gewicht verwendet. |
| spot_perp.pairs[].vol_usd_24h | number|null | USD | 24h-Nominalvolumen des Kontrakts; als Gewicht verwendet. |
| spot_perp.pairs[].primary | boolean | — | True für den Kontrakt, der seine Börse in Median und Mittelwert repräsentiert. |
| spot_perp.pairs[].in_aggregate | boolean | — | True, wenn die Zeile die Einbeziehungsregeln erfüllt hat. |
| spot_perp.pairs[].excluded_reason | string|null | — | Warum die Zeile nicht im Aggregat enthalten ist. |
| spot_perp.pairs[].received_at | number | ms | Zeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat. |
| spot_perp.pairs[].spot_received_at | number | ms | Zeitpunkt, zu dem das Spot-Leg empfangen wurde. |
| delivery | object | — | Basis der Terminkontrakte mit Fälligkeit. |
| delivery.unit | string | — | Einheit der Basiswerte (Prozent). |
| delivery.contracts | array | — | Eine Zeile je Kontrakt. |
| delivery.contracts[] | object | — | Eine Zeile je Kontrakt. |
| delivery.contracts[].exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| delivery.contracts[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. |
| delivery.contracts[].native_symbol | string | — | Kontraktsymbol in der Schreibweise der Börse. |
| delivery.contracts[].quote | string | — | Kurswährung des Kontrakts. |
| delivery.contracts[].margin_type | string | — | Margin-Typ des Kontrakts (zum Beispiel USDT-marginiert, coin-marginiert). |
| delivery.contracts[].expiry_ts | number | ms | Verfallszeitpunkt des Terminkontrakts mit Fälligkeit. |
| delivery.contracts[].days_to_expiry | number | days | Tage bis zum Verfall. |
| delivery.contracts[].mark_price | number | — | Von der Börse veröffentlichter Mark-Preis. |
| delivery.contracts[].last_price | number|null | — | Zuletzt gehandelter Preis. |
| delivery.contracts[].index_price | number | — | Von der Börse veröffentlichter Indexpreis. |
| delivery.contracts[].index_kind | string | — | Art des Index: `exchange_index`, `oracle` oder eine andere Art, die angezeigt, aber nicht aggregiert wird. |
| delivery.contracts[].basis_pct | number | % | (mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median. |
| delivery.contracts[].annualized_pct | number|null | % per year | basis_pct × 365 ÷ Tage bis zum Verfall, einfache Verzinsung; `null` innerhalb des letzten Tages. |
| delivery.contracts[].basis_reason | null | — | Warum `basis_pct` null ist. |
| delivery.contracts[].index_lag_s | number | s | Sekunden zwischen dem Mark-Zeitstempel und dem Index-Zeitstempel der Zeile. |
| delivery.contracts[].basis_last_pct | number|null | % | (last − index) ÷ index × 100; `null`, wenn es keinen aktuellen Trade gibt. |
| delivery.contracts[].annualized_last_pct | number|null | % per year | Annualisierte Basis auf Grundlage des zuletzt gehandelten Preises. |
| delivery.contracts[].spot_symbol | string|null | — | Spot-Markt, der als Spot-Leg verwendet wird. |
| delivery.contracts[].spot_price | number|null | — | Letzter Spot-Preis, nach Anwendung von `spot_mult`. |
| delivery.contracts[].spot_price_kind | string|null | — | Welcher Futures-Preis mit dem Spot-Preis verglichen wurde. |
| delivery.contracts[].basis_spot_pct | number|null | % | (futures − Spot derselben Börse) ÷ spot × 100. |
| delivery.contracts[].annualized_spot_pct | number|null | % per year | Annualisierte Basis gegenüber dem Spot-Preis derselben Börse. |
| delivery.contracts[].annualized_reason | string|null | — | Warum der annualisierte Wert null ist (zum Beispiel `expiry_lt_1d`). |
| delivery.contracts[].oi_usd | number|null | USD | Open Interest des Kontrakts, einseitig gezählt; als Gewicht verwendet. |
| delivery.contracts[].vol_usd_24h | number|null | USD | 24h-Nominalvolumen des Kontrakts; als Gewicht verwendet. |
| delivery.contracts[].last_ts | number|null | ms | Zeitpunkt des letzten Trades. |
| delivery.contracts[].observed_at | number|null | ms | Von der Quelle für die Daten angegebener Zeitstempel. |
| delivery.contracts[].received_at | number | ms | Zeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat. |
| delivery.contracts[].age_s | number | s | Sekunden seit dem Empfang der Zeile. |
| coverage | object | — | Was in den Zahlen enthalten ist und was nicht. Vergleichen Sie dies, bevor Sie Summen mit einer anderen Quelle vergleichen. |
| coverage.included_exchanges | array | — | Quellen, deren aktuelle Daten einbezogen sind. |
| coverage.included_exchanges[] | string | — | Quellen, deren aktuelle Daten einbezogen sind. |
| coverage.unavailable | array | — | Quellen, die nicht einbezogen werden konnten, jeweils mit Begründung. Sie werden nie als 0 gezählt. |
| coverage.unavailable[] | object | — | Quellen, die nicht einbezogen werden konnten, jeweils mit Begründung. Sie werden nie als 0 gezählt. |
| coverage.unavailable[].exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| coverage.unavailable[].reason | string | — | Maschinenlesbarer Begründungscode. |
| coverage.unavailable[].detail | string | — | Für Menschen lesbare Erläuterung der Begründung. |
| coverage.stale_excluded | array | — | Zeilen, die unberücksichtigt bleiben, weil ihre letzte Aktualisierung außerhalb des Aktualitätsfensters liegt. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde |
| coverage.missing_fields | array | — | Börsen, die einen der Preise nicht veröffentlichen. |
| coverage.excluded_from_aggregate | array | — | Zeilen, die angezeigt werden, aber im Aggregat unberücksichtigt bleiben, jeweils mit Begründung. |
| coverage.excluded_from_aggregate[] | object | — | Zeilen, die angezeigt werden, aber im Aggregat unberücksichtigt bleiben, jeweils mit Begründung. |
| coverage.excluded_from_aggregate[].exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| coverage.excluded_from_aggregate[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. |
| coverage.excluded_from_aggregate[].section | string | — | Abschnitt, zu dem die Zeile gehört. |
| coverage.excluded_from_aggregate[].reason | string | — | Maschinenlesbarer Begründungscode. |
| coverage.stock_excluded | array | — | Aktien-Perpetual-Kontrakte, die denselben Ticker tragen und entfernt wurden. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde |
| coverage.dropped_delisted_rows | number | — | Zeilen, die verworfen wurden, weil der Kontrakt nicht mehr aktualisiert wird. |
| coverage.delivery_unavailable | array | — | Börsen, deren Terminkontrakte mit Fälligkeit nicht erhoben werden. |
| coverage.delivery_unavailable[] | object | — | Börsen, deren Terminkontrakte mit Fälligkeit nicht erhoben werden. |
| coverage.delivery_unavailable[].exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| coverage.delivery_unavailable[].reason | string | — | Maschinenlesbarer Begründungscode. |
| coverage.delivery_unavailable[].detail | string | — | Für Menschen lesbare Erläuterung der Begründung. |
| method | object | — | Klartextangabe der für diese Antwort verwendeten Formeln, ein Eintrag je Feld. |
| method.perp.basis_pct | string | — | Formelhinweis zu `perp.basis_pct`, Klartext. |
| method.perp.basis_last_pct | string | — | Formelhinweis zu `perp.basis_last_pct`, Klartext. |
| method.perp.aggregate.oi_weighted_pct | string | — | Formelhinweis zu `perp.aggregate.oi_weighted_pct`, Klartext. |
| method.perp.aggregate.vol_weighted_pct | string | — | Formelhinweis zu `perp.aggregate.vol_weighted_pct`, Klartext. |
| method.perp.aggregate.median_pct | string | — | Formelhinweis zu `perp.aggregate.median_pct`, Klartext. |
| method.perp.aggregate.inclusion | string | — | Formelhinweis zu `perp.aggregate.inclusion`, Klartext. |
| method.spot_perp.basis_pct | string | — | Formelhinweis zu `spot_perp.basis_pct`, Klartext. |
| method.spot_perp.aggregate.inclusion | string | — | Formelhinweis zu `spot_perp.aggregate.inclusion`, Klartext. |
| method.delivery.basis_pct | string | — | Formelhinweis zu `delivery.basis_pct`, Klartext. |
| method.delivery.annualized_pct | string | — | Formelhinweis zu `delivery.annualized_pct`, Klartext. |
| method.index_lag_s | string | — | Formelhinweis zu `index_lag_s`, Klartext. |
| method.multiplier | string | — | Formelhinweis zu `multiplier`, Klartext. |
| meta | object | — | Datenherkunft und Aktualität dieser Antwort. |
| meta.schema | string | — | Schema-ID dieser Antwort. Sie ändert sich nur, wenn ein bestehendes Feld seine Bedeutung oder seinen Typ ändert. |
| meta.source | array | — | Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden. |
| meta.source[] | object | — | Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden. |
| meta.source[].exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| meta.source[].endpoint | string | — | Öffentlicher Endpunkt der Quelle, den der Collector liest (zur Datenherkunft angegeben; Clients rufen ihn nie auf). |
| meta.observed_at | number | ms | Von der Quelle für die Daten angegebener Zeitstempel. |
| meta.received_at | number | ms | Zeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat. |
| meta.fetched_at | number | ms | Zeitpunkt, zu dem diese Antwort zusammengestellt wurde. |
| meta.window | string | — | Zeitfenster, das die Zahlen abdecken. |
| meta.quality | string | — | FRESH, PARTIAL, STALE, BROKEN oder UNAVAILABLE, beurteilt anhand der Datenzeitstempel und der Abdeckung. |
| meta.is_stale | boolean | — | True, wenn die Daten älter als ihr Aktualitätsfenster sind. |
| meta.cache_ttl_s | number | s | Cache-Lebensdauer dieser Antwort. |
| meta.fallback | string | — | Was der Endpunkt zurückgibt, wenn der Collector oder eine Quelle ausfällt. |
| meta.collector_heartbeat_age_s | number | s | Sekunden, seit der Collector zuletzt gemeldet hat, dass er läuft. |
| coverage.missing_fields[] | object | — | Börsen, die einen der Preise nicht veröffentlichen. |
| coverage.missing_fields[].exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| coverage.missing_fields[].symbol | string | — | Kontraktsymbol in der CoinBoss-Speicherform. |
| coverage.missing_fields[].missing | string | — | Preis, den die Börse nicht veröffentlicht (`mark` oder `index`). |
Erzeugt 2026-11-11 23:00 UTC aus 4 echten Antworten.
Beispielantwort
/api/sd/basis?coin=BTC · Echte Antwort, erfasst 2026-11-13 03:52:48 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: meta.source hatte 20 Elemente; perp.contracts hatte 37 Elemente; spot_perp.pairs hatte 22 Elemente; delivery.contracts hatte 53 Elemente; coverage.unavailable hatte 4 Elemente; coverage.included_exchanges hatte 20 Elemente.
- "success"true
- "schema""coinboss.sd.basis/1"
- "now"1794541956692
- "coin""BTC"
- "perp"
- "unit""percent"
- "aggregate"
- "contracts"
- "spot_perp"
- "unit""percent"
- "aggregate"
- "pairs"
- "delivery"
- "unit""percent"
- "contracts"
- "coverage"
- "included_exchanges"
- "unavailable"
- "stale_excluded"
- "missing_fields"
- "excluded_from_aggregate"
- "stock_excluded"
- "dropped_delisted_rows"0
- "delivery_unavailable"
- "method"
- "perp.basis_pct""(mark_price - index_price) / index_price * 100, percent; mark and index are both published by the same exchange for that…"
- "perp.basis_last_pct""(last_price - index_price) / index_price * 100; null when the exchange gives no last-trade price or the last trade is mo…"
- "perp.aggregate.oi_weighted_pct""sum(basis_pct * oi_usd) / sum(oi_usd) over all included perpetual contracts that have an open-interest weight; oi_usd fr…"
- "perp.aggregate.vol_weighted_pct""same with 24h notional volume (market_tickers.volume_usd / sd_contract_latest.vol_usd_24h, <= 1 h old) as weight"
- "perp.aggregate.median_pct""median of basis_pct over one primary contract per exchange (largest OI, then volume, then USDT-margined); mean_pct is th…"
- "perp.aggregate.inclusion""row is fresh (<= 180 s), basis_pct is not null, index_kind is exchange_index or oracle, the contract traded within 24 h …"
- "spot_perp.basis_pct""(perp last_price, or mark_price when last is unusable - spot last price * spot_mult) / (spot last price * spot_mult) * 1…"
- "spot_perp.aggregate.inclusion""as perp, plus spot 24h turnover >= 10000 (quote currency) when the exchange reports it"
- "delivery.basis_pct""(F - S) / S * 100 with F = mark_price and S = the exchange index price of the underlying; basis_last_pct uses F = last_p…"
- "delivery.annualized_pct""basis_pct * 365 / days_to_expiry, simple (not compounded); null when days_to_expiry < 1; days_to_expiry = (expiry_ts - p…"
- "index_lag_s""seconds between the mark timestamp and the index timestamp of the row; 0 when the exchange returns both in one response;…"
- "multiplier""contract units per coin (1000PEPE, kPEPE = 1000); mark and index carry the same multiplier so basis_pct is unaffected; s…"
- "meta"
- "schema""coinboss.sd.basis/1"
- "source"
- "observed_at"1794539247345
- "received_at"1794539247425
- "fetched_at"1794541956692
- "window""latest"
- "quality""STALE"
- "is_stale"true
- "cache_ttl_s"20
- "fallback""rows older than 180 s are excluded; if no exchange is fresh the last stored rows (<= 1 h old) are served with is_stale=t…"
- "collector_heartbeat_age_s"2759
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 | 28 ms | Bestanden STALE |
| coin=SOL | 200 | 26 ms | Bestanden STALE |
| coin=PEPE | 200 | 26 ms | Bestanden STALE |
| — | 400 | 2 ms | Bestanden liefert den erwarteten Fehler |
Geprüft 2026-11-13 03:28:06 UTC
Details
- Authentifizierung
- Keine. Öffentlicher Endpunkt.
- Rate-Limit
- 1200 Anfragen pro Minute und IP
- Server-Cache
- 20s
- Edge-Micro-Cache
- 10s
- Aktualisierungsintervall
- Collector-Durchlauf alle 60 Sekunden; eine Zeile gilt 180 Sekunden lang als aktuell. Stündliche Snapshots speisen die Historie.
- Zeitfenster
- Letzter Wert je Kontrakt.
- Datenquellen
- Mark-Preis, Indexpreis und letzter Preis, veröffentlicht von 21 Derivatebörsen, dazu der Spot-Preis derselben Börse, von CoinBoss erhoben und gespeichert (sd_px_latest, sd_px_hourly).
- Börsenabdeckung
- 21 Börsen. Börsen, die keinen Index- oder Mark-Preis veröffentlichen, sind unter `coverage.unavailable` aufgeführt; Zeilen, deren zwei Preis-Legs mehr als 60 Sekunden auseinanderliegen, liefern `null`. Zeilen, die im Aggregat unberücksichtigt bleiben, sind mit Begründung unter `coverage.excluded_from_aggregate` aufgeführt.
- Paginierung
- Keine Paginierung.
- Sortierung
- Kontrakte mit dem größten Open Interest zuerst.
- Einheiten
- All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
- Methode
- Perpetual: basis_pct = (mark − index) ÷ index × 100. Spot-perp: (perpetual price − spot price) ÷ spot price × 100, same exchange and quote currency. Delivery: basis_pct = (futures − index) ÷ index × 100; annualized_pct = basis_pct × 365 ÷ days to expiry (simple interest; `null` inside the last day). Aggregates use one primary contract per exchange; a row enters only if it is fresh, traded within 24 hours and |basis| ≤ 10 %.
- 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
Der Endpunkt meldet die Datenqualität STALE
Verfügbarkeit, letzte 30 Tage
100 % von 406 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/basisBeeinträchtigtstring — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.
https://www.coinboss.com/api/sd/basis?coin=BTCMehr in dieser Kategorie
- Futures-Basis (alle Börsen) /api/sd/basis
- Basis-Historie (stündlich) /api/sd/basis/history
- Coin-Ranking nach Basis /api/sd/basis/rank
- Liste der Futures-Spot-Basis /api/derivatives/basis
- Täglicher BTC-Preisspread zwischen Coinbase und Kraken /api/p3/cb-kr-spread
- Coinbase-Bitcoin-Premium-Index /api/p3/coinbase-premium
- Premium-Index-Liste für Perpetual-Kontrakte /api/p3/premium-index
- Premium-Index-Historie für einen Coin /api/p3/premium-index/history
- Premium-Index-Kerzen /api/p3/premium-index/klines
- USDT-OTC-Prämie gegenüber Fiat-Wechselkursen /api/usdt-premium
- Vollständige Liste der Futures-Spot-Basis /api/basis/list