euronext-options

name	euronext-options
description	Fetch Euronext stock option chains — search for optionable instruments, discover available expiry dates, and pull full option chains (calls/puts with strikes, bids, asks, lasts, settlements) for any Euronext-listed equity option. Use this skill when the user asks about European stock options, Euronext option chains, LEAPS on European equities, or wants to scan option prices across expiries for stocks like Shell, TotalEnergies, Airbus, or Heineken, even if they don't mention Euronext by name.
compatibility	Requires curl and jq.
allowed-tools	bash

Euronext Options

Fetch stock option chains from Euronext exchanges (Amsterdam, Paris, Milan, Brussels, Lisbon, Oslo).

Usage

Run scripts/fetch with a symbol, exchange, and mode:

# Find the symbol/exchange for a company
scripts/fetch --search shell

# Nearest expiry (raw JSON — pipe to jq)
scripts/fetch RD DAMS | jq '.simple[].maturityDate'

# Discover all available expiry dates
scripts/fetch RD DAMS --discover

# Fetch specific expiry (raw HTML — the agent reads the table directly)
scripts/fetch RD DAMS --md 01-12-2030

# Multiple expiries at once
scripts/fetch RD DAMS --md 01-12-2030 --md 01-12-2028

# Underlying instrument info (name, price, ISIN — raw HTML)
scripts/fetch RD DAMS --underlying

Output formats

Mode	Output	How to parse
--search	TSV	symbol \t exchange per line
default	JSON	pipe to jq
--md	HTML	agent reads the <table> rows directly
--discover	text	DD-MM-YYYY dates, one per line
--underlying	HTML	agent reads key/value pairs directly

The --md HTML contains <table> elements with columns: C Settl, C Last, C Bid, C Ask, C link, Strike, P link, P Bid, P Ask, P Last, P Settl. Each expiry has an <h3> with the maturity month/year. Values of - mean no quote.

Finding the symbol

If you don't know the symbol/exchange, search by company name. Filter results to stock-options (the script does this automatically). Common examples:

Company	Symbol	Exchange
Shell	RD	DAMS
TotalEnergies	TTE	DPAR
Airbus	EA1	DPAR
Heineken	HEI	DAMS
Eni	ENI	DMIL

Some underlyings have multiple option classes (American, European, cash-settled, weekly, mini). The search returns all of them.

Exchanges

See references/exchanges.md for the full list of Euronext derivatives exchanges and their MIC codes.

Gotchas

• Maturity date format — --md takes DD-MM-YYYY (e.g., 01-12-2030 for Dec 2030), not MM-DD-YYYY or YYYY-MM-DD.
• Market hours — Option prices are delayed 15 minutes. Settlement prices (settl) are end-of-day and available even when markets are closed.
• Thin chains — Far-dated LEAPS and small-cap underlyings often have no bids/asks. Only settlement prices may exist. The settl field is the most reliable for valuation work.
• Symbol vs ticker — The Euronext option class symbol (e.g., RD for Shell) is NOT the same as the stock ticker (e.g., SHELL). Always use --search if unsure.
• Multiple option classes — Some stocks have American (1 suffix), European (9 suffix), cash-settled (9C), weekly (1-5 prefix), and mini (1M suffix) variants. They have different symbols and may have different liquidity.
• Dublin — No stock options listed on Euronext Dublin.