Options
Le marché des options sur Bitcoin et Ethereum, agrégé sur plusieurs places, normalisé en dollars et recalculé selon une convention unique. Dix-sept routes qui répondent à une question : où le marché place son risque, et à quel prix.
#Le principe
Trois choses distinguent cette famille du reste de l’API.
- Deux actifs seulement : Bitcoin et Ethereum. Le marché des options n’a de profondeur nulle part ailleurs.
- Le ciblage se fait avec
?asset=, avec l’actif seul (BTCouETH) et non avec?symbol=. PasserBTCUSDTest refusé. - Les grecques sont recalculées selon une convention unique, plutôt que reprises de chaque place : les signes et conventions y diffèrent trop pour être additionnés tels quels.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
asset | string | BTC | BTC ou ETH. |
timeframe | string | 1h | Sur les routes /history : 1m, 5m, 15m, 30m, 1h, 4h, 1d. |
limit | integer | 100 | Sur les routes /history. |
since_ms / until_ms | integer | — | Fenêtre datée, acceptée par les historiques de cette famille. |
#Vue d’ensemble
Un seul appel pour le tableau complet : positions ouvertes, volume, ratio put/call, volatilité implicite à la monnaie, et le détail de l’échéance la plus proche.
curl -H "X-API-KEY: $BYTNODE_KEY" \
"https://api.bytnode.com/v1/options/summary?asset=BTC"| Champ | Type | Description |
|---|---|---|
asset | string | BTC ou ETH. |
underlying_price | float | Prix du sous-jacent au moment du calcul. |
open_interest | object | Positions ouvertes en dollars : total, calls, puts. |
volume | object | Volume échangé en dollars, même découpage. |
pc_ratio | float | Ratio puts sur calls. |
pc_signal | string | Une lecture qualitative du ratio. |
iv_atm | float | Volatilité implicite à la monnaie, en décimal : 0.48 signifie 48 %. |
nearest_expiry | object | L’échéance la plus proche : date, jours restants, max pain, et son propre put/call et sa volatilité. |
coverage | object | sources_active, le nombre de places ayant contribué, et oi_coverage entre 0 et 1. |
#Intérêt ouvert et volume
Les positions ouvertes, en unités de l’actif et en dollars, réparties entre calls et puts.
La variation sur la fenêtre, calculée à la demande : dernière valeur moins première. Chaque ligne porte delta_call_usd et delta_put_usd.
La répartition de l’intérêt ouvert par prix d’exercice et par échéance. C’est la carte des niveaux où le marché a réellement engagé du capital : les murs de strikes que le sous-jacent devra franchir.
#Put/call et max pain
Le rapport entre puts et calls, en intérêt ouvert comme en volume. En dessous de 1, les calls dominent. Au-dessus, la couverture à la baisse prend le dessus.
Ce qu’est le max pain
Le prix d’exercice auquel la valeur totale des options arrivant à échéance serait la plus basse, donc celui où les acheteurs d’options perdent le plus. C’est un centre de gravité statistique, pas une prévision : son intérêt est de dire à quel niveau les positions existantes créent une tension.
#Volatilité implicite
La volatilité implicite pondérée par l’intérêt ouvert, en décimal. Elle mesure ce que le marché paie pour se couvrir, indépendamment de la direction.
La même volatilité, en bougies OHLC dérivées à la demande. Chaque ligne porte bucket, open, high, low, close. De quoi tracer la volatilité comme on trace un prix.
#Grecques et échéances
Delta, gamma, vega et thêta agrégés, pondérés par l’intérêt ouvert. Ils sont recalculés selon une convention unique, ce qui les rend additionnables entre places, ce que les valeurs publiées par chacune ne permettraient pas.
La synthèse par échéance : positions ouvertes, ratio put/call, max pain et volatilité pour chaque date. C’est la vue à consulter avant une grosse échéance, quand le dénouement des positions pèse sur le sous-jacent.