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

Futures-Volumen für einen Coin

Eigene Datenschicht: Futures-Volumen für einen Coin

GET/api/sd/volume

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
coinstringErforderlich——Coin-Symbol; 400, wenn es fehlt. Alias: `base`. Beispiel: BTC

Beispielanfrage

curl -s "https://www.coinboss.com/api/sd/volume?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 }`.
coinstring—Coin-Symbol in Großbuchstaben (zum Beispiel BTC).
nownumbermsServerzeit beim Erstellen der Antwort.
futuresobject—Block oder Wert des Futures-Markts.
futures.total_usdnumberUSD24h-Futures-Volumen über alle Börsen (Nominalwert in USD).
futures.n_exchangesnumber—Anzahl der beitragenden Börsen.
futures.by_exchangearray—Aufschlüsselung je Börse.
futures.by_exchange[]object—Aufschlüsselung je Börse.
futures.by_exchange[].exchangestring—Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`).
futures.by_exchange[].vol_usdnumberUSDVolumen als Nominalwert in USD.
futures.by_exchange[].legacy_usdnumberUSDTeil des Volumens, der aus der Ticker-Menge der USDT-Perpetual-Kontrakte stammt.
futures.by_exchange[].sd_usdnumberUSDTeil, der aus bereits einbezogenen zusätzlichen Kontrakten stammt (USDC, coin-marginiert, Terminkontrakte mit Fälligkeit).
futures.by_exchange[].share_pctnumber%Anteil an der Gesamtsumme.
futures.change_24hobject—24h-Veränderung.
futures.change_24h.pctnumber%Prozentwert.
futures.change_24h.curnumber—Aktueller Wert.
futures.change_24h.prevnumber—Vorheriger Wert (Vergleichsbasis).
futures.change_24h.n_matchednumber—Elemente, die an beiden Enden des Vergleichs vorhanden sind.
futures.change_24h.n_totalnumber—Aktuell vorhandene Elemente.
futures.change_24h.prev_tsnumbermsZeitpunkt des Snapshots der Vergleichsbasis.
futures.change_24h.basisstring—Futures-Preis minus Spot-Preis, oder der Basis-Block.
futures.selfdata_contractsobject—Zusätzliche Kontrakte: was bereits einbezogen ist und was noch aussteht.
futures.selfdata_contracts.included_usdnullUSD24h-Volumen der zusätzlich erhobenen Kontrakte (coin-marginiert, USDC, Terminkontrakte mit Fälligkeit), die bereits in der Futures-Summe enthalten sind; null, solange noch keiner einbezogen ist.
futures.selfdata_contracts.n_includednumbercountAnzahl der zusätzlich erhobenen Kontrakte, die in der Futures-Summe enthalten sind (jene, die über einen eigenen Snapshot von vor etwa 24 Stunden verfügen).
futures.selfdata_contracts.pending_usdnumber|nullUSDSumme der ausstehenden Elemente, nicht in der Gesamtsumme enthalten.
futures.selfdata_contracts.n_pendingnumbercountAnzahl der zusätzlich erhobenen Kontrakte, die noch nicht einbezogen sind, weil ihnen eine eigene Vergleichsbasis von vor 24h fehlt; die größten sind in `pending` aufgeführt.
futures.selfdata_contracts.pendingarray—Erhobene, aber noch nicht einbezogene Elemente.
futures.selfdata_contracts.pending[]object—Erhobene, aber noch nicht einbezogene Elemente.
futures.selfdata_contracts.pending[].exchangestring—Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`).
futures.selfdata_contracts.pending[].symbolstring—Instrumentensymbol in der von CoinBoss normalisierten Form (zum Beispiel BTCUSDT).
futures.selfdata_contracts.pending[].marginstring—Klasse der Margin-Währung.
futures.selfdata_contracts.pending[].contract_typestring—`perpetual` oder `delivery`.
futures.selfdata_contracts.pending[].vol_usdnumberUSDVolumen als Nominalwert in USD.
futures.selfdata_contracts.pending[].reasonstring—Begründungscode.
spotobject—Block oder Wert des Spot-Markts.
spot.total_usdnumberUSD24h-Spot-Volumen über alle Börsen.
spot.n_exchangesnumber—Anzahl der beitragenden Börsen.
spot.asofnumbermsZeitpunkt der neuesten verwendeten Daten.
spot.by_exchangearray—Aufschlüsselung je Börse.
spot.by_exchange[]object—Aufschlüsselung je Börse.
spot.by_exchange[].exchangestring—Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`).
spot.by_exchange[].vol_usdnumberUSDVolumen als Nominalwert in USD.
spot.by_exchange[].quotestring—Für diese Börse einbezogene Kurswährungen.
spot.by_exchange[].tsnumbermsZeitstempel.
spot.by_exchange[].pricenumber—Letzter Preis in der Kurswährung (USD oder USDT, sofern nicht anders angegeben).
spot.by_exchange[].age_snumbersSekunden seit der letzten Aktualisierung dieser Zeile.
spot.by_exchange[].share_pctnumber%Anteil an der Gesamtsumme.
spot.change_24hobject—24h-Veränderung.
spot.change_24h.pctnumber%Prozentwert.
spot.change_24h.curnumber—Aktueller Wert.
spot.change_24h.prevnumber—Vorheriger Wert (Vergleichsbasis).
spot.change_24h.n_matchednumber—Elemente, die an beiden Enden des Vergleichs vorhanden sind.
spot.change_24h.n_totalnumber—Aktuell vorhandene Elemente.
spot.change_24h.prev_tsnumbermsZeitpunkt des Snapshots der Vergleichsbasis.
spot.change_24h.basisstring—Futures-Preis minus Spot-Preis, oder der Basis-Block.
ratiosobject—Volumenverhältnisse: `futures_to_spot` (24h-Futures-Volumen ÷ 24h-Spot-Volumen) und `oi_to_futures_volume`; jeweils null, wenn eine Eingangsgröße fehlt.
ratios.futures_to_spotnumber—Futures-Volumen geteilt durch das Spot-Volumen.
ratios.oi_to_futures_volumenumber—Open Interest geteilt durch das 24h-Futures-Volumen.
methodobject—Klartextangabe der Formeln, die für diese Antwort verwendet wurden.
method.futuresstring—Block oder Wert des Futures-Markts.
method.spotstring—Block oder Wert des Spot-Markts.
method.changestring—Veränderung über den angegebenen Zeitraum.
method.oi_to_futures_volumestring—Klartextdefinition von `ratios.oi_to_futures_volume`: gesamtes Open Interest in USD ÷ 24h-Futures-Volumen in USD.

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

Beispielantwort

/api/sd/volume?coin=BTC · Echte Antwort, erfasst 2026-11-13 03:57:37 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: spot.by_exchange hatte 14 Elemente; futures.by_exchange hatte 23 Elemente; futures.selfdata_contracts.pending hatte 5 Elemente.

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542257033,
    • "futures": {
      • "total_usd": 79049803843.06,
      • "n_exchanges": 23,
      • "by_exchange": [ … 2 ],
      • "change_24h": { … 7 },
      • "selfdata_contracts": { … 5 }
      },
    • "spot": {
      • "total_usd": 7929483908.44,
      • "n_exchanges": 14,
      • "asof": 1794541800000,
      • "by_exchange": [ … 2 ],
      • "change_24h": { … 7 }
      },
    • "ratios": {
      • "futures_to_spot": 9.9691,
      • "oi_to_futures_volume": 0.6197
      },
    • "method": {
      • "futures": "SUM of each exchange 24h quote turnover in USD for this coin's contracts (ticker fresh within 1h); self-collected coin-margined/USDC/delivery contracts are adde…",
      • "spot": "per exchange: 24h quote turnover summed over that exchange's USD/USDT/USDC-quoted spot pairs of the coin (quote = the largest pair); total = SUM over exchanges …",
      • "change": "same-exchange pairing: only exchanges with both a current value and a snapshot ~24h ago enter numerator and denominator",
      • "oi_to_futures_volume": "total open interest (USD) / 24h futures turnover (USD)"
      }
    }

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=ETH20038 msBestanden
coin=SOL20046 msBestanden
coin=ARKM20043 msBestanden
—4001 msBestanden liefert den erwarteten Fehler

Geprüft 2026-11-13 03:57:37 UTC

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
30s
Edge-Micro-Cache
10s
Aktualisierungsintervall
Futures-Ticker alle 60 s (coin-marginierte / USDC- / Terminkontrakte mit Fälligkeit alle 120 s); Spot-Snapshots alle 10 min
Zeitfenster
rollierendes 24-h-Volumen, wie von jeder Börse gemeldet; 24-h-Veränderung gegenüber dem eigenen Archiv von rund 24 h zuvor
Datenquellen
24h-Futures-Volumen aus den eigenen Ticker-Collectoren (24 Derivatebörsen) und 24h-Spot-Volumen aus den eigenen Spot-Ticker-Collectoren (14 Spot-Börsen, z. B. binance, okx, bybit, coinbase, kraken, upbit).
Börsenabdeckung
Futures: bis zu 24 Börsen; Spot: 14 Börsen, in USD / USDT / USDC notierte Paare
Einheiten
volumes in USD; changes in percent; ratios dimensionless
Methode
futures total = SUM(volume_usd) of tickers fresh within 1 h, plus non-USDT-perp contracts once they have their own ~24 h baseline; spot total = SUM of the latest per-exchange snapshot within 30 min; 24 h change by same-exchange pairing; ratios futures_to_spot and oi_to_futures_volume
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 03:57:37 UTCHTTP 20042 msSchema stimmt übereinNeuester Datenpunkt 8m alt

Verfügbarkeit, letzte 30 Tage

100 % von 411 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/volumeVerfügbar
Parameter

string — Coin symbol; 400 when missing. Alias: `base`.

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