CuteMarkets Docs

API Reference

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

Docs

Tip: open /docs/market-data-licensing-commercial-use.md directly for raw markdown (easy copy/paste into an LLM).

Market-data licensing affects product design. The same endpoint can be appropriate for personal research, internal professional tools, customer-facing dashboards, or commercial redistribution only when the plan, terms, exchange rules, and provider agreement support that use.

This is an engineering and procurement checklist, not contract language. Confirm final obligations with the applicable CuteMarkets agreement, exchange policy, and your legal or compliance owner. For product planning, pair this page with Pricing, Terms, Live, Delayed, and Entitlements, Data Sources and OPRA, and Market Data Access Methods.

Licensing vocabulary

TermPractical meaning
Personal researchIndividual experimentation, prototyping, notebooks, and non-customer-facing evaluation
Internal professional useData used inside a business by employees or contractors
Customer displayMarket data shown to customers, subscribers, users, or external viewers
RedistributionPassing market data or materially similar derived data to another party or system outside the permitted use
Commercial useBusiness use, revenue-linked product use, paid internal tools, or customer-facing workflows depending on the agreement
EntitlementThe plan-level right to access a product, endpoint, quote field, stream, live data, or historical depth
Product scopeThe credential boundary between stocks, options, and paper-trading surfaces
Derived dataCalculations, alerts, charts, metrics, or stored outputs based on underlying market data
Display policyRules about whether and how a user interface can show live, delayed, historical, or cached values

Use case categories

Before choosing a plan, classify the workflow:

Use caseTypical questions
Individual backtestingIs the data for private research? Does the workflow need historical quotes, trades, contracts, and aggregates?
Internal trading researchWho can access the results? Are strategy artifacts shared inside a company? Are quotes or derived signals stored?
Internal operations dashboardAre employees viewing live or delayed market data? Which product scopes and quote endpoints are visible?
Customer-facing appAre users seeing live, delayed, or historical prices? Is the display gated by plan and user role?
Alerting productAre alerts derived from quotes, trades, chains, volume, open interest, IV, or Greeks? Are alerts sent externally?
Resale or redistributionIs the product passing raw or near-raw data to customers, vendors, or downstream systems?
Paper tradingAre simulated fills using live quotes, delayed quotes, historical quotes, or cached data?

Each category has different operational needs. A personal notebook might only need Historical Options Data API. A customer-facing scanner needs Real-Time Options Data API, WebSockets, plan-aware display labels, support expectations, and commercial review.

Entitlement model

An entitlement gate answers a simple question: can this key, product, plan, endpoint, and user display this field at this freshness level?

Store entitlement state beside the data:

bash
{
  "provider": "cutemarkets",
  "product": "options",
  "plan": "commercial",
  "endpoint": "option_chain",
  "freshness": "live",
  "quotes": true,
  "websockets": true,
  "viewer_scope": "customer_display",
  "reviewed_at": "2026-06-04"
}

This metadata belongs in logs, artifacts, support tickets, and user-facing freshness labels. It prevents a dashboard from showing a cached Expert quote as if a different viewer newly requested live Commercial data. It also helps engineers explain why an endpoint returns an entitlement error, an unavailable field, a delayed response, or a stale state.

See Authentication, Rate Limits, Live, Delayed, and Entitlements, and Market Data Ingestion and Caching for implementation details.

Live, delayed, historical, cached, and derived data

Freshness labels are part of commercial clarity:

  • Live means the plan and endpoint support current market data for that product.
  • Delayed means the response intentionally lags the live market.
  • Historical means the request targets past windows or archived records.
  • Cached means the application is serving stored data from a prior request.
  • Backfilled means REST repaired a missed stream or missing local interval.
  • Derived means the value is calculated from one or more market-data inputs.

A customer-facing app needs these labels because a chart, alert, quote, trade table, scanner score, volume/OI ratio, IV rank, or backtest result can be misunderstood without access context. The same terminology appears in Real-Time Options System Design, Real-Time Stock Data Watchlist Architecture, and Options Flow False Positives.

Quote access and display boundaries

Quotes deserve special attention. A last trade is a print; a quote is bid/ask market context. Quote access can require a different plan or product scope from trades or bars.

When planning a commercial workflow, ask:

  • Are bid, ask, midpoint, spread percent, and quote age displayed to users?
  • Are quotes used only internally for a fill model?
  • Are quote-derived values, such as spread score or liquidity label, displayed externally?
  • Does the plan include quote access for stocks, options, or both?
  • Does a WebSocket subscription deliver the same fields as the REST response?
  • Are delayed quote fields labeled as delayed?
  • Are historical quote windows stored for replay or audit?

Use Quotes, Stock Trades and Quotes, Why Option Quotes Matter More Than Last Price, and Quote-Aware Options Backtests to keep quote terminology precise.

Customer-facing product checklist

Before putting market data into a customer-facing product, prepare a short due-diligence file:

AreaEvidence to collect
Product scopeStocks, options, paper trading, or combined stock/options workflow
Access methodsREST, WebSocket, cache, export, or vendor flat file
FreshnessLive, delayed, historical, cached, backfilled, stale, unavailable
DisplayWhich raw and derived fields are visible to external users
StorageWhich values are stored, for how long, and in what artifact
RedistributionWhether raw or near-raw records leave the product boundary
User rolesInternal admin, customer user, contractor, public visitor
Support pathWho handles entitlement errors, missing data, outages, and billing questions
DocumentationLinks to Pricing, Terms, Status, Support, and endpoint docs

The file is useful even before formal review because it makes hidden assumptions visible to engineering, product, and support teams.

Procurement questions

Use these questions when comparing providers:

  • What exact asset classes and endpoint groups are included?
  • Are options, stocks, and quotes priced or entitled separately?
  • What is live, delayed, historical, cached, or unavailable on each plan?
  • Are WebSockets included, limited, or commercial-only?
  • Are flat files, exports, or bulk archives included?
  • Is customer display allowed on the plan being evaluated?
  • Is internal professional use different from individual research?
  • Are derived alerts, rankings, or scanner outputs covered?
  • What support channel handles data-quality tickets?
  • How are outages, corrections, late prints, or missing quote windows communicated?
  • Does the provider expose an OpenAPI spec or other machine-readable docs?
  • Does the agreement cover the actual product architecture?

For CuteMarkets comparison flows, link this checklist with Options Data API Evaluation Framework, Options Data Vendor Checklist, Options Data Provider Evaluation, Stock Data Provider Evaluation, and Market Data API Due Diligence Checklist.

Engineering controls

Commercial-use risk often appears as an engineering bug:

  • a cached live quote shown to a user without a freshness label
  • an internal-only field exposed in an external API response
  • a WebSocket reconnect replayed as live state
  • a stock quote plan assumed to include option quotes
  • a derived scanner score that effectively republishes raw market fields
  • a historical backtest artifact downloaded by a user who is not entitled to the underlying quote data
  • a support export that includes raw response payloads

Add controls at the boundary:

  • product-scoped API keys
  • server-side entitlement checks
  • user-role checks before display
  • freshness labels in response objects
  • audit logs for quote and stream access
  • field allowlists for customer-facing APIs
  • cache partitioning by plan and product
  • separate internal artifacts from public exports

These controls fit naturally with Authentication, OpenAPI, Market Data Ingestion and Caching, and Paper Trading API.

Related reading

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.