/api/sd/basis
GETBeeinträchtigtSTALE

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.

GET/api/sd/basis
Beeinträchtigt. Der Endpunkt meldet die Datenqualität STALE

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
coinstringErforderlich——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.

FeldTypEinheitBeschreibung
successboolean—true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`.
schemastring—Schema-ID dieser Antwort. Sie ändert sich nur, wenn ein bestehendes Feld seine Bedeutung oder seinen Typ ändert.
nownumbermsServerzeit beim Erstellen der Antwort.
coinstring—Coin-Symbol (Großbuchstaben).
perpobject—Perpetual-Basis: Mark-Preis gegenüber dem Indexpreis derselben Börse.
perp.unitstring—Einheit der Basiswerte (Prozent).
perp.aggregateobject—Börsenübergreifendes Aggregat des Abschnitts.
perp.aggregate.oi_weighted_pctnumber%Mit dem Open Interest gewichtete Basis; Zeilen ohne OI-Gewicht bleiben unberücksichtigt.
perp.aggregate.oi_weight_usdnumberUSDSumme der verwendeten Open-Interest-Gewichte.
perp.aggregate.n_oi_weightednumber—Zeilen, die ein OI-Gewicht hatten.
perp.aggregate.vol_weighted_pctnumber%Mit dem 24h-Nominalvolumen gewichtete Basis.
perp.aggregate.vol_weight_usdnumberUSDSumme der verwendeten Volumengewichte.
perp.aggregate.n_vol_weightednumber—Zeilen, die ein Volumengewicht hatten.
perp.aggregate.median_pctnumber%Median der Basis über einen Hauptkontrakt je Börse.
perp.aggregate.mean_pctnumber%Einfacher Mittelwert über dieselbe Menge wie beim Median.
perp.aggregate.n_exchangesnumber—Börsen im Aggregat.
perp.aggregate.n_contractsnumber—Kontrakte im Aggregat.
perp.aggregate.minobject—Börse und Kontrakt mit der niedrigsten Basis.
perp.aggregate.min.exchangestring—Börsenkennung (Kleinbuchstaben).
perp.aggregate.min.symbolstring—Kontraktsymbol in der CoinBoss-Speicherform.
perp.aggregate.min.basis_pctnumber%(mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median.
perp.aggregate.maxobject—Börse und Kontrakt mit der höchsten Basis.
perp.aggregate.max.exchangestring—Börsenkennung (Kleinbuchstaben).
perp.aggregate.max.symbolstring—Kontraktsymbol in der CoinBoss-Speicherform.
perp.aggregate.max.basis_pctnumber%(mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median.
perp.aggregate.median_last_pctnumber%Median der Basis zum letzten Preis.
perp.aggregate.n_exchanges_lastnumber—Börsen im Median zum letzten Preis.
perp.aggregate.weightsobject—Woher die Gewichte stammen, ihr Aktualitätsfenster und das Alter des ältesten Gewichts.
perp.aggregate.weights.oiobject—Open Interest.
perp.aggregate.weights.oi.sourcestring—Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden.
perp.aggregate.weights.oi.fresh_window_snumbersEin Gewicht, das älter ist, wird nicht verwendet.
perp.aggregate.weights.oi.oldest_age_snumbersAlter des ältesten verwendeten Gewichts.
perp.aggregate.weights.oi.sidestring—Ob das Open-Interest-Gewicht einseitig gezählt ist.
perp.aggregate.weights.volobject—Volumen.
perp.aggregate.weights.vol.sourcestring—Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden.
perp.aggregate.weights.vol.fresh_window_snumbersEin Gewicht, das älter ist, wird nicht verwendet.
perp.aggregate.weights.vol.oldest_age_snumbersAlter des ältesten verwendeten Gewichts.
perp.contractsarray—Eine Zeile je Kontrakt.
perp.contracts[]object—Eine Zeile je Kontrakt.
perp.contracts[].exchangestring—Börsenkennung (Kleinbuchstaben).
perp.contracts[].symbolstring—Kontraktsymbol in der CoinBoss-Speicherform.
perp.contracts[].native_symbolstring—Kontraktsymbol in der Schreibweise der Börse.
perp.contracts[].quotestring—Kurswährung des Kontrakts.
perp.contracts[].margin_typestring—Margin-Typ des Kontrakts (zum Beispiel USDT-marginiert, coin-marginiert).
perp.contracts[].multipliernumber—Coins je notierter Einheit (1000 bei Kontrakten nach dem Muster `1000PEPE`). Die Basis bleibt davon unberührt.
perp.contracts[].mark_pricenumber|null—Von der Börse veröffentlichter Mark-Preis.
perp.contracts[].index_pricenumber|null—Von der Börse veröffentlichter Indexpreis.
perp.contracts[].last_pricenumber|null—Zuletzt gehandelter Preis.
perp.contracts[].index_kindstring|null—Art des Index: `exchange_index`, `oracle` oder eine andere Art, die angezeigt, aber nicht aggregiert wird.
perp.contracts[].basis_pctnumber|null%(mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median.
perp.contracts[].basis_absnumber|null—mark − index, in der Kurswährung.
perp.contracts[].basis_last_pctnumber|null%(last − index) ÷ index × 100; `null`, wenn es keinen aktuellen Trade gibt.
perp.contracts[].basis_last_reasonstring|null—Warum `basis_last_pct` null ist.
perp.contracts[].index_lag_snumber|nullsSekunden zwischen dem Mark-Zeitstempel und dem Index-Zeitstempel der Zeile.
perp.contracts[].oi_usdnumber|nullUSDOpen Interest des Kontrakts, einseitig gezählt; als Gewicht verwendet.
perp.contracts[].vol_usd_24hnumber|nullUSD24h-Nominalvolumen des Kontrakts; als Gewicht verwendet.
perp.contracts[].primaryboolean—True für den Kontrakt, der seine Börse in Median und Mittelwert repräsentiert.
perp.contracts[].in_aggregateboolean—True, wenn die Zeile die Einbeziehungsregeln erfüllt hat.
perp.contracts[].excluded_reasonstring|null—Warum die Zeile nicht im Aggregat enthalten ist.
perp.contracts[].last_tsnumber|nullmsZeitpunkt des letzten Trades.
perp.contracts[].observed_atnumber|nullmsVon der Quelle für die Daten angegebener Zeitstempel.
perp.contracts[].received_atnumbermsZeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat.
perp.contracts[].age_snumbersSekunden seit dem Empfang der Zeile.
spot_perpobject—Perpetual-Preis gegenüber dem Spot-Preis derselben Börse.
spot_perp.unitstring—Einheit der Basiswerte (Prozent).
spot_perp.aggregateobject—Börsenübergreifendes Aggregat des Abschnitts.
spot_perp.aggregate.oi_weighted_pctnumber%Mit dem Open Interest gewichtete Basis; Zeilen ohne OI-Gewicht bleiben unberücksichtigt.
spot_perp.aggregate.oi_weight_usdnumberUSDSumme der verwendeten Open-Interest-Gewichte.
spot_perp.aggregate.n_oi_weightednumber—Zeilen, die ein OI-Gewicht hatten.
spot_perp.aggregate.vol_weighted_pctnumber%Mit dem 24h-Nominalvolumen gewichtete Basis.
spot_perp.aggregate.vol_weight_usdnumberUSDSumme der verwendeten Volumengewichte.
spot_perp.aggregate.n_vol_weightednumber—Zeilen, die ein Volumengewicht hatten.
spot_perp.aggregate.median_pctnumber%Median der Basis über einen Hauptkontrakt je Börse.
spot_perp.aggregate.mean_pctnumber%Einfacher Mittelwert über dieselbe Menge wie beim Median.
spot_perp.aggregate.n_exchangesnumber—Börsen im Aggregat.
spot_perp.aggregate.n_contractsnumber—Kontrakte im Aggregat.
spot_perp.aggregate.minobject—Börse und Kontrakt mit der niedrigsten Basis.
spot_perp.aggregate.min.exchangestring—Börsenkennung (Kleinbuchstaben).
spot_perp.aggregate.min.symbolstring—Kontraktsymbol in der CoinBoss-Speicherform.
spot_perp.aggregate.min.basis_pctnumber%(mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median.
spot_perp.aggregate.maxobject—Börse und Kontrakt mit der höchsten Basis.
spot_perp.aggregate.max.exchangestring—Börsenkennung (Kleinbuchstaben).
spot_perp.aggregate.max.symbolstring—Kontraktsymbol in der CoinBoss-Speicherform.
spot_perp.aggregate.max.basis_pctnumber%(mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median.
spot_perp.pairsarray—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[].exchangestring—Börsenkennung (Kleinbuchstaben).
spot_perp.pairs[].symbolstring—Kontraktsymbol in der CoinBoss-Speicherform.
spot_perp.pairs[].spot_symbolstring—Spot-Markt, der als Spot-Leg verwendet wird.
spot_perp.pairs[].quotestring—Kurswährung des Kontrakts.
spot_perp.pairs[].spot_multnumber—Faktor, der auf den Spot-Preis angewendet wird, damit beide Legs dieselbe Menge notieren.
spot_perp.pairs[].futures_pricenumber|null—Verwendeter Perpetual-Preis; siehe `price_kind`.
spot_perp.pairs[].price_kindstring|null—Welcher Perpetual-Preis verwendet wurde: `last` oder `mark`.
spot_perp.pairs[].spot_pricenumber—Letzter Spot-Preis, nach Anwendung von `spot_mult`.
spot_perp.pairs[].basis_pctnumber|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_pctnumber|null%(last − index) ÷ index × 100; `null`, wenn es keinen aktuellen Trade gibt.
spot_perp.pairs[].basis_mark_pctnumber|null%(mark − spot) ÷ spot × 100.
spot_perp.pairs[].leg_gap_snumbersSekunden zwischen den Zeitstempeln der beiden Legs.
spot_perp.pairs[].spot_time_kindstring—Was der Spot-Zeitstempel angibt (Handelszeit oder Empfangszeit).
spot_perp.pairs[].spot_vol_24hnumber|null—24h-Umsatz des Spot-Markts, in dessen Kurswährung.
spot_perp.pairs[].oi_usdnumber|nullUSDOpen Interest des Kontrakts, einseitig gezählt; als Gewicht verwendet.
spot_perp.pairs[].vol_usd_24hnumber|nullUSD24h-Nominalvolumen des Kontrakts; als Gewicht verwendet.
spot_perp.pairs[].primaryboolean—True für den Kontrakt, der seine Börse in Median und Mittelwert repräsentiert.
spot_perp.pairs[].in_aggregateboolean—True, wenn die Zeile die Einbeziehungsregeln erfüllt hat.
spot_perp.pairs[].excluded_reasonstring|null—Warum die Zeile nicht im Aggregat enthalten ist.
spot_perp.pairs[].received_atnumbermsZeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat.
spot_perp.pairs[].spot_received_atnumbermsZeitpunkt, zu dem das Spot-Leg empfangen wurde.
deliveryobject—Basis der Terminkontrakte mit Fälligkeit.
delivery.unitstring—Einheit der Basiswerte (Prozent).
delivery.contractsarray—Eine Zeile je Kontrakt.
delivery.contracts[]object—Eine Zeile je Kontrakt.
delivery.contracts[].exchangestring—Börsenkennung (Kleinbuchstaben).
delivery.contracts[].symbolstring—Kontraktsymbol in der CoinBoss-Speicherform.
delivery.contracts[].native_symbolstring—Kontraktsymbol in der Schreibweise der Börse.
delivery.contracts[].quotestring—Kurswährung des Kontrakts.
delivery.contracts[].margin_typestring—Margin-Typ des Kontrakts (zum Beispiel USDT-marginiert, coin-marginiert).
delivery.contracts[].expiry_tsnumbermsVerfallszeitpunkt des Terminkontrakts mit Fälligkeit.
delivery.contracts[].days_to_expirynumberdaysTage bis zum Verfall.
delivery.contracts[].mark_pricenumber—Von der Börse veröffentlichter Mark-Preis.
delivery.contracts[].last_pricenumber|null—Zuletzt gehandelter Preis.
delivery.contracts[].index_pricenumber—Von der Börse veröffentlichter Indexpreis.
delivery.contracts[].index_kindstring—Art des Index: `exchange_index`, `oracle` oder eine andere Art, die angezeigt, aber nicht aggregiert wird.
delivery.contracts[].basis_pctnumber%(mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median.
delivery.contracts[].annualized_pctnumber|null% per yearbasis_pct × 365 ÷ Tage bis zum Verfall, einfache Verzinsung; `null` innerhalb des letzten Tages.
delivery.contracts[].basis_reasonnull—Warum `basis_pct` null ist.
delivery.contracts[].index_lag_snumbersSekunden zwischen dem Mark-Zeitstempel und dem Index-Zeitstempel der Zeile.
delivery.contracts[].basis_last_pctnumber|null%(last − index) ÷ index × 100; `null`, wenn es keinen aktuellen Trade gibt.
delivery.contracts[].annualized_last_pctnumber|null% per yearAnnualisierte Basis auf Grundlage des zuletzt gehandelten Preises.
delivery.contracts[].spot_symbolstring|null—Spot-Markt, der als Spot-Leg verwendet wird.
delivery.contracts[].spot_pricenumber|null—Letzter Spot-Preis, nach Anwendung von `spot_mult`.
delivery.contracts[].spot_price_kindstring|null—Welcher Futures-Preis mit dem Spot-Preis verglichen wurde.
delivery.contracts[].basis_spot_pctnumber|null%(futures − Spot derselben Börse) ÷ spot × 100.
delivery.contracts[].annualized_spot_pctnumber|null% per yearAnnualisierte Basis gegenüber dem Spot-Preis derselben Börse.
delivery.contracts[].annualized_reasonstring|null—Warum der annualisierte Wert null ist (zum Beispiel `expiry_lt_1d`).
delivery.contracts[].oi_usdnumber|nullUSDOpen Interest des Kontrakts, einseitig gezählt; als Gewicht verwendet.
delivery.contracts[].vol_usd_24hnumber|nullUSD24h-Nominalvolumen des Kontrakts; als Gewicht verwendet.
delivery.contracts[].last_tsnumber|nullmsZeitpunkt des letzten Trades.
delivery.contracts[].observed_atnumber|nullmsVon der Quelle für die Daten angegebener Zeitstempel.
delivery.contracts[].received_atnumbermsZeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat.
delivery.contracts[].age_snumbersSekunden seit dem Empfang der Zeile.
coverageobject—Was in den Zahlen enthalten ist und was nicht. Vergleichen Sie dies, bevor Sie Summen mit einer anderen Quelle vergleichen.
coverage.included_exchangesarray—Quellen, deren aktuelle Daten einbezogen sind.
coverage.included_exchanges[]string—Quellen, deren aktuelle Daten einbezogen sind.
coverage.unavailablearray—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[].exchangestring—Börsenkennung (Kleinbuchstaben).
coverage.unavailable[].reasonstring—Maschinenlesbarer Begründungscode.
coverage.unavailable[].detailstring—Für Menschen lesbare Erläuterung der Begründung.
coverage.stale_excludedarray—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_fieldsarray—Börsen, die einen der Preise nicht veröffentlichen.
coverage.excluded_from_aggregatearray—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[].exchangestring—Börsenkennung (Kleinbuchstaben).
coverage.excluded_from_aggregate[].symbolstring—Kontraktsymbol in der CoinBoss-Speicherform.
coverage.excluded_from_aggregate[].sectionstring—Abschnitt, zu dem die Zeile gehört.
coverage.excluded_from_aggregate[].reasonstring—Maschinenlesbarer Begründungscode.
coverage.stock_excludedarray—Aktien-Perpetual-Kontrakte, die denselben Ticker tragen und entfernt wurden. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde
coverage.dropped_delisted_rowsnumber—Zeilen, die verworfen wurden, weil der Kontrakt nicht mehr aktualisiert wird.
coverage.delivery_unavailablearray—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[].exchangestring—Börsenkennung (Kleinbuchstaben).
coverage.delivery_unavailable[].reasonstring—Maschinenlesbarer Begründungscode.
coverage.delivery_unavailable[].detailstring—Für Menschen lesbare Erläuterung der Begründung.
methodobject—Klartextangabe der für diese Antwort verwendeten Formeln, ein Eintrag je Feld.
method.perp.basis_pctstring—Formelhinweis zu `perp.basis_pct`, Klartext.
method.perp.basis_last_pctstring—Formelhinweis zu `perp.basis_last_pct`, Klartext.
method.perp.aggregate.oi_weighted_pctstring—Formelhinweis zu `perp.aggregate.oi_weighted_pct`, Klartext.
method.perp.aggregate.vol_weighted_pctstring—Formelhinweis zu `perp.aggregate.vol_weighted_pct`, Klartext.
method.perp.aggregate.median_pctstring—Formelhinweis zu `perp.aggregate.median_pct`, Klartext.
method.perp.aggregate.inclusionstring—Formelhinweis zu `perp.aggregate.inclusion`, Klartext.
method.spot_perp.basis_pctstring—Formelhinweis zu `spot_perp.basis_pct`, Klartext.
method.spot_perp.aggregate.inclusionstring—Formelhinweis zu `spot_perp.aggregate.inclusion`, Klartext.
method.delivery.basis_pctstring—Formelhinweis zu `delivery.basis_pct`, Klartext.
method.delivery.annualized_pctstring—Formelhinweis zu `delivery.annualized_pct`, Klartext.
method.index_lag_sstring—Formelhinweis zu `index_lag_s`, Klartext.
method.multiplierstring—Formelhinweis zu `multiplier`, Klartext.
metaobject—Datenherkunft und Aktualität dieser Antwort.
meta.schemastring—Schema-ID dieser Antwort. Sie ändert sich nur, wenn ein bestehendes Feld seine Bedeutung oder seinen Typ ändert.
meta.sourcearray—Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden.
meta.source[]object—Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden.
meta.source[].exchangestring—Börsenkennung (Kleinbuchstaben).
meta.source[].endpointstring—Öffentlicher Endpunkt der Quelle, den der Collector liest (zur Datenherkunft angegeben; Clients rufen ihn nie auf).
meta.observed_atnumbermsVon der Quelle für die Daten angegebener Zeitstempel.
meta.received_atnumbermsZeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat.
meta.fetched_atnumbermsZeitpunkt, zu dem diese Antwort zusammengestellt wurde.
meta.windowstring—Zeitfenster, das die Zahlen abdecken.
meta.qualitystring—FRESH, PARTIAL, STALE, BROKEN oder UNAVAILABLE, beurteilt anhand der Datenzeitstempel und der Abdeckung.
meta.is_staleboolean—True, wenn die Daten älter als ihr Aktualitätsfenster sind.
meta.cache_ttl_snumbersCache-Lebensdauer dieser Antwort.
meta.fallbackstring—Was der Endpunkt zurückgibt, wenn der Collector oder eine Quelle ausfällt.
meta.collector_heartbeat_age_snumbersSekunden, 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[].exchangestring—Börsenkennung (Kleinbuchstaben).
coverage.missing_fields[].symbolstring—Kontraktsymbol in der CoinBoss-Speicherform.
coverage.missing_fields[].missingstring—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": { … 15 },
      • "contracts": [ … 1 ]
      },
    • "spot_perp": {
      • "unit": "percent",
      • "aggregate": { … 12 },
      • "pairs": [ … 1 ]
      },
    • "delivery": {
      • "unit": "percent",
      • "contracts": [ … 1 ]
      },
    • "coverage": {
      • "included_exchanges": [ … 8 ],
      • "unavailable": [ … 1 ],
      • "stale_excluded": [],
      • "missing_fields": [],
      • "excluded_from_aggregate": [ … 1 ],
      • "stock_excluded": [],
      • "dropped_delisted_rows": 0,
      • "delivery_unavailable": [ … 1 ]
      },
    • "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": [ … 1 ],
      • "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.

ParameterHTTPLatenzErgebnis
coin=ETH20028 msBestanden STALE
coin=SOL20026 msBestanden STALE
coin=PEPE20026 msBestanden STALE
—4002 msBestanden 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

BeeinträchtigtGeprüft 2026-11-13 03:52:48 UTCHTTP 2001 msSchema stimmt übereinNeuester Datenpunkt 45m alt

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 →

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/sd/basisBeeinträchtigt
Parameter

string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.

Anfrage-URLhttps://www.coinboss.com/api/sd/basis?coin=BTC
Wählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.