CuteMarkets Docs

API Reference

Everything you need to integrate market data, build faster, and scale.

Tip: open /docs/option-contract-snapshot.md directly for raw markdown (easy copy/paste into an LLM).

Option contract snapshot

Returns a single options contract snapshot: break-even level, day stats, contract details, Greeks, implied volatility, open interest, latest quote and trade when your plan includes them, and underlying context. Use it to evaluate one leg, compare risk, or feed models without pulling the full chain.

Example Endpoint

/v1/options/snapshot/NFLX/O:NFLX260410C00060000/

Endpoint

bash
GET /v1/options/snapshot/{underlying}/{option_contract}

Path parameters

ParameterTypeRequiredDescription
underlyingstringYesUnderlying equity symbol (for example NFLX). Must match the root symbol of the option ticker.
option_contractstringYesFull OCC-style options ticker (for example O:NFLX260410C00060000). It must belong to underlying. In URLs, encode : as %3A if your client requires it. If the contract is unknown or delisted, the API returns 404.

Query parameters

None. The path identifies the underlying and the option contract.

Response

Top-level fields:

FieldTypeDescription
statusstringOutcome of the request (for example OK).
request_idstringUnique identifier for this request, assigned by CuteMarkets.
resultsobjectOne contract snapshot (not an array).

Fields on results (nested objects appear when that data is available for the contract):

FieldTypeDescription
break_even_pricenumberUnderlying price at which the position breaks even (call: strike + premium; put: strike − premium).
dayobjectLatest daily bar: open, high, low, close, volume, VWAP, change, change percent, previous close, last_updated (nanoseconds).
detailsobjectticker, contract_type, exercise_style, expiration_date, strike_price, shares_per_contract.
greeksobjectdelta, gamma, theta, vega when available. Deep ITM or illiquid contracts may omit some values.
implied_volatilitynumberImplied volatility implied by the option price, when available.
last_quoteobjectMost recent NBBO-style quote (bid/ask, sizes, exchanges, midpoint, last_updated, timeframe) when quotes are enabled for your plan.
last_tradeobjectMost recent trade (price, size, exchange, sip_timestamp, conditions, timeframe) when trades are enabled for your plan.
open_interestnumberOpen interest from the last reporting cycle.
underlying_assetobjectUnderlying reference: ticker, price, change_to_break_even, last_updated, timeframe.
fmvnumberFair market value estimate when provided for your subscription tier.
fmv_last_updatedintegerNanosecond timestamp of the last FMV update, when fmv is present.

Example request

bash
curl \
  "https://api.cutemarkets.com/v1/options/snapshot/NFLX/O%3ANFLX260402C00075000/" \
  -H "Authorization: Bearer YOUR_API_KEY"

Many shells accept the colon literally inside quotes:

bash
curl \
  "https://api.cutemarkets.com/v1/options/snapshot/NFLX/O:NFLX260402C00075000/" \
  -H "Authorization: Bearer YOUR_API_KEY"

Sample response

bash
{
  "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"
    }
  },
  "status": "OK",
  "request_id": "cm_a1b2c3d4e5f6478990a1b2c3d4e5f678"
}

Related workflow pages

Next steps

Move from the docs into the product workflow

If you are evaluating the API rather than implementing a specific endpoint right now, the product pages map the live, historical, and chain workflows directly.