CuteMarkets Docs

API Reference

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

Docs

Tip: open /docs/stock-data-provider-evaluation.md directly for raw markdown (easy copy/paste into an LLM).

A stock data provider comparison should start with the workflow, not the brand name. A watchlist, a historical backtest, a quote-aware dashboard, an options strategy, and a customer-facing application all need different evidence. Use this guide with the Stocks Data API, Historical Stock Data API, Real-Time Stock Data API, Stock Trades API, Stock Quotes API, and Stock and Options Data Join Workflow.

Start with the system boundary

Before comparing vendors, write down the system that will consume the data.

WorkflowRequired stock data objectsExtra checks
Watchlistsnapshots, movers, ticker referencefreshness label, stale-row behavior, active ticker status
Historical researchaggregates, trades, open-close, indicatorsadjusted flag, date window, pagination, corporate-action notes
Quote-aware appquotes, last quote, trades, snapshotsbid/ask spread, quote age, plan entitlement
Stock-plus-options strategystock bars, stock trades, stock quotes, option chains, option quotessignal timestamp, OCC symbol, option quote window, reject reasons
Commercial productall required endpoints plus support and licensingproduct terms, display rules, support path, status monitoring

A broad financial data provider can look stronger in a catalog view while still being awkward for a narrow workflow. A smaller provider can fit better if it returns the exact objects your product needs with cleaner request semantics.

Coverage and reference data

Ticker reference is not decoration. It is the layer that prevents scanners and dashboards from treating every typed symbol as an active security. A stock data provider should make it clear how to request ticker lists, ticker types, ticker details, active status, and related tickers. CuteMarkets exposes this path in Stock Reference, and the product hub links it from Stocks Data API.

When evaluating a provider, ask:

  • Can the API resolve active and inactive tickers?
  • Are ticker types and related tickers documented?
  • Does the response separate reference data from market data?
  • Can a user build symbol search before requesting snapshots or bars?
  • Are pagination and cursor behavior documented for long lists?

The comparison is weaker if it only checks whether a provider has "stock prices." Reference data decides whether a production watchlist or research universe can stay clean over time.

Snapshots and movers

Snapshots and movers are current-state objects. They are useful for watchlists, dashboards, screeners, and alert previews. They are not proof of what the market looked like at a historical signal timestamp.

Use Stock Snapshots to evaluate how a provider returns full-market snapshots, ticker snapshots, and mover lists. Then confirm how the provider labels live versus delayed data. CuteMarkets explains that boundary in Live, Delayed, and Entitlements and in the Real-Time Stock Data API page.

Provider questions:

  • Does the snapshot response carry enough timestamp context?
  • Are gainers and losers defined consistently?
  • Does the product explain delayed data clearly?
  • Can stale rows be identified before they trigger an alert?
  • Can the snapshot hand off to trades, quotes, bars, or options chains?

For options workflows, a stock snapshot often initializes the underlying state before the application requests Options Chain API, Options Data API, or Option Chain docs.

Trades and quotes

Stock trades and stock quotes answer different questions. A trade print says something happened. A quote says what bid/ask market was displayed. A last trade can be useful for a compact status panel, but it should not be presented as a full current market when a bid/ask quote is required.

Use Stock Trades and Quotes, Stock Trades API, and Stock Quotes API when comparing provider semantics.

ObjectWhat it answersCommon mistake
Trade historyWhat printed during the time window?Treating prints as executable liquidity
Last tradeWhat was the latest observed print?Calling it the current bid/ask market
Quote historyWhat bid and ask were available?Ignoring quote age and spread width
Last quoteWhat is the latest displayed bid/ask?Assuming access exists on every plan

If a workflow is quote-sensitive, entitlement matters. In CuteMarkets, stock quote endpoints require Expert or Commercial stock access. Options quotes have their own product boundary, documented in Quotes and Pricing.

Aggregates, open-close, and indicators

Historical stock research usually starts with bars. A serious comparison should record whether bars are adjusted, what timespan was requested, how missing intervals behave, how grouped bars are returned, and whether indicators are calculated over the expected window.

Use Stock Aggregates and Indicators, Historical Stock Data API, and Stocks Data API to map this layer.

Terms to keep explicit:

  • adjusted aggregate
  • raw aggregate
  • open-close record
  • grouped bar
  • previous-day bar
  • SMA
  • EMA
  • MACD
  • RSI
  • indicator window
  • corporate-action handling

Bars support signal generation, charting, volume comparison, and event review. They should not be used as proof of an option fill. When the stock signal drives an option trade, move into Stock and Options Data Join Workflow, Historical Options Replay Runbook, and Backtesting Execution Realism.

Live, delayed, historical, and commercial use

A provider evaluation should separate freshness from permission. A plan may return delayed data, live data, historical data, quote endpoints, WebSockets, or commercial rights. These are not the same thing.

Record:

  • product name and plan name
  • live or delayed state
  • historical lookback
  • quote access
  • WebSocket access
  • request limits
  • commercial-use permission
  • support path
  • status or incident history

CuteMarkets documents these boundaries through Pricing, Rate Limits and Plans, Authentication, WebSockets, Live, Delayed, and Entitlements, Market Data Access Methods, Market Data Ingestion and Caching, Market Hours, Timestamps, and Timezones, Market Data Corrections and Missing Data, and Market Data Licensing and Commercial Use.

Reusable provider test

Run the same small workflow through every stock data provider:

  1. Resolve AAPL through ticker reference.
  2. Load the current stock snapshot.
  3. Pull one day of 5-minute adjusted aggregates.
  4. Pull trades around a known timestamp.
  5. Pull quotes around the same timestamp if the plan allows it.
  6. Request an indicator window.
  7. Join the stock signal to one option expiration and chain request.
  8. Store timestamps, plan labels, pagination cursors, and missing-data behavior.

The result should be a comparison artifact, not a vibe. If the provider cannot produce the objects your workflow needs, a lower price or larger catalog does not solve the integration problem.

Related CuteMarkets pages

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.