GET/v1/options/quotes
Batch fetch multiple option quotes
Retrieves quotes for up to 20 comma-separated OCC option symbols in a single request. A batch counts as one request however many symbols it names; duplicate symbols are queried and returned once. Unknown symbols are returned in the missing array. Result order of quotes is unspecified.
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 |
|---|---|---|---|
| symbols | string | query | Comma-separated list of up to 20 OCC option symbols. Exceeding 20 returns 400 too_many_symbols. |
Request Examples
curl -s -H "Authorization: Bearer $WSO_API_KEY" \
"https://api.wheelstrategyoptions.com/v1/options/quotes?symbols=SPY270917C00800000,SPY270917P00750000"Try it
GET/v1/options/quotes
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 |
|---|---|---|---|
| quotes | object[] | No | Array of returned option contract quotes. |
| missing | string[] | No | Array of requested option symbols that were not found in the database. |
Response Example
json
{
"quotes": [
{
"optionSymbol": "AAPL261009C00110000",
"underlying": "AAPL",
"expiration": "2026-10-09",
"strike": 110,
"side": "call",
"bid": 228.75,
"ask": 231.55,
"mid": 230.15,
"last": 224.9,
"volume": 0,
"openInterest": 1,
"iv": 383.07,
"delta": 1,
"gamma": 0,
"theta": 0,
"vega": 0,
"rho": 0.003015,
"underlyingPrice": 340.6,
"spreadPercent": 1.22,
"dte": 0,
"asOf": "2026-10-09T00:15:46.697984Z"
},
{
"optionSymbol": "AAPL261009P00110000",
"underlying": "AAPL",
"expiration": "2026-10-09",
"strike": 110,
"side": "put",
"bid": 0,
"ask": 0.01,
"mid": 0.005,
"last": 0.01,
"volume": 0,
"openInterest": 1100,
"iv": 204.49,
"delta": 0,
"gamma": 0,
"theta": 0,
"vega": 0,
"rho": 0,
"underlyingPrice": 340.6,
"spreadPercent": 200,
"dte": 0,
"asOf": "2026-10-09T00:15:46.697984Z"
}
],
"missing": []
}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` (no subscription record), `subscription_inactive` (subscription not active), `trial_ended` (trial has expired), `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` (per-minute limit), `too_many_concurrent_requests` (in-flight cap), `too_many_auth_failures`. |
| 500 | Internal Server Error. Unhandled internal server or database error. |
| 503 | Service Unavailable. Backing database, cache, or external provider connection unavailable. |