/api/currency/overview
GETVerfügbar

Detailübersicht eines Coins

Detailübersicht eines Coins (Preis, Marktkapitalisierung, Angebot, Derivate-Zusammenfassung)

GET/api/currency/overview

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
coinstringErforderlich——Symbol des Basis-Coins (Großbuchstaben, z. B. BTC). Beispiel: BTC

Beispielanfrage

curl -s "https://www.coinboss.com/api/currency/overview?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 }`.
dataobject—Nutzdaten.
data.coinstring—Coin-Symbol in Großbuchstaben (zum Beispiel BTC).
data.supplyobject—Angebot in Coins.
data.supply.price_usdstring(decimal)USDPreis.
data.supply.market_cap_usdstring(decimal)USDMarktkapitalisierung.
data.supply.mcap_ranknumber—Rang nach Marktkapitalisierung.
data.supply.vol_24h_usdstring(decimal)USD24h-Volumen.
data.supply.circulatingstring(decimal)—Umlaufangebot in Coins.
data.supply.total_supplystring(decimal)—Gesamtangebot in Coins.
data.supply.max_supplystring(decimal)|null—Maximales Angebot in Coins; null, wenn unbegrenzt oder unbekannt.
data.supply.change_24h_pctstring(decimal)%Prozentuale Veränderung über 24h.
data.supply.image_urlstring—Von CoinBoss ausgelieferter Same-Origin-Icon-Pfad; null, wenn kein verifiziertes Icon vorhanden ist.
data.supply.website_urlstring—Offizielle Website des Projekts, aus den Coin-Metadaten.
data.supply.reddit_urlstring|null—Subreddit des Projekts; null, wenn keines hinterlegt ist.
data.supply.github_urlstring|null—Haupt-Quellcode-Repository des Projekts; null, wenn keines hinterlegt ist.
data.supply.whitepaper_urlstring—Link zum Whitepaper des Projekts.
data.supply.explorer_urlstring—Link zu einem Block-Explorer für den Coin.
data.supply.categorystring—Kategorie.
data.supply.asofnumbermsZeitpunkt der neuesten verwendeten Daten.
data.supply.staleboolean—Zeilen oder Flag für Daten, die älter als das Aktualitätsfenster sind.
data.supply.spot_vol_usdnumberUSDSumme des 24h-Spot-Volumens des Coins über die Spot-Börsen, die CoinBoss selbst erhebt (letzter Snapshot); null, wenn nicht erhoben.
data.supply.futures_vol_usdnumberUSDSumme des 24h-Futures-Volumens über alle Börsen mit einem Ticker, der jünger als 1 Stunde ist; derselbe Wert wie `futures_vol.total_usd`; null ohne eigene Daten.
data.supply.oi_total_usdnumberUSDAggregiertes Open Interest des Coins über alle Börsen und Kontrakttypen; derselbe Wert wie `oi.total_usd`; null ohne eigene Daten.
data.supply.high_24hstring(decimal)—24h-Hoch.
data.supply.low_24hstring(decimal)—24h-Tief.
data.futures_vol_chg_pctnumber%24h-Veränderung des Futures-Volumens: Börsen, die sowohl jetzt als auch im stündlichen Snapshot von vor etwa 24 Stunden vorhanden sind, (Σ aktuell − Σ vorher) ÷ Σ vorher.
data.oi_chg_pctnumber%24h-Veränderung des Open Interest, berechnet auf Kontrakten, die sowohl jetzt als auch im stündlichen Snapshot vorhanden sind, der dem Zeitpunkt vor 24 Stunden am nächsten liegt.
data.oiobject—Open Interest.
data.oi.total_usdnumberUSDGesamtzahl.
data.oi.local_usdnumberUSDOpen Interest, summiert aus der CoinBoss-eigenen Erhebung je Börse; identisch mit `oi.total_usd`.
data.oi.by_exchangearray—Aufschlüsselung je Börse.
data.oi.by_exchange[]object—Aufschlüsselung je Börse.
data.oi.by_exchange[].exchangestring—Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`).
data.oi.by_exchange[].oi_usdnumberUSDOpen Interest als Nominalwert in USD.
data.oi.n_exchangesnumber—Anzahl der beitragenden Börsen.
data.oi.asofnumbermsZeitpunkt der neuesten verwendeten Daten.
data.oi.chg_basisobject—Eingangsgrößen von `oi_chg_pct`: gepaarte aktuelle und vorherige Summen (`cur`, `prev`), Anzahl der zugeordneten Börsen, Stunde der Vergleichsbasis und ausgeschlossene eingefrorene Kontrakte.
data.oi.chg_basis.curnumber—Aktueller Wert.
data.oi.chg_basis.prevnumber—Vorheriger Wert (Vergleichsbasis).
data.oi.chg_basis.n_matchednumber—Elemente, die an beiden Enden des Vergleichs vorhanden sind.
data.oi.chg_basis.prev_hour_tsnumbermsBeginn des vorherigen Stunden-Buckets.
data.oi.chg_basis.frozen_excludedobject—Zeilen, die ausgeschlossen wurden, weil sich der Quellwert nicht verändert hat.
data.oi.chg_basis.frozen_excluded.n_baselinenumber—Elemente im Snapshot der Vergleichsbasis.
data.oi.chg_basis.frozen_excluded.n_currentnumber—Elemente im aktuellen Snapshot.
data.oi.chg_basis.frozen_excluded.cur_usdnumberUSDAktueller Wert.
data.oi.chg_basis.frozen_excluded.prev_usdnumberUSDWert der Vergleichsbasis.
data.futures_volobject—Futures-Volumen.
data.futures_vol.total_usdnumberUSDGesamtzahl.
data.futures_vol.n_exchangesnumber—Anzahl der beitragenden Börsen.
data.futures_vol.chg_basisobject—Eingangsgrößen von `futures_vol_chg_pct`: gepaarte aktuelle und vorherige Volumensummen (`cur`, `prev`), Anzahl der zugeordneten Börsen und Stunde der Vergleichsbasis.
data.futures_vol.chg_basis.curnumber—Aktueller Wert.
data.futures_vol.chg_basis.prevnumber—Vorheriger Wert (Vergleichsbasis).
data.futures_vol.chg_basis.n_matchednumber—Elemente, die an beiden Enden des Vergleichs vorhanden sind.
data.futures_vol.chg_basis.prev_hour_tsnumbermsBeginn des vorherigen Stunden-Buckets.
data.fundingnumber—Block oder Wert der Funding-Rate.
data.funding_detailobject—Aufschlüsselung hinter `funding`: einfache und mit dem Open Interest gewichtete, auf 8h normalisierte Raten, annualisierte Rate, Anzahl der Börsen und ein Eintrag je Börse.
data.funding_detail.basisstring—Futures-Preis minus Spot-Preis, oder der Basis-Block.
data.funding_detail.avg_8hnumber—Mittelwert der auf 8h normalisierten Raten.
data.funding_detail.oi_weighted_8hnumber—Mit dem Open Interest gewichteter Mittelwert der auf 8h normalisierten Raten.
data.funding_detail.apr_pctnumber% per yearAnnualisierter Prozentwert.
data.funding_detail.n_exchangesnumber—Anzahl der beitragenden Börsen.
data.funding_detail.n_normalizednumber—Auf 8h normalisierte Börsen.
data.funding_detail.n_unknown_intervalnumber—Börsen mit unbekanntem Funding-Intervall.
data.funding_detail.by_exchangearray—Aufschlüsselung je Börse.
data.funding_detail.by_exchange[]object—Aufschlüsselung je Börse.
data.funding_detail.by_exchange[].exchangestring—Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`).
data.funding_detail.by_exchange[].symbolstring—Instrumentensymbol in der von CoinBoss normalisierten Form (zum Beispiel BTCUSDT).
data.funding_detail.by_exchange[].ratenumber—Rate.
data.funding_detail.by_exchange[].interval_hnumberhIntervall.
data.funding_detail.by_exchange[].rate_8hnumber—Auf einen 8-Stunden-Zeitraum normalisierte Rate.
data.funding_detail.by_exchange[].next_funding_timenumber|nullmsZeitstempel.
data.long_shortobject—Long/Short-Block.
data.long_short.longnumber—Wert der Long-Seite.
data.long_short.shortnumber—Wert der Short-Seite.
data.long_short.rationumber—Verhältnis.
data.long_short.typestring—Typ.
data.long_short.n_exchangesnumber—Anzahl der beitragenden Börsen.
data.derivedobject—Periodisch neu berechnete Indikatoren für den Coin (RSI, Basis, aggregiertes Open Interest, durchschnittliches Funding, Long/Short-Anteile, 24h-Liquidationen); null, wenn nicht berechnet.
data.derived.rsi_1hstring(decimal)—RSI(14) auf 1h-Kerzen.
data.derived.rsi_4hstring(decimal)—RSI(14) auf 4h-Kerzen.
data.derived.rsi_1dstring(decimal)—RSI(14) auf Tageskerzen.
data.derived.basis_pctstring(decimal)|null%(futures − spot) / spot × 100.
data.derived.basis_annual_pctnull% per yearBasis, annualisiert über die Tage bis zum Verfall.
data.derived.oi_usd_aggstring(decimal)USDAggregiertes Open Interest über alle Börsen und Kontrakttypen zum Zeitpunkt der letzten Indikator-Aktualisierung; kann `oi.total_usd` leicht hinterherhinken.
data.derived.funding_avgstring(decimal)—Durchschnittliche Funding-Rate über alle Börsen.
data.derived.ls_accountstring(decimal)—Long/Short-Verhältnis nach Konten.
data.derived.ls_takerstring(decimal)|null—Taker-Kauf/Verkauf-Verhältnis.
data.derived.liq_24h_usdstring(decimal)USD24h-Liquidationen.
data.liquidationobject—Liquidations-Block. dynamische Schlüssel: 1h,4h,12h,24h
data.liquidation.{*}object—Liquidations-Block.
data.liquidation.{*}.winstring—Fensterbezeichnung des Eintrags, die seinen Schlüssel wiederholt (`1h`, `4h`, `12h` oder `24h`).
data.liquidation.{*}.long_usdnumberUSDLong-Seite.
data.liquidation.{*}.short_usdnumberUSDShort-Seite.
data.liquidation.{*}.total_usdnumberUSDGesamtzahl.
data.liquidation.{*}.cntnumber—Anzahl.

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

Beispielantwort

/api/currency/overview?coin=BTC · Echte Antwort, erfasst 2026-11-13 03:57:31 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: data.liquidation hatte 4 Elemente; data.oi.by_exchange hatte 22 Elemente; data.funding_detail.by_exchange hatte 23 Elemente.

  • {
    • "success": true,
    • "data": {
      • "coin": "BTC",
      • "supply": { … 22 },
      • "futures_vol_chg_pct": 67.76,
      • "oi_chg_pct": -3.65,
      • "oi": { … 6 },
      • "futures_vol": { … 3 },
      • "funding": 0.000057831612725940206,
      • "funding_detail": { … 8 },
      • "long_short": { … 5 },
      • "derived": { … 10 },
      • "liquidation": { … 2 }
      }
    }

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=ETH20086 msBestanden
coin=SOL20081 msBestanden
coin=ARKM20079 msBestanden

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

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
30s
Edge-Micro-Cache
10s
Aktualisierungsintervall
Drittanbieter-Marktdatenaggregator alle 10 min; Ticker alle 1 min; OI/Funding/Long/Short alle 5 min (Kern-Coins alle 1 min); Spot-Volumen alle 10 min; In-Memory-Cache 30 s
Zeitfenster
rollierend über 24h für Volumen/Liquidationen; letzter Snapshot für OI/Funding/Long/Short
Datenquellen
Angebot, Marktkapitalisierung und Rang stammen vom Drittanbieter-Marktdatenaggregator; Preis, Open Interest, Funding, Long/Short sowie Futures- und Spot-Volumen werden intern aus den öffentlichen APIs der Börsen aggregiert; Liquidationen stammen aus den Liquidations-Streams der Börsen.
Börsenabdeckung
Jeder Coin, der in der auf dem Drittanbieter-Marktdatenaggregator basierenden Tabelle steht oder für den ein Derivatekontrakt gelistet ist
Paginierung
keine
Einheiten
USD; rates as decimals; changes in percent
Methode
OI = SUM(oi_usd) over fresh contracts incl. multiplier contracts (3h; CME 120h); funding = OI-weighted mean of rate normalized to 8h (rate * 8 / interval_hours)
Zeitstempel
Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
Antwortformat
json
Stabilität
Stabil

Live-Status

VerfügbarGeprüft 2026-11-13 03:57:31 UTCHTTP 20095 msSchema stimmt übereinNeuester Datenpunkt 20s alt

Verfügbarkeit, letzte 30 Tage

99.76 % 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/currency/overviewVerfügbar
Parameter

string — Base coin symbol (uppercase, e.g. BTC).

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