24h Volumen—Open Interest—24h Liquidationen$1.36B24h Long/Short—BTC-Dominanz—ETH-Dominanz—
App
Sprache ▾
€ EUR ▾
/api/sd/basis/rank
GETVerfügbarFRESH

Coin-Ranking nach Basis

Coin-Ranking nach dem börsenübergreifenden Median der Basis, mit Mittelwert, OI-gewichteter Basis, Open Interest und den Börsen mit dem niedrigsten und dem höchsten Wert.

GET/api/sd/basis/rank

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
kindstringOptionalperpperp, spot_perp`perp`: Mark-Preis gegenüber dem Indexpreis derselben Börse. `spot_perp`: Perpetual-Preis gegenüber dem Spot-Preis derselben Börse.
sortstringOptionalbasis_descbasis_desc, basis_asc, abs_descSortierschlüssel: höchste, niedrigste oder betragsmäßig größte Median-Basis zuerst.
limitintegerOptional50≥ 1 · ≤ 200Anzahl der Zeilen.
min_exchangesintegerOptional3≥ 1 · ≤ 20Nur Coins mit einer Basis an mindestens so vielen Börsen.

Beispielanfrage

curl -s "https://www.coinboss.com/api/sd/basis/rank"

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.
kindstring—`perp` oder `spot_perp`.
sortstring—Angewendete Sortierreihenfolge.
limitnumber—Angewendetes Zeilenlimit.
min_exchangesnumber—Angewendete Mindestanzahl an Börsen.
totalnumber—Vor Anwendung von `limit` verfügbare Zeilen.
countnumber—Zurückgegebene Zeilen.
dataarray—Eine Zeile je Coin.
data[]object—Eine Zeile je Coin.
data[].ranknumber—Position im Ranking; `null`, wenn die Zeile keinen Wert für das Ranking hat.
data[].coinstring—Coin-Symbol (Großbuchstaben).
data[].basis_pctnumber%(mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median.
data[].mean_pctnumber%Einfacher Mittelwert über dieselbe Menge wie beim Median.
data[].oi_weighted_pctnumber%Mit dem Open Interest gewichtete Basis; Zeilen ohne OI-Gewicht bleiben unberücksichtigt.
data[].oi_usdnumberUSDOpen Interest des Kontrakts, einseitig gezählt; als Gewicht verwendet.
data[].n_exchangesnumber—Börsen im Aggregat.
data[].n_contractsnumber—Kontrakte im Aggregat.
data[].minobject—Börse und Kontrakt mit der niedrigsten Basis.
data[].min.exchangestring—Börsenkennung (Kleinbuchstaben).
data[].min.symbolstring—Kontraktsymbol in der CoinBoss-Speicherform.
data[].min.basis_pctnumber%(mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median.
data[].maxobject—Börse und Kontrakt mit der höchsten Basis.
data[].max.exchangestring—Börsenkennung (Kleinbuchstaben).
data[].max.symbolstring—Kontraktsymbol in der CoinBoss-Speicherform.
data[].max.basis_pctnumber%(mark − index) ÷ index × 100 für Perpetual-Kontrakte und Terminkontrakte mit Fälligkeit; in Ranglisten der börsenübergreifende Median.
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
methodobject—Klartextangabe der für diese Antwort verwendeten Formeln, ein Eintrag je Feld.
method.basis_pctstring—Formelhinweis zu `basis_pct`, Klartext.
method.oi_weighted_pctstring—Formelhinweis zu `oi_weighted_pct`, Klartext.
method.inclusionstring—Formelhinweis zu `inclusion`, Klartext.
method.coinstring—Formelhinweis zu `coin`, 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.

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

Beispielantwort

/api/sd/basis/rank · Echte Antwort, erfasst 2026-11-13 01:42:46 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: data hatte 50 Elemente; meta.source hatte 18 Elemente; coverage.unavailable hatte 5 Elemente; coverage.included_exchanges hatte 18 Elemente.

  • {
    • "success": true,
    • "schema": "coinboss.sd.basis/1",
    • "now": 1794534166009,
    • "kind": "perp",
    • "sort": "basis_desc",
    • "limit": 50,
    • "min_exchanges": 3,
    • "total": 730,
    • "count": 50,
    • "data": [
      • { … 10 },
      • { … 10 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 8 ],
      • "unavailable": [ … 2 ],
      • "stale_excluded": []
      },
    • "method": {
      • "basis_pct": "median over exchanges (one primary contract per exchange) of the perpetual mark-vs-index basis, percent; the ranking key",
      • "oi_weighted_pct": "OI-weighted mean over all included contracts of the coin (single-sided OI, <= 3 h old); null when no contract has a weight",
      • "inclusion": "fresh rows only (<= 180 s); same row filters as /api/sd/basis; catalogued stock/ETF perpetuals (stock_contracts) are removed; coins quoted on fewer than min_exc…",
      • "coin": "multiplier contracts are folded into the underlying coin (1000PEPE, kPEPE -> PEPE)"
      },
    • "meta": {
      • "schema": "coinboss.sd.basis/1",
      • "source": [ … 2 ],
      • "observed_at": 1794534153288,
      • "received_at": 1794534153368,
      • "fetched_at": 1794534166009,
      • "window": "latest",
      • "quality": "FRESH",
      • "is_stale": false,
      • "cache_ttl_s": 30,
      • "fallback": "only rows refreshed within 180 s are ranked; when the collector is down the list is empty and quality is STALE",
      • "collector_heartbeat_age_s": 4
      }
    }

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
kind=spot_perp20044 msBestanden FRESH
sort=basis_asc&limit=1020048 msBestanden FRESH
sort=zzz4002 msBestanden liefert den erwarteten Fehler

Geprüft 2026-11-13 01:28:06 UTC

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
30s
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; `limit` begrenzt die Anzahl der Zeilen (max. 200).
Sortierung
Über `sort` gesteuert; der Sortierschlüssel ist der börsenübergreifende Median (`basis_pct`).
Einheiten
All basis values in percent. Prices in the quote currency of the contract (USDT / USDC / USD). `oi_usd` single-sided.
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ügbarGeprüft 2026-11-13 01:42:46 UTCHTTP 20072 msSchema stimmt übereinNeuester Datenpunkt 13s alt

Verfügbarkeit, letzte 30 Tage

100 % von 380 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/basis/rankBeeinträchtigt
Parameter

string · Standard perp — `perp`: mark price against the index price of the same exchange. `spot_perp`: perpetual price against the spot price of the same exchange.

string · Standard basis_desc — Sort key: highest, lowest or largest absolute median basis first.

integer · Standard 50 · min. 1 · max. 200 — Number of rows.

integer · Standard 3 · min. 1 · max. 20 — Only coins with a basis on at least this many exchanges.

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