Market Data API
5 endpoints in this group.
GET /api/market-data/1s
Get 1S Bars
Return 1-second OHLCV bars for the given symbol and time range. Range must be <= 24 hours. Returns empty list if no data.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
symbol | query | string | required | Equity symbol e.g. AAPL |
from | query | — | optional | ISO 8601 start time |
to | query | — | optional | ISO 8601 end time |
limit | query | integer | optional | Max rows to return |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
402 | Payment Required |
422 | Validation Error |
GET /api/market-data/l2
Get L2
Return the latest aggregated orderbook snapshot for symbol.
Aggregation merges same-price levels, sorts bids desc / asks asc, and
truncates each side to top (<= 10). The per-symbol 1 Hz gate ensures
the endpoint never emits more than once per second (last-write-wins).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
symbol | query | string | required | Equity symbol e.g. AAPL |
top | query | integer | optional | Levels per side, 1..10 |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/market-data/option-chain
Get Provider Option Chain
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
symbol | query | string | required | Underlying ticker |
contract_type | query | string | optional | ALL |
strike_count | query | — | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
402 | Payment Required |
422 | Validation Error |
GET /api/market-data/price-history
Get Provider Price History
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
symbol | query | string | required | Ticker symbol |
period_type | query | string | optional | |
period | query | integer | optional | |
frequency_type | query | string | optional | |
frequency | query | integer | optional |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
402 | Payment Required |
422 | Validation Error |
GET /api/market-data/quotes
Get Provider Quotes
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
symbols | query | string | required | Comma-separated ticker symbols, e.g. AAPL,MSFT |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
402 | Payment Required |
422 | Validation Error |