Options API
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 |
tenant_id | query | — | optional | Admin/operator override for tenant broker dispatch; regular users use JWT tenant |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |