Stocks REST Overview
CuteMarkets supports stock market-data endpoints under /v1/stocks/. Stocks are a separate subscription product from options, with their own Stocks API keys, while sharing the same account, response envelope, pagination model, and dashboard billing workflow.
Base path
bash
https://api.cutemarkets.com/v1/stocks/
Authenticate with a Stocks API key:
bash
curl "https://api.cutemarkets.com/v1/stocks/snapshot/AAPL/" \
-H "Authorization: Bearer YOUR_API_KEY"
Plans
Stocks use the same plan ladder as options, purchased independently.
| Stock plan | Requests / min | Requests / day | Freshness | Lookback | Quotes |
|---|---|---|---|---|---|
| Free | 10 | 5,000 | 15 min delayed | 3 years | - |
| Developer | Unlimited | Unlimited | 15 min delayed | 7 years | - |
| Expert | Unlimited | Unlimited | Live | 10 years | Yes |
| Commercial | Unlimited | Unlimited | Live | 10 years | Yes + commercial applications |
Quote endpoints require an Expert or Commercial Stocks API subscription. A paid options subscription does not unlock stock quotes by itself.
Endpoint map
| Category | Endpoints |
|---|---|
| Snapshots | /snapshot/, /snapshot/{ticker}/, /snapshot/movers/{direction}/ |
| Ticker reference | /tickers/, /tickers/types/, /tickers/{ticker}/, /tickers/{ticker}/related/ |
| Trades | /trades/{ticker}/, /trades/{ticker}/last/ |
| Quotes | /quotes/{ticker}/, /quotes/{ticker}/last/ |
| Aggregates | /aggs/grouped/{date}/, /aggs/{ticker}/prev/, /aggs/{ticker}/{multiplier}/{timespan}/{from_date}/{to_date}/ |
| Open-close | /open-close/{ticker}/{date}/ |
| Indicators | /indicators/sma/{ticker}/, /indicators/ema/{ticker}/, /indicators/macd/{ticker}/, /indicators/rsi/{ticker}/ |
Response envelope
Most stock endpoints return the standard CuteMarkets envelope:
bash
{
"status": "OK",
"request_id": "cm_6a7e466379af0a71039d60cc78e72282",
"results": []
}
Paginated endpoints include next_url when more rows are available. Request that URL as-is with the same Authorization header.
bash
{
"status": "OK",
"request_id": "cm_6a7e466379af0a71039d60cc78e72282",
"results": [],
"next_url": "https://api.cutemarkets.com/v1/stocks/trades/AAPL/?page=..."
}
Limit defaults and caps
| Endpoint family | Default limit | Maximum limit |
|---|---|---|
| Trades and quotes | 1000 | 10000 |
| Aggregates | 5000 | 10000 |
| Indicators | 10 | 1000 |
| Ticker reference | 100 | 1000 |