CuteMarkets Docs

API Reference

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

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

Option symbols are compact identifiers for very specific instruments. A single underlying can have thousands of listed contracts across expirations, strikes, call and put sides, weekly cycles, adjusted deliverables, and expired series.

Use this guide to explain OCC-style option symbols, CuteMarkets option tickers, and why contract reference data belongs beside quotes, trades, bars, and backtest fills.

Quick answer

An options contract is identified by underlying root, expiration date, call or put type, and strike price. CuteMarkets uses full contract tickers such as O:NFLX260402C00100000, where O: marks an option ticker and the remaining body follows the common OCC-style compact pattern. Do not infer all contract details from a string alone when reference data is available.

Reading the ticker

Example:

bash
O:NFLX260402C00100000
SegmentMeaning
O:CuteMarkets option ticker prefix.
NFLXUnderlying root.
260402Expiration date, YYMMDD, meaning 2026-04-02.
CContract type, call. P means put.
00100000Strike price scaled by 1000, meaning 100.000.

The compact symbol is useful for lookups and joins, but the contract reference response is the safer source for application logic. It can include expiration, strike, contract type, exercise style, shares per contract, primary exchange, correction fields, and adjusted deliverables.

Identity is more than text parsing

Parsing the symbol can answer basic questions. Reference data answers whether that instrument existed for the date you care about, what deliverable it represented, and whether corporate actions changed the standard contract assumptions.

NeedUse
Decode a known ticker for displaySymbol parser plus contract detail.
Build a historical universeContracts endpoint with as_of.
Validate a user-supplied contractContract detail endpoint.
Backtest option selectionContracts first, then quotes or trades for selected contracts.
Handle splits and mergersContract detail fields such as shares_per_contract and additional_underlyings.

Common mistakes

The first mistake is building old backtests from today's option chain. A contract universe changes through time. Weekly series are listed and delisted, expirations pass, strikes appear as the underlying moves, and adjusted contracts can remain after corporate actions. Use point-in-time contract discovery when the research date matters.

The second mistake is treating every contract as a standard 100-share equity option. Many are, but adjusted contracts can represent different deliverables. A sizing engine should read shares_per_contract and adjustment metadata instead of hard-coding 100 everywhere.

The third mistake is joining option data only by underlying ticker. NFLX is not enough. Store the full option ticker with every quote, trade, aggregate bar, snapshot, and simulated fill.

Storage checklist

For every contract selected by a system, store:

  • Full option ticker.
  • Underlying ticker.
  • Expiration date.
  • Contract type.
  • Strike price.
  • Selection timestamp or as_of date.
  • Reference response or reference version fields used by the strategy.
  • Shares per contract and any additional deliverables.
  • Endpoint and request id used to select the contract.

Official references

Related CuteMarkets docs

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 live and historical workflows for stocks, options, and WebSockets.