GET
/v3/snapshot/options/{underlyingAsset}
Options Chain Snapshot
Snapshot of the full options chain for an underlying ticker.
Endpoint Details
| HTTP Method | GET |
|---|---|
| Path | /v3/snapshot/options/{underlyingAsset} |
| Version | v3 |
| Minimum Plan | free |
Path Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
underlyingAsset |
Required | The underlying asset ticker (e.g., AAPL for options) | AAPL |
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?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 (e.g., 1) |
data | object | Response data object |
data.status | string | Response status (typically "OK") (e.g., OK) |
data.results | object | Array or object containing the endpoint-specific data |
data.results.results | array | Array of objects |
| Array items contain: | ||
data.results.results[].break_even_price | double | Floating point number (e.g., 259.925) |
data.results.results[].day | array | Empty array |
data.results.results[].details | object | |
data.results.results[].details.properties | unknown | |
data.results.results[].greeks | array | Empty array |
data.results.results[].last_quote | object | |
data.results.results[].last_quote.properties | unknown | |
data.results.results[].last_trade | array | Empty array |
data.results.results[].open_interest | integer | Integer (e.g., 0) |
data.results.results[].underlying_asset | object | |
data.results.results[].underlying_asset.properties | unknown | |
data.results.status | string | String value (e.g., OK) |
data.results.request_id | string | String value (e.g., 790327124b5da19343ebf7bf8f602296) |
data.results.next_url | string | String value (e.g., https://api.tradeiqai.com/v3/snapshot/options/AAPL...) |
Example Response
{
"ok": true,
"data": {
"status": "OK",
"underlying_asset": "AAPL",
"results": {
"results": [
{
"break_even_price": 259.92500000000001136868377216160297393798828125,
"day": [],
"details": {
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2026-04-13",
"shares_per_contract": 100,
"strike_price": 185,
"ticker": "O:AAPL260413C00185000"
},
"greeks": [],
"last_quote": {
"ask": 76.5,
"ask_size": 5,
"ask_exchange": 318,
"bid": 73.349999999999994315658113919198513031005859375,
"bid_size": 2,
"bid_exchange": 315,
"last_updated": 1775851199978293389,
"midpoint": 74.9249999999999971578290569595992565155029296875,
"timeframe": "REAL-TIME"
},
"last_trade": [],
"open_interest": 0,
"underlying_asset": {
"change_to_break_even": -1.0700000000000000621724893790087662637233734130859375,
"last_updated": 1775865589315092580,
"price": 261,
"ticker": "AAPL",
"timeframe": "REAL-TIME"
}
},
{
"break_even_price": 259.92500000000001136868377216160297393798828125,
"day": [],
"details": {
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2026-04-13",
"shares_per_contract": 100,
"strike_price": 190,
"ticker": "O:AAPL260413C00190000"
},
"greeks": [],
"last_quote": {
"ask": 71.5,
"ask_size": 7,
"ask_exchange": 318,
"bid": 68.349999999999994315658113919198513031005859375,
"bid_size": 2,
"bid_exchange": 315,
"last_updated": 1775851199978293389,
"midpoint": 69.9249999999999971578290569595992565155029296875,
"timeframe": "REAL-TIME"
},
"last_trade": [],
"open_interest": 0,
"underlying_asset": {
"change_to_break_even": -1.0700000000000000621724893790087662637233734130859375,
"last_updated": 1775865589315092580,
"price": 261,
"ticker": "AAPL",
"timeframe": "REAL-TIME"
}
},
{
"break_even_price": 259.92500000000001136868377216160297393798828125,
"day": [],
"details": {
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2026-04-13",
"shares_per_contract": 100,
"strike_price": 195,
"ticker": "O:AAPL260413C00195000"
},
"greeks": [],
"last_quote": {
"ask": 66.5,
"ask_size": 10,
"ask_exchange": 318,
"bid": 63.35000000000000142108547152020037174224853515625,
"bid_size": 2,
"bid_exchange": 309,
"last_updated": 1775851199953659772,
"midpoint": 64.9249999999999971578290569595992565155029296875,
"timeframe": "REAL-TIME"
},
"last_trade": [],
"open_interest": 0,
"underlying_asset": {
"change_to_break_even": -1.0700000000000000621724893790087662637233734130859375,
"last_updated": 1775865589315092580,
"price": 261,
"ticker": "AAPL",
"timeframe": "REAL-TIME"
}
},
{
"break_even_price": 259.92500000000001136868377216160297393798828125,
"day": [],
"details": {
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2026-04-13",
"shares_per_contract": 100,
"strike_price": 200,
"ticker": "O:AAPL260413C00200000"
},
"greeks": [],
"last_quote": {
"ask": 61.5,
"ask_size": 5,
"ask_exchange": 318,
"bid": 58.35000000000000142108547152020037174224853515625,
"bid_size": 2,
"bid_exchange": 315,
"last_updated": 1775851199983431722,
"midpoint": 59.9249999999999971578290569595992565155029296875,
"timeframe": "REAL-TIME"
},
"last_trade": [],
"open_interest": 0,
"underlying_asset": {
"change_to_break_even": -1.0700000000000000621724893790087662637233734130859375,
"last_updated": 1775865589315092580,
"price": 261,
"ticker": "AAPL",
"timeframe": "REAL-TIME"
}
},
{
"break_even_price": 259.8999999999999772626324556767940521240234375,
"day": {
"change": 0,
"change_percent": 0,
"close": 52.68999999999999772626324556767940521240234375,
"high": 52.86999999999999744204615126363933086395263671875,
"last_updated": 1775764800000000000,
"low": 52.68999999999999772626324556767940521240234375,
"open": 52.86999999999999744204615126363933086395263671875,
"previous_close": 52.68999999999999772626324556767940521240234375,
"volume": 2,
"vwap": 52.780000000000001136868377216160297393798828125
},
"details": {
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2026-04-13",
"shares_per_contract": 100,
"strike_price": 205,
"ticker": "O:AAPL260413C00205000"
},
"greeks": [],
"last_quote": {
"ask": 56.5,
"ask_size": 10,
"ask_exchange": 301,
"bid": 53.2999999999999971578290569595992565155029296875,
"bid_size": 2,
"bid_exchange": 315,
"last_updated": 1775851199958321736,
"midpoint": 54.89999999999999857891452847979962825775146484375,
"timeframe": "REAL-TIME"
},
"last_trade": {
"sip_timestamp": 1775747371336000000,
"conditions": [
237
],
"price": 52.68999999999999772626324556767940521240234375,
"size": 1,
"exchange": 312,
"timeframe": "REAL-TIME"
},
"open_interest": 1,
"underlying_asset": {
"change_to_break_even": -1.100000000000000088817841970012523233890533447265625,
"last_updated": 1775865589315092580,
"price": 261,
"ticker": "AAPL",
"timeframe": "REAL-TIME"
}
},
{
"break_even_price": 260.25,
"day": {
"change": 0,
"change_percent": 0,
"close": 49.75999999999999801048033987171947956085205078125,
"high": 51.82000000000000028421709430404007434844970703125,
"last_updated": 1775851200000000000,
"low": 49.3900000000000005684341886080801486968994140625,
"open": 49.9500000000000028421709430404007434844970703125,
"previous_close": 49.75999999999999801048033987171947956085205078125,
"volume": 240,
"vwap": 50.10770000000000123918653116561472415924072265625
},
"details": {
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2026-04-13",
"shares_per_contract": 100,
"strike_price": 210,
"ticker": "O:AAPL260413C00210000"
},
"greeks": [],
"last_quote": {
"ask": 51.5,
"ask_size": 12,
"ask_exchange": 318,
"bid": 49,
"bid_size": 9,
"bid_exchange": 313,
"last_updated": 1775851199344988274,
"midpoint": 50.25,
"timeframe": "REAL-TIME"
},
"last_trade": {
"sip_timestamp": 1775850597128490765,
"conditions": [
232
],
"price": 49.75999999999999801048033987171947956085205078125,
"size": 3,
"exchange": 323,
"timeframe": "REAL-TIME"
},
"open_interest": 0,
"underlying_asset": {
"change_to_break_even": -0.75,
"last_updated": 1775865589315092580,
"price": 261,
"ticker": "AAPL",
"timeframe": "REAL-TIME"
}
},
{
"break_even_price": 259.7250000000000227373675443232059478759765625,
"day": [],
"details": {
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2026-04-13",
"shares_per_contract": 100,
"strike_price": 215,
"ticker": "O:AAPL260413C00215000"
},
"greeks": [],
"last_quote": {
"ask": 45.9500000000000028421709430404007434844970703125,
"ask_size": 10,
"ask_exchange": 318,
"bid": 43.5,
"bid_size": 7,
"bid_exchange": 313,
"last_updated": 1775851199943556344,
"midpoint": 44.72500000000000142108547152020037174224853515625,
"timeframe": "REAL-TIME"
},
"last_trade": [],
"open_interest": 0,
"underlying_asset": {
"change_to_break_even": -1.270000000000000017763568394002504646778106689453125,
"last_updated": 1775865589315092580,
"price": 261,
"ticker": "AAPL",
"timeframe": "REAL-TIME"
}
},
{
"break_even_price": 260,
"day": [],
"details": {
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2026-04-13",
"shares_per_contract": 100,
"strike_price": 220,
"ticker": "O:AAPL260413C00220000"
},
"greeks": [],
"last_quote": {
"ask": 41.5,
"ask_size": 10,
"ask_exchange": 318,
"bid": 38.5,
"bid_size": 5,
"bid_exchange": 323,
"last_updated": 1775851199964956755,
"midpoint": 40,
"timeframe": "REAL-TIME"
},
"last_trade": [],
"open_interest": 0,
"underlying_asset": {
"change_to_break_even": -1,
"last_updated": 1775865589315092580,
"price": 261,
"ticker": "AAPL",
"timeframe": "REAL-TIME"
}
},
{
"break_even_price": 260.30000000000001136868377216160297393798828125,
"day": {
"change": 0,
"change_percent": 0,
"close": 36.4500000000000028421709430404007434844970703125,
"high": 36.4500000000000028421709430404007434844970703125,
"last_updated": 1775851200000000000,
"low": 34.93999999999999772626324556767940521240234375,
"open": 34.93999999999999772626324556767940521240234375,
"previous_close": 36.4500000000000028421709430404007434844970703125,
"volume": 18,
"vwap": 35.107799999999997453414835035800933837890625
},
"details": {
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2026-04-13",
"shares_per_contract": 100,
"strike_price": 225,
"ticker": "O:AAPL260413C00225000"
},
"greeks": [],
"last_quote": {
"ask": 36.5,
"ask_size": 11,
"ask_exchange": 302,
"bid": 34.10000000000000142108547152020037174224853515625,
"bid_size": 9,
"bid_exchange": 309,
"last_updated": 1775851199853136052,
"midpoint": 35.2999999999999971578290569595992565155029296875,
"timeframe": "REAL-TIME"
},
"last_trade": {
"sip_timestamp": 1775831135903792517,
"conditions": [
209
],
"price": 36.4500000000000028421709430404007434844970703125,
"size": 2,
"exchange": 301,
"timeframe": "REAL-TIME"
},
"open_interest": 18,
"underlying_asset": {
"change_to_break_even": -0.6999999999999999555910790149937383830547332763671875,
"last_updated": 1775865589315092580,
"price": 261,
"ticker": "AAPL",
"timeframe": "REAL-TIME"
}
},
{
"break_even_price": 260.55000000000001136868377216160297393798828125,
"day": [],
"details": {
"contract_type": "call",
"exercise_style": "american",
"expiration_date": "2026-04-13",
"shares_per_contract": 100,
"strike_price": 227.5,
"ticker": "O:AAPL260413C00227500"
},
"greeks": [],
"last_quote": {
"ask": 34,
"ask_size": 10,
"ask_exchange": 318,
"bid": 32.10000000000000142108547152020037174224853515625,
"bid_size": 10,
"bid_exchange": 318,
"last_updated": 1775851199909566793,
"midpoint": 33.0499999999999971578290569595992565155029296875,
"timeframe": "REAL-TIME"
},
"last_trade": [],
"open_interest": 0,
"underlying_asset": {
"change_to_break_even": -0.450000000000000011102230246251565404236316680908203125,
"last_updated": 1775865589315092580,
"price": 261,
"ticker": "AAPL",
"timeframe": "REAL-TIME"
}
}
],
"status": "OK",
"request_id": "790327124b5da19343ebf7bf8f602296",
"next_url": "https://api.tradeiqai.com/v3/snapshot/options/AAPL?cursor=YXA9TyUzQUFBUEwyNjA0MTNDMDAyMjc1MDAlM0EyMjcuNTAmYXM9JmV4cGlyYXRpb25fZGF0ZS5ndGU9MjAyNi0wNC0xMyZsaW1pdD0xMCZzb3J0PXRpY2tlcg"
}
}
}