Market Data Endpoints

Market data endpoints return structured, source-attributed payloads. All responses include provenance and freshness metadata.

GET /v1/market/snapshots

Latest price snapshots for one or more symbols. Returns last price, change, volume, and timestamp.

Parameter	Type	Required	Description
`symbols`	string	yes	Comma-separated ticker symbols. Max 50 per request.

Example

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/snapshots?symbols=AAPL,MSFT,GOOG"

GET /v1/market/bars

Historical OHLCV bars for a single symbol.

Parameter	Type	Required	Description
`symbol`	string	yes	Ticker symbol.
`timeframe`	string	no	Bar resolution. One of `1D`, `1W`, `1M`. Defaults to `1D`.
`start`	string	no	Start date in `YYYY-MM-DD` format.
`end`	string	no	End date in `YYYY-MM-DD` format.
`limit`	integer	no	Maximum bars to return. Defaults to `252`.

Example

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/bars?symbol=AAPL&timeframe=1D&start=2025-01-01&end=2025-12-31"

GET /v1/market/corporate-actions

Dividends, splits, and spinoffs for a symbol or across the market within a date range.

Parameter	Type	Required	Description
`symbol`	string	no	Ticker symbol. Omit for market-wide results.
`type`	string	no	Action type filter. One of `dividend`, `split`, `spinoff`. Omit for all types.
`start`	string	no	Start date in `YYYY-MM-DD` format.
`end`	string	no	End date in `YYYY-MM-DD` format.
`limit`	integer	no	Maximum results. Defaults to `100`.
`cursor`	string	no	Pagination cursor from a previous response.

Example

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/corporate-actions?symbol=AAPL&type=dividend&start=2025-01-01"

GET /v1/market/reference

Company reference data including name, sector, industry, exchange, and identifiers.

Parameter	Type	Required	Description
`symbol`	string	yes	Ticker symbol.

Example

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/reference?symbol=AAPL"

GET /v1/market/calendar

Trading calendar for a given exchange. Returns trading days, early closes, and holidays.

Parameter	Type	Required	Description
`exchange`	string	no	Exchange code. Defaults to `NYSE`.
`start`	string	no	Start date in `YYYY-MM-DD` format.
`end`	string	no	End date in `YYYY-MM-DD` format.

Example

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/calendar?exchange=NYSE&start=2026-01-01&end=2026-12-31"

GET /v1/market/search

Ticker and company name search. Returns matching symbols with exchange, name, and type metadata.

Parameter	Type	Required	Description
`q`	string	yes	Search query. Matches against ticker and company name.
`limit`	integer	no	Maximum results. Defaults to `10`.

Example

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/search?q=apple&limit=5"

GET /v1/signals/volatility

SEC API Volatility Score for a symbol. See the Volatility Score page for methodology and quality controls.

Parameter	Type	Required	Description
`ticker`	string	yes	Ticker symbol.

Example

curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/signals/volatility?ticker=AAPL"

Plans & pricing

Products

Workflow guides

Concepts & trust

Tutorials

Migrate to SEC API

Solutions

Compare

API guides by topic

GET /v1/market/snapshots

Example

GET /v1/market/bars

Example

GET /v1/market/corporate-actions

Example

GET /v1/market/reference

Example

GET /v1/market/calendar

Example

GET /v1/market/search

Example

GET /v1/signals/volatility

Example

​GET /v1/market/snapshots

​Example

​GET /v1/market/bars

​Example

​GET /v1/market/corporate-actions

​Example

​GET /v1/market/reference

​Example

​GET /v1/market/calendar

​Example

​GET /v1/market/search

​Example

​GET /v1/signals/volatility

​Example

GET /v1/market/snapshots

Example

GET /v1/market/bars

Example

GET /v1/market/corporate-actions

Example

GET /v1/market/reference

Example

GET /v1/market/calendar

Example

GET /v1/market/search

Example

GET /v1/signals/volatility

Example