GET
/v3/snapshot/options/{underlyingAsset}/{optionContract}
Options Contract Snapshot
Snapshot for a specific options contract (incl greeks/IV/OI where available).
Endpoint Details
| HTTP Method |
GET |
| Path |
/v3/snapshot/options/{underlyingAsset}/{optionContract} |
| Version |
v3 |
| Minimum Plan |
free |
Path Parameters
| Parameter |
Required |
Description |
Example |
underlyingAsset |
Required |
The underlying asset ticker (e.g., AAPL for options) |
AAPL |
optionContract |
Required |
The specific options contract identifier |
O:AAPL230616C00150000 |
Query Parameters
| Parameter |
Type |
Required |
Description |
api_key |
string |
Required |
Your API key for authentication |
limit |
integer |
Optional
|
Maximum number of results to return |
sort |
string |
Optional
|
Sort order (asc or desc) |
Example Request
curl "https://mail.tradeiqai.com/api/v3/snapshot/options/AAPL/O:AAPL230616C00150000?api_key=YOUR_API_KEY"
Note: Replace YOUR_API_KEY with your actual API key.
Response Attributes
| Attribute |
Type |
Description |
ok |
boolean |
Indicates if the request was successful |
data.status |
string |
The status of the request response (typically "OK") |
data.request_id |
string |
A unique request ID assigned by the server |
data.results |
object|array |
Object or array containing endpoint-specific data |
data.next_url |
string (optional) |
URL for pagination to fetch the next page of results |
Example Response
{
"ok": true,
"data": {
"status": "OK",
"request_id": "abc123def456...",
"results": {
// Endpoint-specific data structure
},
"next_url": "https://api.tradeiqai.com/...?cursor=xyz789"
}
}