Detailübersicht eines Coins
Detailübersicht eines Coins (Preis, Marktkapitalisierung, Angebot, Derivate-Zusammenfassung)
/api/currency/overviewAnfrage
Query-Parameter
| Name | Typ | Erforderlich | Standard | Zulässige Werte | Beschreibung |
|---|---|---|---|---|---|
| coin | string | Erforderlich | — | — | 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.
| Feld | Typ | Einheit | Beschreibung |
|---|---|---|---|
| success | boolean | — | true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`. |
| data | object | — | Nutzdaten. |
| data.coin | string | — | Coin-Symbol in Großbuchstaben (zum Beispiel BTC). |
| data.supply | object | — | Angebot in Coins. |
| data.supply.price_usd | string(decimal) | USD | Preis. |
| data.supply.market_cap_usd | string(decimal) | USD | Marktkapitalisierung. |
| data.supply.mcap_rank | number | — | Rang nach Marktkapitalisierung. |
| data.supply.vol_24h_usd | string(decimal) | USD | 24h-Volumen. |
| data.supply.circulating | string(decimal) | — | Umlaufangebot in Coins. |
| data.supply.total_supply | string(decimal) | — | Gesamtangebot in Coins. |
| data.supply.max_supply | string(decimal)|null | — | Maximales Angebot in Coins; null, wenn unbegrenzt oder unbekannt. |
| data.supply.change_24h_pct | string(decimal) | % | Prozentuale Veränderung über 24h. |
| data.supply.image_url | string | — | Von CoinBoss ausgelieferter Same-Origin-Icon-Pfad; null, wenn kein verifiziertes Icon vorhanden ist. |
| data.supply.website_url | string | — | Offizielle Website des Projekts, aus den Coin-Metadaten. |
| data.supply.reddit_url | string|null | — | Subreddit des Projekts; null, wenn keines hinterlegt ist. |
| data.supply.github_url | string|null | — | Haupt-Quellcode-Repository des Projekts; null, wenn keines hinterlegt ist. |
| data.supply.whitepaper_url | string | — | Link zum Whitepaper des Projekts. |
| data.supply.explorer_url | string | — | Link zu einem Block-Explorer für den Coin. |
| data.supply.category | string | — | Kategorie. |
| data.supply.asof | number | ms | Zeitpunkt der neuesten verwendeten Daten. |
| data.supply.stale | boolean | — | Zeilen oder Flag für Daten, die älter als das Aktualitätsfenster sind. |
| data.supply.spot_vol_usd | number | USD | Summe 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_usd | number | USD | Summe 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_usd | number | USD | Aggregiertes Open Interest des Coins über alle Börsen und Kontrakttypen; derselbe Wert wie `oi.total_usd`; null ohne eigene Daten. |
| data.supply.high_24h | string(decimal) | — | 24h-Hoch. |
| data.supply.low_24h | string(decimal) | — | 24h-Tief. |
| data.futures_vol_chg_pct | number | % | 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_pct | number | % | 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.oi | object | — | Open Interest. |
| data.oi.total_usd | number | USD | Gesamtzahl. |
| data.oi.local_usd | number | USD | Open Interest, summiert aus der CoinBoss-eigenen Erhebung je Börse; identisch mit `oi.total_usd`. |
| data.oi.by_exchange | array | — | Aufschlüsselung je Börse. |
| data.oi.by_exchange[] | object | — | Aufschlüsselung je Börse. |
| data.oi.by_exchange[].exchange | string | — | Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`). |
| data.oi.by_exchange[].oi_usd | number | USD | Open Interest als Nominalwert in USD. |
| data.oi.n_exchanges | number | — | Anzahl der beitragenden Börsen. |
| data.oi.asof | number | ms | Zeitpunkt der neuesten verwendeten Daten. |
| data.oi.chg_basis | object | — | 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.cur | number | — | Aktueller Wert. |
| data.oi.chg_basis.prev | number | — | Vorheriger Wert (Vergleichsbasis). |
| data.oi.chg_basis.n_matched | number | — | Elemente, die an beiden Enden des Vergleichs vorhanden sind. |
| data.oi.chg_basis.prev_hour_ts | number | ms | Beginn des vorherigen Stunden-Buckets. |
| data.oi.chg_basis.frozen_excluded | object | — | Zeilen, die ausgeschlossen wurden, weil sich der Quellwert nicht verändert hat. |
| data.oi.chg_basis.frozen_excluded.n_baseline | number | — | Elemente im Snapshot der Vergleichsbasis. |
| data.oi.chg_basis.frozen_excluded.n_current | number | — | Elemente im aktuellen Snapshot. |
| data.oi.chg_basis.frozen_excluded.cur_usd | number | USD | Aktueller Wert. |
| data.oi.chg_basis.frozen_excluded.prev_usd | number | USD | Wert der Vergleichsbasis. |
| data.futures_vol | object | — | Futures-Volumen. |
| data.futures_vol.total_usd | number | USD | Gesamtzahl. |
| data.futures_vol.n_exchanges | number | — | Anzahl der beitragenden Börsen. |
| data.futures_vol.chg_basis | object | — | 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.cur | number | — | Aktueller Wert. |
| data.futures_vol.chg_basis.prev | number | — | Vorheriger Wert (Vergleichsbasis). |
| data.futures_vol.chg_basis.n_matched | number | — | Elemente, die an beiden Enden des Vergleichs vorhanden sind. |
| data.futures_vol.chg_basis.prev_hour_ts | number | ms | Beginn des vorherigen Stunden-Buckets. |
| data.funding | number | — | Block oder Wert der Funding-Rate. |
| data.funding_detail | object | — | 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.basis | string | — | Futures-Preis minus Spot-Preis, oder der Basis-Block. |
| data.funding_detail.avg_8h | number | — | Mittelwert der auf 8h normalisierten Raten. |
| data.funding_detail.oi_weighted_8h | number | — | Mit dem Open Interest gewichteter Mittelwert der auf 8h normalisierten Raten. |
| data.funding_detail.apr_pct | number | % per year | Annualisierter Prozentwert. |
| data.funding_detail.n_exchanges | number | — | Anzahl der beitragenden Börsen. |
| data.funding_detail.n_normalized | number | — | Auf 8h normalisierte Börsen. |
| data.funding_detail.n_unknown_interval | number | — | Börsen mit unbekanntem Funding-Intervall. |
| data.funding_detail.by_exchange | array | — | Aufschlüsselung je Börse. |
| data.funding_detail.by_exchange[] | object | — | Aufschlüsselung je Börse. |
| data.funding_detail.by_exchange[].exchange | string | — | Börsenkennung in Kleinbuchstaben (zum Beispiel `binance`). |
| data.funding_detail.by_exchange[].symbol | string | — | Instrumentensymbol in der von CoinBoss normalisierten Form (zum Beispiel BTCUSDT). |
| data.funding_detail.by_exchange[].rate | number | — | Rate. |
| data.funding_detail.by_exchange[].interval_h | number | h | Intervall. |
| data.funding_detail.by_exchange[].rate_8h | number | — | Auf einen 8-Stunden-Zeitraum normalisierte Rate. |
| data.funding_detail.by_exchange[].next_funding_time | number|null | ms | Zeitstempel. |
| data.long_short | object | — | Long/Short-Block. |
| data.long_short.long | number | — | Wert der Long-Seite. |
| data.long_short.short | number | — | Wert der Short-Seite. |
| data.long_short.ratio | number | — | Verhältnis. |
| data.long_short.type | string | — | Typ. |
| data.long_short.n_exchanges | number | — | Anzahl der beitragenden Börsen. |
| data.derived | object | — | 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_1h | string(decimal) | — | RSI(14) auf 1h-Kerzen. |
| data.derived.rsi_4h | string(decimal) | — | RSI(14) auf 4h-Kerzen. |
| data.derived.rsi_1d | string(decimal) | — | RSI(14) auf Tageskerzen. |
| data.derived.basis_pct | string(decimal)|null | % | (futures − spot) / spot × 100. |
| data.derived.basis_annual_pct | null | % per year | Basis, annualisiert über die Tage bis zum Verfall. |
| data.derived.oi_usd_agg | string(decimal) | USD | Aggregiertes Open Interest über alle Börsen und Kontrakttypen zum Zeitpunkt der letzten Indikator-Aktualisierung; kann `oi.total_usd` leicht hinterherhinken. |
| data.derived.funding_avg | string(decimal) | — | Durchschnittliche Funding-Rate über alle Börsen. |
| data.derived.ls_account | string(decimal) | — | Long/Short-Verhältnis nach Konten. |
| data.derived.ls_taker | string(decimal)|null | — | Taker-Kauf/Verkauf-Verhältnis. |
| data.derived.liq_24h_usd | string(decimal) | USD | 24h-Liquidationen. |
| data.liquidation | object | — | Liquidations-Block. dynamische Schlüssel: 1h,4h,12h,24h |
| data.liquidation.{*} | object | — | Liquidations-Block. |
| data.liquidation.{*}.win | string | — | Fensterbezeichnung des Eintrags, die seinen Schlüssel wiederholt (`1h`, `4h`, `12h` oder `24h`). |
| data.liquidation.{*}.long_usd | number | USD | Long-Seite. |
| data.liquidation.{*}.short_usd | number | USD | Short-Seite. |
| data.liquidation.{*}.total_usd | number | USD | Gesamtzahl. |
| data.liquidation.{*}.cnt | number | — | 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"
- "futures_vol_chg_pct"67.76
- "oi_chg_pct"-3.65
- "oi"
- "futures_vol"
- "funding"0.000057831612725940206
- "funding_detail"
- "long_short"
- "derived"
- "liquidation"
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 | 86 ms | Bestanden |
| coin=SOL | 200 | 81 ms | Bestanden |
| coin=ARKM | 200 | 79 ms | Bestanden |
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ü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 →
| 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/currency/overviewVerfügbarstring — Base coin symbol (uppercase, e.g. BTC).
https://www.coinboss.com/api/currency/overview?coin=BTCMehr in dieser Kategorie
- Daten der Coin-Heatmap /api/coin-heatmap
- Vollständige Coin-Liste /api/coins/all
- Coin-Suche /api/coins/search
- Börsentabelle der Coin-Seite /api/currency/ex-table
- Kapitalfluss eines Coins /api/currency/flows
- Coin-Liste für die Navigation /api/currency/list
- Märkte je Börse für einen Coin /api/currency/markets
- Detailübersicht eines Coins /api/currency/overview
- Preisperformance eines Coins über mehrere Zeiträume /api/currency/performance
- Spot-Taker-Nettozufluss für einen Coin /api/currency/spot-netflow
- Matrix der Margin-Leihzinsen /api/margin-fee/matrix
- Margin-Leihzinsen /api/margin/rates
- Gewinner & Verlierer (mit Mindestvolumen) /api/market/gainers-losers
- Schnellübersicht der Kursbewegungen bei Coins mit der höchsten Marktkapitalisierung /api/market/top-movers
- Renditematrix nach Monat / Quartal / Jahr /api/p3/btc-returns
- Matrix der Tagesrenditen /api/p3/btc-returns-daily
- Matrix der Wochenrenditen /api/p3/btc-returns-weekly
- Gewinner & Verlierer (Futures oder Spot) /api/p3/gainers-losers
- Stundenkerzen /api/p3/klines
- Volatilitätsübersicht /api/p3/volatility
- Volatilitätshistorie für einen Coin /api/p3/volatility/series
- Spot-Marktliste der Coins /api/spot/coins
- Daten der Volumenseite eines Coins /api/volume/coin