/api/options/iv
GETVerfügbar

Smile / Terminstruktur der impliziten Volatilität von Optionen

Smile / Terminstruktur der impliziten Volatilität von Optionen

GET/api/options/iv
Einzelne Börse: ausschließlich aus öffentlichen Optionsdaten von Deribit berechnet. Felder vom Typ `volume_usd` basieren auf der Prämie, sofern die Börse den Prämienumsatz meldet. Für sechs Börsen mit Abdeckung je Börse verwenden Sie `/api/sd/options/overview`.

Anfrage

Query-Parameter

NameTypErforderlichStandardZulässige WerteBeschreibung
currencystringOptionalBTCBTC, ETHBasiswert: `BTC` oder `ETH`. Jeder andere Wert liefert 400 `INVALID_PARAM`. Alias: `coin`. Beispiel: BTC
expirystringOptional——Verfallstermin; fehlt er oder ist er ungültig, gilt der Standard-Verfallstermin.

Beispielanfrage

curl -s "https://www.coinboss.com/api/options/iv?currency=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 }`.
currencystring—Währungs- / Asset-Symbol.
index_pricenumber—Indexpreis des Basiswerts.
termarray—Laufzeitstruktur der impliziten Volatilität aus dem letzten Deribit-Options-Snapshot: ein Eintrag je noch nicht verfallenem Verfallstermin, nächster zuerst.
term[]object—Ein Verfallstermin: Datum `expiry`, `atm_iv`, `total_oi` (Open Interest als Nominalwert in USD) und die Anzahl der `strikes`.
term[].expirystring—Verfallsdatum der Optionsserie.
term[].atm_ivnumber%Implizite Volatilität am Geld für den Verfallstermin: Durchschnitt der Deribit-Mark-IV von Call und Put am Ausübungspreis, der dem Indexpreis am nächsten liegt (annualisiert, 37.5 = 37,5 %).
term[].total_oinumber—Gesamtes Open Interest.
term[].strikesnumber—Ausübungspreise der Optionen.
smileobject—Volatilitäts-Smile eines Verfallstermins: der angefragte `expiry` oder standardmäßig der Verfallstermin mit dem größten Open Interest; null, wenn keine Daten vorliegen.
smile.expirystring—Verfallsdatum der Optionsserie.
smile.pointsarray—Datenpunkte.
smile.points[]object—Datenpunkte.
smile.points[].strikenumberUSDAusübungspreis (Strike).
smile.points[].call_ivnumber%Implizite Volatilität auf Basis des Deribit-Mark-Preises für den Call an diesem Ausübungspreis (annualisiert, 37.5 = 37,5 %); null, wenn der Call keine Mark-IV hat.
smile.points[].put_ivnumber%Implizite Volatilität auf Basis des Deribit-Mark-Preises für den Put an diesem Ausübungspreis (annualisiert, 37.5 = 37,5 %); null, wenn der Put keine Mark-IV hat.

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

Beispielantwort

/api/options/iv?currency=BTC · Echte Antwort, erfasst 2026-11-13 03:52:56 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: term hatte 12 Elemente; smile.points hatte 60 Elemente.

  • {
    • "success": true,
    • "currency": "BTC",
    • "index_price": 69009.96,
    • "term": [
      • { … 4 },
      • { … 4 }
      ],
    • "smile": {
      • "expiry": "2026-12-25",
      • "points": [ … 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
currency=ETH2002 msBestanden
currency=SOL4001 msBestanden liefert den erwarteten Fehler

Geprüft 2026-11-13 03:28:20 UTC

Details

Authentifizierung
Keine. Öffentlicher Endpunkt.
Rate-Limit
1200 Anfragen pro Minute und IP
Server-Cache
5m
Edge-Micro-Cache
10s
Aktualisierungsintervall
alle 10 min (der Snapshot wird vollständig ersetzt)
Zeitfenster
letzter Snapshot
Datenquellen
Terminstruktur und Smile der impliziten Volatilität aus der Mark-IV einer einzelnen Börse (Deribit).
Börsenabdeckung
Nur Deribit, BTC- und ETH-Optionen; andere Börsen (Optionen von Binance/OKX/Bybit, CME) sind nicht enthalten. Nur künftige Verfallstermine.
Sortierung
Verfall aufsteigend; Ausübungspreise aufsteigend
Einheiten
percent (annualized implied volatility); USD notional (open interest)
Methode
ATM IV per expiry = mean of call and put mark IV at the strike closest to the index price; smile lists call/put mark IV per strike for one expiry.
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:52:56 UTCHTTP 2003 msSchema stimmt überein

Verfügbarkeit, letzte 30 Tage

99.76 % 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 →

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/options/ivVerfügbar
Parameter

string · Standard BTC — Underlying: `BTC` or `ETH`. Any other value returns 400 `INVALID_PARAM`. Alias: `coin`.

string — Expiry; default expiry when missing or invalid.

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