Options API
Auto-generated from
openapi-snapshot.json. Do not edit by hand — changes are overwritten byscripts/docs/generate_api_reference.py.
1 endpoints in this group.
GET /api/options/chain/{symbol}
Get Options Chain
Return a typed options chain for symbol filtered by the query.
Cache strategy is delta-TTL: 30s during regular trading hours, 5min
off-hours. Cache hits are flagged on the response (cache_hit).
Errors map to a sanitized envelope via the FastAPI exception handler:
400— malformed query (bad symbol, dte_min > dte_max, etc.)502— upstream Schwab failure
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
symbol | path | string | required | Underlying ticker |
expiry | query | — | optional | YYYY-MM-DD; filter to one expiration |
dte_min | query | — | optional | Minimum days to expiration |
dte_max | query | — | optional | Maximum days to expiration |
strike_min | query | — | optional | Lower strike bound (inclusive) |
strike_max | query | — | optional | Upper strike bound (inclusive) |
side | query | string | optional | calls |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |