API REST

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 seule 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 pas de profondeur ailleurs.
  • Le ciblage se fait par ?asset=, avec l’actif seul — BTC ou ETH — et non par ?symbol=. Passer BTCUSDT est refusé.
  • Les Greeks sont recalculés selon une convention unique, plutôt que repris de chaque place : les signes et les conventions y diffèrent trop pour être additionnés tels quels.
ParamètreTypeDéfautDescription
assetstringBTCBTC ou ETH.
timeframestring1hSur les routes /history : 1m, 5m, 15m, 30m, 1h, 4h, 1d.
limitinteger100Sur les routes /history.
since_ms / until_msintegerFenêtre datée, acceptée par les historiques de cette famille.

#Vue d’ensemble

GET/v1/options/summarydata_type · options_summary

Un seul appel pour la photo complète : positions ouvertes, volume, rapport 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"
ChampTypeDescription
assetstringBTC ou ETH.
underlying_pricefloatPrix du sous-jacent au moment du calcul.
open_interestobjectPositions ouvertes en dollars : total, calls, puts.
volumeobjectVolume échangé en dollars, même découpage.
pc_ratiofloatRapport put sur call.
pc_signalstringUne lecture qualitative du rapport.
iv_atmfloatVolatilité implicite à la monnaie, en décimal — 0,48 vaut 48 %.
nearest_expiryobjectL’échéance la plus proche : date, jours restants, max pain, put/call et volatilité propres.
coverageobjectsources_active, le nombre de places ayant contribué, et oi_coverage entre 0 et 1.

#Open interest et volume

GET/v1/options/oidata_type · options_oi
GET/v1/options/oi/historydata_type · options_oi_history

Les positions ouvertes, en unités de l’actif et en dollars, réparties entre calls et puts.

GET/v1/options/oi/deltadata_type · options_oi_delta
GET/v1/options/oi/delta/historydata_type · options_oi_delta_history

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.

GET/v1/options/oi/distributiondata_type · options_oi_distribution

La répartition de l’open interest 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 traverser.

GET/v1/options/volumedata_type · options_volume
GET/v1/options/volume/historydata_type · options_volume_history

#Put/call et max pain

GET/v1/options/pc-ratiodata_type · options_pc_ratio
GET/v1/options/pc-ratio/historydata_type · options_pc_ratio_history

Le rapport entre puts et calls, en open interest comme en volume. Sous 1, les calls dominent. Au-dessus, la couverture à la baisse prend le dessus.

GET/v1/options/max-paindata_type · options_max_pain
GET/v1/options/max-pain/historydata_type · options_max_pain_history

Ce qu’est le max pain

Le prix d’exercice auquel la valeur totale des options arrivant à échéance serait la plus faible — donc celui où les acheteurs d’options perdent le plus. C’est un point de gravité statistique, pas une prévision : sa valeur est de dire à quel niveau les positions existantes créent une tension.

#Volatilité implicite

GET/v1/options/ivdata_type · options_iv
GET/v1/options/iv/historydata_type · options_iv_history

La volatilité implicite pondérée par l’open interest, en décimal. Elle mesure ce que le marché paie pour se couvrir, indépendamment de la direction.

GET/v1/options/iv/klinesdata_type · options_iv_klines

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.

#Greeks et échéances

GET/v1/options/greeksdata_type · options_greeks

Delta, gamma, vega et theta agrégés, pondérés par l’open interest. 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.

GET/v1/options/expirydata_type · options_expiry

Le résumé par échéance : positions ouvertes, rapport put/call, max pain et volatilité pour chaque date. C’est la vue à consulter avant une grande échéance, quand le dénouement des positions pèse sur le sous-jacent.