CuteMarkets Docs

API Reference

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

Docs

Tip: open /docs/corporate-actions-adjusted-options.md directly for raw markdown (easy copy/paste into an LLM).

Read this page with Option Symbols and Contract Identity, Contracts, Market Data Corrections and Missing Data, Historical Options Data API, and Backtesting Data Quality Checklist.

Corporate actions can change what an option contract represents. A split, merger, special dividend, spinoff, liquidation, bankruptcy event, or symbol change can alter deliverables, contract size, settlement behavior, or the option symbol used by market participants.

Use this guide when building contract validation, sizing, backtesting, or support workflows for adjusted options.

Quick answer

Do not assume every equity option contract represents exactly 100 shares of the current underlying ticker. Standard contracts commonly do, but corporate actions can create adjusted contracts with different deliverables. Use contract reference fields such as shares_per_contract, additional_underlyings, correction, as_of, and the full option ticker before sizing a trade, calculating PnL, or replaying history.

What can change

Corporate actionPossible option-data effect
Forward or reverse splitStrike, deliverable, contract multiplier, or symbol can change.
Merger or acquisitionDeliverable can become cash, shares of another security, or a mixed package.
Special dividend or distributionDeliverable or strike can be adjusted.
SpinoffContract can include additional underlying components.
Bankruptcy or liquidationSettlement and expiration handling can change.
Symbol changeUnderlying or option symbol can change while historical identity remains important.

The exact adjustment is contract-specific. OCC information memos are the authoritative place to review many contract-adjustment events, while API reference fields are the application record your system needs to store.

Why adjusted options break naive systems

Naive systems usually hard-code three assumptions:

  1. One contract equals 100 shares.
  2. The current underlying ticker is the only deliverable.
  3. A parsed symbol is enough to reconstruct the instrument.

Those assumptions work until they do not. When an adjusted contract appears, sizing can be wrong, PnL can be wrong, and a backtest can select a contract that did not represent the economic exposure the strategy intended.

Application pattern

When a strategy or UI selects an option contract:

  1. Fetch contract reference data with the relevant as_of date when history matters.
  2. Store the full option ticker and reference fields.
  3. Read shares_per_contract instead of assuming 100.
  4. Preserve additional_underlyings when present.
  5. Log correction fields and request id.
  6. Reject adjusted contracts or send them to an explicit handling branch if the strategy only supports standard contracts.

For current dashboards, display adjusted contracts with a warning or detail panel. For backtests, either model adjusted contracts explicitly or exclude them with a reject reason.

Backtesting checklist

CheckWhy it matters
as_of contract lookupPrevents selecting contracts unavailable on the research date.
Full option tickerAvoids joining by underlying alone.
Deliverable fieldsProtects sizing and PnL.
Split-adjustment flag on barsKeeps price series assumptions visible.
Quote/trade timestampsConfirms market evidence after the corporate action.
Reject reasonDocuments when the engine excludes adjusted contracts.

Official references

Related CuteMarkets docs

Corporate-action handling should be cross-checked with Option Symbols and Contract Identity, Contracts, Stock Reference, and the Stock and Options Data Join Workflow. Splits, special dividends, deliverable changes, OCC symbology, adjusted strikes, and shares-per-contract all affect historical contract matching.

Adjustment handling notes

Adjusted options deserve a separate branch in application code. A split, special dividend, merger, or spinoff can alter shares per contract, deliverables, strike interpretation, and downstream PnL. When an adjusted contract appears, store the OCC memo reference when available, the full option ticker, underlying root, shares_per_contract, additional_underlyings, correction fields, and the market-data rows used after the adjustment.

Backtests can either model adjusted contracts explicitly or reject them with a named reason. The dangerous path is pretending every contract still represents 100 shares of the current ticker. Pair this page with Stock Reference, Contracts, and Stock and Options Data Join Workflow so corporate-action state stays attached to both the underlying series and the option leg.

Additional implementation review

Review the adjusted options workflow as a sequence of named data objects, not as a single helper call. The implementation should preserve split event, deliverable change, adjusted OCC symbol, effective date, quote window, trade window, and selected contract artifact. Those fields make support tickets, CI fixtures, and replay notebooks easier to compare because every step can point to the exact request and response that created the displayed value.

The main failure mode is that a backtest can compare pre-adjustment strikes with post-adjustment quotes and create a return that never existed. Before promoting the workflow, run one concrete example through discovery, retrieval, display, logging, and error handling. Keep the resulting artifact beside the code path so future changes can prove they still use the same terminology and the same market-data assumptions.

Terminology

Terms to keep straight on this page

Market-data APIs use similar words for different objects. These links keep the docs page connected to the precise CuteMarkets workflow and related reference material.

OPRA-originating data

The listed-options source context behind quotes, trades, participant records, exchange context, and consolidated option-market data.

SIP and direct feed

Market-data delivery paths that explain where consolidated equities and options records originate before a normalized API returns them.

Quote, trade, aggregate

Three different price semantics: executable bid/ask market, printed transaction, and bar-level summary.

Quote/trade condition

The sale condition, quote condition, exchange id, correction, sequence, and timestamp context attached to market-data rows.

Contract identity

The OCC symbol, expiration, strike, side, root, and reference data needed to preserve the exact option being studied.

Entitlement gate

A plan-aware check that prevents live, quote, WebSocket, or historical behavior from being implied when the product does not include it.

Access method

The delivery mode for data, such as REST request, WebSocket stream, historical window, flat file, or local cache.

Backfill window

A timestamp-bounded REST request used to repair or complete data after a stream gap, retry, deploy, or cache miss.

Session label

A premarket, regular, after-hours, closed, half-day, holiday, or unknown tag attached to a market-data timestamp.

Data-quality reject

A logged reason for skipping a candidate because required contracts, quotes, timestamps, pagination, or entitlements failed policy.

Commercial-use boundary

The product, plan, display, redistribution, and customer-facing use context that must be reviewed before shipping market data.

Adjusted option deliverable

The changed deliverable or contract terms that can appear after splits, mergers, special dividends, or other corporate actions.

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.