GET/v1/stocks/{symbol}/candles
Get daily stock OHLC candle bars
Retrieves daily OHLC historical candle bars for an equity ticker with volume, adjusted close, and VWAP. Supports date filtering (from/to), limit clamping, and sort order (asc/desc).
Endpoint Usage & Plan Rules
Plan Access
Included in Basic
Active subscription
Result Clamping
Not Clamped
Full response returned
Parameters
Required Parameters
| Name | Type | Location | Description |
|---|---|---|---|
| symbol | string | path | Underlying equity ticker symbol (e.g. AAPL). |
Optional Parameters
| Name | Type | Location | Description |
|---|---|---|---|
| interval | string | query | Candle bar interval (currently only 1d is supported). |
| from | string | query | Start date in YYYY-MM-DD format. |
| to | string | query | End date in YYYY-MM-DD format. |
| limit | integer | query | Maximum number of daily bars to return (1-1260, default 250). Note: 'timeseries' is supported as an alias for 'limit'. Clamped if exceeded. |
| order | string | query | Sort order: asc (oldest first, default for charts) or desc (newest first). |
Request Examples
curl -s -H "Authorization: Bearer $WSO_API_KEY" \
"https://api.wheelstrategyoptions.com/v1/stocks/AAPL/candles?limit=30&order=asc"Try it
GET/v1/stocks/{symbol}/candles
Included in BasicAdd your API key to send.
Response
Send a request to see the live response, its status, timing, and rate-limit headers.
Response Attributes (200 OK)
| Field | Type | Nullable | Description |
|---|---|---|---|
| symbol | string | No | Underlying equity ticker symbol. |
| interval | string | No | Bar interval (1d for daily OHLC). |
| from | string | No | Start date of the candle series (YYYY-MM-DD). |
| to | string | No | End date of the candle series (YYYY-MM-DD). |
| count | integer | No | Total number of daily OHLC bars returned. |
| bars | object[] | No | List of daily OHLC candle bars. |
Error Responses
| Status | Description |
|---|---|
| 400 | Bad Request. The request body, query parameters, or path values violated validation constraints. |
| 401 | Unauthorized. Missing, malformed, or invalid API key credential. |
| 403 | Forbidden. Rejection reasons: `subscription_required`, `subscription_inactive`, `trial_ended`, `plan_upgrade_required` (with `required_plan`), `wrong_credential_type`, `origin_forbidden` (origin authentication failed). |
| 404 | Not Found. Requested resource, ticker symbol, or option contract does not exist. |
| 405 | Method Not Allowed. Returned with an `Allow` header when an unsupported HTTP method is used. Error code: `method_not_allowed`. (HEAD is served on all GET routes and counts against the rate limit like GET.) |
| 429 | Too Many Requests. Rejection reasons: `rate_limited` (exceeded per-minute rate limit or per-IP rate limit), `too_many_auth_failures` (edge lockout). |
| 500 | Internal Server Error. Unhandled internal server or database error. |
| 502 | Bad Gateway. Upstream market data provider failure. |
| 503 | Service Unavailable. Backing database, cache, or external provider connection unavailable. |