Auf- / Abschlag der Grayscale-Trusts
Auf- / Abschlag der Grayscale-Trusts
/api/grayscale/premiumAnfrage
Dieser Endpunkt hat keine Parameter.
Beispielanfrage
curl -s "https://www.coinboss.com/api/grayscale/premium"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 }`. |
| fetched_at | number | ms | Zeitpunkt, zu dem CoinBoss die Daten von der Quelle abgerufen hat. |
| items | array | — | Ergebniseinträge. |
| items[] | object | — | Ergebniseinträge. |
| items[].ticker | string | — | Ticker des Fonds. |
| items[].name | string | — | Name. |
| items[].asset | string | — | Asset-Symbol. |
| items[].nav | number | USD | Zuletzt veröffentlichter Nettoinventarwert je Anteil des Fonds, aus einer Drittanbieter-Kursquelle; null, wenn nicht verfügbar. |
| items[].price | number | — | Letzter Preis in der Kurswährung (USD oder USDT, sofern nicht anders angegeben). |
| items[].market_time | number | ms | Zeitstempel. |
| items[].premium_pct | number | % | Prämie gegenüber dem Referenzpreis. |
| history | array | — | Historische Datenpunkte, älteste zuerst, sofern nicht anders angegeben. |
| history[] | object | — | Historische Datenpunkte, älteste zuerst, sofern nicht anders angegeben. |
| history[].date | string | — | Kalenderdatum (UTC). |
| history[].GBTC | number | % | Aufschlag (+) oder Abschlag (−) des GBTC-Marktpreises gegenüber seinem NAV, wie zuletzt an diesem UTC-Datum erfasst. |
| history[].BTC | number | % | Aufschlag (+) oder Abschlag (−) des Marktpreises des Grayscale Bitcoin Mini Trust (Ticker `BTC`) gegenüber seinem NAV, wie zuletzt an diesem UTC-Datum erfasst. |
| history[].ETHE | number | % | Aufschlag (+) oder Abschlag (−) des ETHE-Marktpreises gegenüber seinem NAV, wie zuletzt an diesem UTC-Datum erfasst. |
| history[].ETH | number | % | Aufschlag (+) oder Abschlag (−) des Marktpreises des Grayscale Ethereum Mini Trust (Ticker `ETH`) gegenüber seinem NAV, wie zuletzt an diesem UTC-Datum erfasst. |
Erzeugt 2026-11-11 23:00 UTC aus 1 echten Antworten.
Beispielantwort
/api/grayscale/premium · Echte Antwort, erfasst 2026-11-13 03:52:54 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: items hatte 4 Elemente; history hatte 66 Elemente.
- "success"true
- "fetched_at"1794539571973
- "items"
- "history"
Details
- Authentifizierung
- Keine. Öffentlicher Endpunkt.
- Rate-Limit
- 1200 Anfragen pro Minute und IP
- Server-Cache
- 10m
- Edge-Micro-Cache
- 10s
- Aktualisierungsintervall
- bei Anfrage, 1 Stunde im Cache; pro Tag wird ein Historienpunkt ergänzt
- Zeitfenster
- letzter Snapshot sowie lokal aufgebaute Tageshistorie
- Datenquellen
- Auf-/Abschlag der BTC- und ETH-Trusts von Grayscale, berechnet aus Marktpreis und NAV einer öffentlichen Marktdaten-Website.
- Börsenabdeckung
- GBTC, Bitcoin Mini Trust, ETHE, Ethereum Mini Trust.
- Einheiten
- percent (premium_pct); USD (price, NAV)
- Methode
- premium_pct = (market price - NAV) / NAV x 100.
- Zeitstempel
- Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
- Antwortformat
- json
- Stabilität
- Stabil
Live-Status
Der neueste Datenpunkt ist 24775 s alt (erwartet innerhalb von 21600 s)
Verfügbarkeit, letzte 30 Tage
100 % von 409 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/grayscale/premiumBeeinträchtigtKeine Parameter.
https://www.coinboss.com/api/grayscale/premiumMehr in dieser Kategorie
- Spot-ETF-Fonds /api/sd/etf/funds
- Spot-ETF-Historie /api/sd/etf/history
- Spot-ETF-Übersicht (Emittentenangaben) /api/sd/etf/overview
- Tägliche Spot-ETF-Nettoflüsse je Fonds /api/etf/detail
- Historie der täglichen Spot-ETF-Nettoflüsse /api/etf/flows
- Details zu einem einzelnen ETF /api/etf/fund/:ticker
- Liste der ETF-Fonds /api/etf/funds
- Coin-Bestände der ETFs je Fonds /api/etf/holdings
- ETF- / Trust-Produkte eines Emittenten /api/etf/issuer
- ETF-Übersicht /api/etf/overview
- Auf- / Abschlag der Grayscale-Trusts /api/grayscale/premium
- Volumen futuresbasierter ETFs /api/indicators/futures-etf-volumes