Quotes
Expert or Commercial plan required. This endpoint is available on Expert and Commercial plans.
Historical National Best Bid and Offer (NBBO)–style quotes for one options contract: bid and ask price, sizes, exchange ids, sequence number, and nanosecond SIP timestamps. Use it to study spread behavior, liquidity, backtests, and strategy refinement.
Example Endpoint
/v1/options/quotes/O:NFLX260402C00075000/?limit=10Endpoint
bash
GET /v1/options/quotes/{options_ticker}
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
options_ticker | string | Yes | Full options ticker (for example O:NFLX260402C00075000). Encode : as %3A if your HTTP client requires it. |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
timestamp | string | No | Filter by time: YYYY-MM-DD or a nanosecond Unix timestamp string. |
timestamp.gte | string | No | Lower bound (date or nanosecond timestamp). |
timestamp.gt | string | No | Strictly greater than. |
timestamp.lte | string | No | Upper bound. |
timestamp.lt | string | No | Strictly less than. |
sort | string | No | Field used for ordering. |
order | string | No | Sort direction for sort. |
limit | integer | No | Maximum quotes returned. Default 1000, maximum 10000. |
page | string | No | Pagination continuation: use the URL in next_url, or pass the page query value from that URL here. |
Response (success)
| Field | Type | Description |
|---|---|---|
status | string | Outcome (for example OK). |
request_id | string | Unique identifier for this request, assigned by CuteMarkets. |
results | array | Quote rows, ordered per sort / order. |
next_url | string | When more quotes exist, full URL for the next page. |
Use limit and time-window filters per page; follow next_url when present.
Each element of results:
| Field | Type | Description |
|---|---|---|
bid_price | number | Best bid (premium per share). |
ask_price | number | Best ask. |
bid_size | number | Bid size in round lots (often 100 shares per lot unless your venue defines otherwise). A size of 2 means two round lots at that bid. |
ask_size | number | Ask size in the same round-lot units. |
bid_exchange | integer | Exchange id for the bid side. |
ask_exchange | integer | Exchange id for the ask side. |
sequence_number | integer | Monotonic sequence for quote events for this symbol (not always contiguous). |
sip_timestamp | integer | Nanosecond Unix time when the SIP received this quote. |
Plan requirement (Expert or Commercial)
If the API key is not on Expert or Commercial, CuteMarkets returns 403:
bash
{
"status": "ERROR",
"request_id": "cm_4ba72c263423499ea3f5c54d03eda8d1",
"error": {
"code": "forbidden",
"message": "This endpoint requires an Expert or Commercial subscription."
}
}
Related workflow pages
- Historical options quotes API
- Why option quotes matter more than last price
- Quote-aware options fills
Upgrade to Expert (€99/mo yearly or €119/mo monthly) for live quotes data, or Commercial (€399/mo yearly or €469/mo monthly) when the same data powers commercial applications.
Example requests
bash
curl \
"https://api.cutemarkets.com/v1/options/quotes/O:NFLX260402C00075000/?limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"
Time window (example):
bash
curl \
"https://api.cutemarkets.com/v1/options/quotes/O:NFLX260402C00075000/?timestamp.gte=2026-03-01×tamp.lte=2026-03-31&limit=500&sort=timestamp&order=desc" \
-H "Authorization: Bearer YOUR_API_KEY"
Sample response (success)
bash
{
"results": [
{
"ask_exchange": 323,
"ask_price": 0.28,
"ask_size": 10,
"bid_exchange": 316,
"bid_price": 0.25,
"bid_size": 1,
"sequence_number": 789539218,
"sip_timestamp": 1645119125346243600
},
{
"ask_exchange": 301,
"ask_price": 0.27,
"ask_size": 1,
"bid_exchange": 323,
"bid_price": 0.24,
"bid_size": 10,
"sequence_number": 788994206,
"sip_timestamp": 1645119118474271000
}
],
"status": "OK",
"request_id": "cm_a1b2c3d4e5f6478990a1b2c3d4e5f678"
}