# Option Chain Snapshot Returns a **snapshot of options contracts** for one underlying equity: per-contract pricing context, Greeks, implied volatility, open interest, latest quote and trade (when your plan includes them), and underlying reference. Use it for chain overviews, comparing strikes and expirations, research, and strategy work. If you are still learning what the columns mean, read [How to Read an Options Chain](/how-to-read-an-options-chain) and [Options Greeks Explained](/options-greeks-explained) first. For **one** contract by underlying + OCC ticker, use [Contract snapshot](/docs/option-contract-snapshot) instead.
## Endpoint ``` GET /v1/options/chain/{ticker} ``` ### Path parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `ticker` | string | Yes | Underlying symbol (for example `NFLX` or `AAPL`). | ### Query parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `strike_price` | number | No | Exact strike filter. | | `expiration_date` | string | No | Expiration date, `YYYY-MM-DD`. | | `contract_type` | string | No | Filter by type (for example `call` or `put`). | | `strike_price.gte` | number | No | Strike greater than or equal. | | `strike_price.gt` | number | No | Strike greater than. | | `strike_price.lte` | number | No | Strike less than or equal. | | `strike_price.lt` | number | No | Strike less than. | | `expiration_date.gte` | string | No | Expiration on or after this date (`YYYY-MM-DD`). | | `expiration_date.gt` | string | No | Expiration after this date. | | `expiration_date.lte` | string | No | Expiration on or before this date. | | `expiration_date.lt` | string | No | Expiration before this date. | | `sort` | string | No | Field used for ordering. | | `order` | string | No | Sort direction for `sort`. | | `limit` | integer | No | Maximum contracts returned. Default **10**, maximum **100**. | | `page` | string | No | Pagination continuation: use the URL in `next_url`, or pass the `page` query value from that URL here. | ### Response Top-level fields: | Field | Type | Description | | --- | --- | --- | | `status` | string | Outcome of the request (for example `OK`). | | `request_id` | string | Unique identifier for this request, assigned by CuteMarkets. | | `results` | array | Snapshot objects, one per contract. | | `next_url` | string | When more contracts exist for the query, full URL for the next page. | Each element of `results` may include: | Field | Type | Description | | --- | --- | --- | | `break_even_price` | number | Underlying price at which the position breaks even (call: strike + premium; put: strike − premium). | | `day` | object | Latest daily bar: open, high, low, close, volume, VWAP, change fields, `last_updated` (nanoseconds). | | `details` | object | `ticker`, `contract_type`, `exercise_style`, `expiration_date`, `strike_price`, `shares_per_contract`. | | `greeks` | object | `delta`, `gamma`, `theta`, `vega` when available; some deep ITM or illiquid lines may omit values. | | `implied_volatility` | number | IV implied by the option price, when available. | | `last_quote` | object | Latest quote (bid/ask, sizes, exchanges, midpoint, `last_updated`, `timeframe`) when quotes are enabled for your plan. | | `last_trade` | object | Latest trade when your plan includes trade data: `price`, `size`, `exchange`, `sip_timestamp`, `conditions`, `timeframe`, and related fields. | | `open_interest` | number | Open interest. | | `underlying_asset` | object | Underlying: `ticker`, `price`, `change_to_break_even`, `last_updated`, `timeframe`. | | `fmv` | number | Fair market value estimate when your tier includes it. | | `fmv_last_updated` | integer | Nanosecond timestamp of last FMV update when `fmv` is present. | ## Example requests ```bash curl \ "https://api.cutemarkets.com/v1/options/chain/NFLX/?limit=2" \ -H "Authorization: Bearer YOUR_API_KEY" ``` Filtered chain (example): ```bash curl \ "https://api.cutemarkets.com/v1/options/chain/NFLX/?contract_type=call&limit=50&sort=strike_price&order=asc" \ -H "Authorization: Bearer YOUR_API_KEY" ``` Higher `limit` (up to 100): ```bash curl \ "https://api.cutemarkets.com/v1/options/chain/NFLX/?limit=100" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ## Sample response _Sample with two results._ ```json { "results": [ { "break_even_price": 100.025, "day": { "change": -0.08, "change_percent": -80, "close": 0.02, "high": 0.15, "last_updated": 1775016000000000000, "low": 0.02, "open": 0.11, "previous_close": 0.1, "volume": 11788, "vwap": 0.03614 }, "details": { "contract_type": "call", "exercise_style": "american", "expiration_date": "2026-04-02", "shares_per_contract": 100, "strike_price": 100, "ticker": "O:NFLX260402C00100000" }, "greeks": { "delta": 0.02481795338171621, "gamma": 0.022072818287936315, "theta": -0.13121396656786571, "vega": 0.0019964356066287225 }, "implied_volatility": 0.6950024226241469, "last_quote": { "ask": 0.03, "ask_size": 486, "ask_exchange": 309, "bid": 0.02, "bid_size": 238, "bid_exchange": 322, "last_updated": 1775072652441254747, "midpoint": 0.025, "timeframe": "REAL-TIME" }, "last_trade": { "sip_timestamp": 1775073506446593186, "conditions": [ 227 ], "price": 0.02, "size": 50, "exchange": 312, "timeframe": "REAL-TIME" }, "open_interest": 14078, "underlying_asset": { "change_to_break_even": 5.235, "last_updated": 1775123022067431274, "price": 94.79, "ticker": "NFLX", "timeframe": "DELAYED" } }, { "break_even_price": 97.255, "day": { "change": -0.45, "change_percent": -65.2, "close": 0.24, "high": 1.11, "last_updated": 1775016000000000000, "low": 0.16, "open": 0.91, "previous_close": 0.69, "volume": 11096, "vwap": 0.3416 }, "details": { "contract_type": "call", "exercise_style": "american", "expiration_date": "2026-04-02", "shares_per_contract": 100, "strike_price": 97, "ticker": "O:NFLX260402C00097000" }, "greeks": { "delta": 0.18593220522845647, "gamma": 0.10775236828790113, "theta": -0.5784063493211438, "vega": 0.010167595059336215 }, "implied_volatility": 0.6600286584180963, "last_quote": { "ask": 0.27, "ask_size": 63, "ask_exchange": 318, "bid": 0.24, "bid_size": 60, "bid_exchange": 315, "last_updated": 1775073599203471487, "midpoint": 0.255, "timeframe": "REAL-TIME" }, "last_trade": { "sip_timestamp": 1775073599506207795, "conditions": [ 209 ], "price": 0.24, "size": 1, "exchange": 309, "timeframe": "REAL-TIME" }, "open_interest": 13473, "underlying_asset": { "change_to_break_even": 2.465, "last_updated": 1775123022067431274, "price": 94.79, "ticker": "NFLX", "timeframe": "DELAYED" } } ], "status": "OK", "request_id": "cm_adce10cb073745c7b859fc8131b203b0" } ``` ## Related workflow pages - [Options chain API](/options-chain-api) - [ETF options data API](/etf-options-data-api) - [SPY options data API](/spy-options-data-api) - [Options open interest API](/options-open-interest-api) - [Options Greeks API](/options-greeks-api) - [Put/Call Ratio API](/put-call-ratio-api)