> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Data Endpoints

> Price snapshots, historical bars, corporate actions, reference data, estimates, calendar, indices, and search.

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

## 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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/reference?symbol=AAPL"
```

***

## GET /v1/market/estimates

Analyst consensus estimates for a symbol. Returns EPS, revenue, and EBITDA consensus values with high/low range.

| Parameter | Type   | Required | Description                                                               |
| --------- | ------ | -------- | ------------------------------------------------------------------------- |
| `symbol`  | string | yes      | Ticker symbol.                                                            |
| `period`  | string | no       | Fiscal period. One of `FY0`, `FY1`, `FY2`, `Q0`, `Q1`. Defaults to `FY1`. |

### Example

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/estimates?symbol=AAPL&period=FY1"
```

***

## 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

```bash theme={null}
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/indices

Supported index inventory. Returns index metadata, rights posture, and sync cadence.

| Parameter        | Type    | Required | Description                                                                           |
| ---------------- | ------- | -------- | ------------------------------------------------------------------------------------- |
| `supported_only` | boolean | no       | When `true`, return only indices with public constituent export. Defaults to `false`. |

### Example

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/indices?supported_only=true"
```

***

## GET /v1/market/indices/constituents

Index constituent listings. See the [Index Constituents](/index-constituents) page for rights model and support posture details.

| Parameter | Type                 | Required | Description                                                 |
| --------- | -------------------- | -------- | ----------------------------------------------------------- |
| `"index"` | string               | yes      | Index code (e.g., `NDX`).                                   |
| `limit`   | positive integer     | no       | Maximum constituents to return. Defaults to `25`, max `50`. |
| `cursor`  | non-negative integer | no       | Pagination offset from a previous response.                 |

### Example

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/indices/constituents?index=NDX&limit=10"
```

***

## GET /v1/market/universe

Browse the full ticker universe with pagination, filtering, and search. Returns identifiers (CIK, FIGI), sector/industry classification, market cap, and listing status for every tracked ticker.

| Parameter  | Type                 | Required | Description                                             |
| ---------- | -------------------- | -------- | ------------------------------------------------------- |
| `exchange` | string               | no       | Filter by primary exchange (e.g. `XNYS`, `XNAS`).       |
| `type`     | string               | no       | Filter by security type (e.g. `CS`, `ETF`).             |
| `sector`   | string               | no       | Filter by GICS-style sector (e.g. `Technology`).        |
| `industry` | string               | no       | Filter by industry classification.                      |
| `active`   | boolean              | no       | Filter by active listing status.                        |
| `has_figi` | boolean              | no       | Only tickers with a composite FIGI.                     |
| `has_cik`  | boolean              | no       | Only tickers with a SEC CIK.                            |
| `search`   | string               | no       | Case-insensitive search across symbol and company name. |
| `limit`    | positive integer     | no       | Page size. Defaults to `100`, max `1000`.               |
| `cursor`   | non-negative integer | no       | Pagination offset.                                      |

### Example

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/universe?exchange=XNYS&sector=Technology&limit=25"
```

***

## GET /v1/market/earnings-calendar

Earnings events within a date range. Returns consensus estimates, actuals, surprise percentages, and analyst counts for EPS and revenue metrics.

| Parameter   | Type    | Required | Description                                     |
| ----------- | ------- | -------- | ----------------------------------------------- |
| `date_from` | string  | yes      | Start date in `YYYY-MM-DD` format.              |
| `date_to`   | string  | yes      | End date in `YYYY-MM-DD` format.                |
| `symbol`    | string  | no       | Filter to a single ticker symbol.               |
| `limit`     | integer | no       | Maximum results. Defaults to `100`, max `1000`. |

### Example

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/earnings-calendar?date_from=2026-03-24&date_to=2026-03-31"
```

***

## GET /v1/market/financials

<Warning>
  Deprecated. Use `GET /v1/companies/financials` instead. This endpoint will be removed in a future API version.
</Warning>

Financial statements (income statement, balance sheet, cash flow) for a symbol.

| Parameter   | Type    | Required | Description                                                   |
| ----------- | ------- | -------- | ------------------------------------------------------------- |
| `symbol`    | string  | yes      | Ticker symbol.                                                |
| `statement` | string  | no       | One of `income`, `balance`, `cashflow`. Defaults to `income`. |
| `period`    | string  | no       | One of `annual`, `quarterly`. Defaults to `annual`.           |
| `limit`     | integer | no       | Number of periods to return. Defaults to `4`.                 |

### Example

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/market/financials?symbol=AAPL&statement=income&period=annual&limit=4"
```

***

## 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

```bash theme={null}
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](/volatility-score) page for methodology and quality controls.

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

### Example

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/signals/volatility?ticker=AAPL"
```