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
okbooleanIndicates if the request was successful (e.g., 1)
dataobjectResponse data object
data.statusstringResponse status (typically "OK") (e.g., OK)
data.resultsobjectArray or object containing the endpoint-specific data
data.results.resultsarrayArray of objects
Array items contain:
data.results.results[].break_even_pricedoubleFloating point number (e.g., 291.2)
data.results.results[].dayobject
data.results.results[].day.propertiesunknown
data.results.results[].detailsobject
data.results.results[].details.propertiesunknown
data.results.results[].greeksarrayEmpty array
data.results.results[].last_quoteobject
data.results.results[].last_quote.propertiesunknown
data.results.results[].last_tradeobject
data.results.results[].last_trade.propertiesunknown
data.results.results[].open_interestintegerInteger (e.g., 1)
data.results.results[].underlying_assetobject
data.results.results[].underlying_asset.propertiesunknown
data.results.statusstringString value (e.g., OK)
data.results.request_idstringString value (e.g., 18cdadcb94fa67fe0f8e38f459a306d1)
data.results.next_urlstringString 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": 291.19999999999998863131622783839702606201171875,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 41.25,
                        "high": 41.46000000000000085265128291212022304534912109375,
                        "last_updated": 1781035200000000000,
                        "low": 41.25,
                        "open": 41.46000000000000085265128291212022304534912109375,
                        "previous_close": 41.25,
                        "volume": 2,
                        "vwap": 41.35499999999999687361196265555918216705322265625
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-06-15",
                        "shares_per_contract": 100,
                        "strike_price": 250,
                        "ticker": "O:AAPL260615C00250000"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 42.75,
                        "ask_size": 6,
                        "ask_exchange": 320,
                        "bid": 39.64999999999999857891452847979962825775146484375,
                        "bid_size": 9,
                        "bid_exchange": 300,
                        "last_updated": 1781294397986406104,
                        "midpoint": 41.2000000000000028421709430404007434844970703125,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1781279208627186621,
                        "conditions": [
                            233
                        ],
                        "price": 41.719999999999998863131622783839702606201171875,
                        "size": 1,
                        "exchange": 302,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 1,
                    "underlying_asset": {
                        "change_to_break_even": -2.100000000000000088817841970012523233890533447265625,
                        "last_updated": 1781515569565312190,
                        "price": 293.30000000000001136868377216160297393798828125,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 291.17500000000001136868377216160297393798828125,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 36.38000000000000255795384873636066913604736328125,
                        "high": 36.67999999999999971578290569595992565155029296875,
                        "last_updated": 1780977600000000000,
                        "low": 36.10000000000000142108547152020037174224853515625,
                        "open": 36.469999999999998863131622783839702606201171875,
                        "previous_close": 36.38000000000000255795384873636066913604736328125,
                        "volume": 110,
                        "vwap": 36.44550000000000267164068645797669887542724609375
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-06-15",
                        "shares_per_contract": 100,
                        "strike_price": 255,
                        "ticker": "O:AAPL260615C00255000"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 37.64999999999999857891452847979962825775146484375,
                        "ask_size": 11,
                        "ask_exchange": 318,
                        "bid": 34.7000000000000028421709430404007434844970703125,
                        "bid_size": 11,
                        "bid_exchange": 318,
                        "last_updated": 1781294400485428710,
                        "midpoint": 36.1749999999999971578290569595992565155029296875,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1781021764936167601,
                        "conditions": [
                            233
                        ],
                        "price": 36.38000000000000255795384873636066913604736328125,
                        "size": 1,
                        "exchange": 302,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 8,
                    "underlying_asset": {
                        "change_to_break_even": -2.12000000000000010658141036401502788066864013671875,
                        "last_updated": 1781515569565312190,
                        "price": 293.30000000000001136868377216160297393798828125,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 291.19999999999998863131622783839702606201171875,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 31.269999999999999573674358543939888477325439453125,
                        "high": 31.699999999999999289457264239899814128875732421875,
                        "last_updated": 1781035200000000000,
                        "low": 31.14999999999999857891452847979962825775146484375,
                        "open": 31.17999999999999971578290569595992565155029296875,
                        "previous_close": 31.269999999999999573674358543939888477325439453125,
                        "volume": 109,
                        "vwap": 31.488299999999998846078597125597298145294189453125
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-06-15",
                        "shares_per_contract": 100,
                        "strike_price": 260,
                        "ticker": "O:AAPL260615C00260000"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 32.5,
                        "ask_size": 13,
                        "ask_exchange": 302,
                        "bid": 29.89999999999999857891452847979962825775146484375,
                        "bid_size": 13,
                        "bid_exchange": 302,
                        "last_updated": 1781294399963282830,
                        "midpoint": 31.199999999999999289457264239899814128875732421875,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1781278400894170170,
                        "conditions": [
                            233
                        ],
                        "price": 32.3599999999999994315658113919198513031005859375,
                        "size": 1,
                        "exchange": 302,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 15,
                    "underlying_asset": {
                        "change_to_break_even": -2.100000000000000088817841970012523233890533447265625,
                        "last_updated": 1781515569565312190,
                        "price": 293.30000000000001136868377216160297393798828125,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 291.2250000000000227373675443232059478759765625,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 27.800000000000000710542735760100185871124267578125,
                        "high": 27.800000000000000710542735760100185871124267578125,
                        "last_updated": 1781064000000000000,
                        "low": 27.800000000000000710542735760100185871124267578125,
                        "open": 27.800000000000000710542735760100185871124267578125,
                        "previous_close": 27.800000000000000710542735760100185871124267578125,
                        "volume": 1,
                        "vwap": 27.800000000000000710542735760100185871124267578125
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-06-15",
                        "shares_per_contract": 100,
                        "strike_price": 265,
                        "ticker": "O:AAPL260615C00265000"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 27.64999999999999857891452847979962825775146484375,
                        "ask_size": 7,
                        "ask_exchange": 301,
                        "bid": 24.800000000000000710542735760100185871124267578125,
                        "bid_size": 6,
                        "bid_exchange": 318,
                        "last_updated": 1781294398138809481,
                        "midpoint": 26.22500000000000142108547152020037174224853515625,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1781119197208079381,
                        "conditions": [
                            209
                        ],
                        "price": 27.800000000000000710542735760100185871124267578125,
                        "size": 1,
                        "exchange": 318,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 16,
                    "underlying_asset": {
                        "change_to_break_even": -2.069999999999999840127884453977458178997039794921875,
                        "last_updated": 1781515569565312190,
                        "price": 293.30000000000001136868377216160297393798828125,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 291.19999999999998863131622783839702606201171875,
                    "day": [],
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-06-15",
                        "shares_per_contract": 100,
                        "strike_price": 267.5,
                        "ticker": "O:AAPL260615C00267500"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 25.199999999999999289457264239899814128875732421875,
                        "ask_size": 13,
                        "ask_exchange": 302,
                        "bid": 22.199999999999999289457264239899814128875732421875,
                        "bid_size": 13,
                        "bid_exchange": 302,
                        "last_updated": 1781294400487383357,
                        "midpoint": 23.699999999999999289457264239899814128875732421875,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": [],
                    "open_interest": 0,
                    "underlying_asset": {
                        "change_to_break_even": -2.100000000000000088817841970012523233890533447265625,
                        "last_updated": 1781515569565312190,
                        "price": 293.30000000000001136868377216160297393798828125,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 291.44999999999998863131622783839702606201171875,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 20.60000000000000142108547152020037174224853515625,
                        "high": 21,
                        "last_updated": 1781236800000000000,
                        "low": 19.89999999999999857891452847979962825775146484375,
                        "open": 21,
                        "previous_close": 20.60000000000000142108547152020037174224853515625,
                        "volume": 6,
                        "vwap": 20.4832999999999998408384271897375583648681640625
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-06-15",
                        "shares_per_contract": 100,
                        "strike_price": 270,
                        "ticker": "O:AAPL260615C00270000"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 22.699999999999999289457264239899814128875732421875,
                        "ask_size": 15,
                        "ask_exchange": 325,
                        "bid": 20.199999999999999289457264239899814128875732421875,
                        "bid_size": 29,
                        "bid_exchange": 322,
                        "last_updated": 1781294398061520190,
                        "midpoint": 21.449999999999999289457264239899814128875732421875,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1781289152888761995,
                        "conditions": [
                            209
                        ],
                        "price": 20.60000000000000142108547152020037174224853515625,
                        "size": 1,
                        "exchange": 318,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 33,
                    "underlying_asset": {
                        "change_to_break_even": -1.850000000000000088817841970012523233890533447265625,
                        "last_updated": 1781515569565312190,
                        "price": 293.30000000000001136868377216160297393798828125,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 291.32499999999998863131622783839702606201171875,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 20.07000000000000028421709430404007434844970703125,
                        "high": 20.07000000000000028421709430404007434844970703125,
                        "last_updated": 1781150400000000000,
                        "low": 18.660000000000000142108547152020037174224853515625,
                        "open": 18.660000000000000142108547152020037174224853515625,
                        "previous_close": 20.07000000000000028421709430404007434844970703125,
                        "volume": 194,
                        "vwap": 19.3472000000000008412825991399586200714111328125
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-06-15",
                        "shares_per_contract": 100,
                        "strike_price": 272.5,
                        "ticker": "O:AAPL260615C00272500"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 20.199999999999999289457264239899814128875732421875,
                        "ask_size": 13,
                        "ask_exchange": 301,
                        "bid": 17.449999999999999289457264239899814128875732421875,
                        "bid_size": 9,
                        "bid_exchange": 313,
                        "last_updated": 1781294398390374608,
                        "midpoint": 18.824999999999999289457264239899814128875732421875,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1781192270309322858,
                        "conditions": [
                            233
                        ],
                        "price": 20.07000000000000028421709430404007434844970703125,
                        "size": 1,
                        "exchange": 300,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 23,
                    "underlying_asset": {
                        "change_to_break_even": -1.979999999999999982236431605997495353221893310546875,
                        "last_updated": 1781515569565312190,
                        "price": 293.30000000000001136868377216160297393798828125,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 291.2749999999999772626324556767940521240234375,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 17.64999999999999857891452847979962825775146484375,
                        "high": 18.870000000000000994759830064140260219573974609375,
                        "last_updated": 1781208000000000000,
                        "low": 16.6700000000000017053025658242404460906982421875,
                        "open": 16.949999999999999289457264239899814128875732421875,
                        "previous_close": 17.64999999999999857891452847979962825775146484375,
                        "volume": 278,
                        "vwap": 17.647200000000001551825334900058805942535400390625
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-06-15",
                        "shares_per_contract": 100,
                        "strike_price": 275,
                        "ticker": "O:AAPL260615C00275000"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 17.550000000000000710542735760100185871124267578125,
                        "ask_size": 7,
                        "ask_exchange": 302,
                        "bid": 15,
                        "bid_size": 9,
                        "bid_exchange": 302,
                        "last_updated": 1781294399252406558,
                        "midpoint": 16.27499999999999857891452847979962825775146484375,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1781273802476268612,
                        "conditions": [
                            233
                        ],
                        "price": 17.8299999999999982946974341757595539093017578125,
                        "size": 25,
                        "exchange": 302,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 78,
                    "underlying_asset": {
                        "change_to_break_even": -2.029999999999999804600747665972448885440826416015625,
                        "last_updated": 1781515569565312190,
                        "price": 293.30000000000001136868377216160297393798828125,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 291.2749999999999772626324556767940521240234375,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 15.9399999999999995026200849679298698902130126953125,
                        "high": 16.46000000000000085265128291212022304534912109375,
                        "last_updated": 1781150400000000000,
                        "low": 14.519999999999999573674358543939888477325439453125,
                        "open": 14.519999999999999573674358543939888477325439453125,
                        "previous_close": 15.9399999999999995026200849679298698902130126953125,
                        "volume": 224,
                        "vwap": 15.345800000000000551381162949837744235992431640625
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-06-15",
                        "shares_per_contract": 100,
                        "strike_price": 277.5,
                        "ticker": "O:AAPL260615C00277500"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 14.949999999999999289457264239899814128875732421875,
                        "ask_size": 15,
                        "ask_exchange": 302,
                        "bid": 12.5999999999999996447286321199499070644378662109375,
                        "bid_size": 15,
                        "bid_exchange": 302,
                        "last_updated": 1781294399998637250,
                        "midpoint": 13.7750000000000003552713678800500929355621337890625,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1781185887460847153,
                        "conditions": [
                            233
                        ],
                        "price": 15.9399999999999995026200849679298698902130126953125,
                        "size": 1,
                        "exchange": 302,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 41,
                    "underlying_asset": {
                        "change_to_break_even": -2.029999999999999804600747665972448885440826416015625,
                        "last_updated": 1781515569565312190,
                        "price": 293.30000000000001136868377216160297393798828125,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 291.2749999999999772626324556767940521240234375,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 11.0999999999999996447286321199499070644378662109375,
                        "high": 16.449999999999999289457264239899814128875732421875,
                        "last_updated": 1781236800000000000,
                        "low": 9.9000000000000003552713678800500929355621337890625,
                        "open": 16.449999999999999289457264239899814128875732421875,
                        "previous_close": 11.0999999999999996447286321199499070644378662109375,
                        "volume": 245,
                        "vwap": 11.61880000000000023874235921539366245269775390625
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-06-15",
                        "shares_per_contract": 100,
                        "strike_price": 280,
                        "ticker": "O:AAPL260615C00280000"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 11.5,
                        "ask_size": 1,
                        "ask_exchange": 313,
                        "bid": 11.050000000000000710542735760100185871124267578125,
                        "bid_size": 1,
                        "bid_exchange": 316,
                        "last_updated": 1781294395209158971,
                        "midpoint": 11.2750000000000003552713678800500929355621337890625,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1781294325087444689,
                        "conditions": [
                            209
                        ],
                        "price": 11.0999999999999996447286321199499070644378662109375,
                        "size": 2,
                        "exchange": 318,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 258,
                    "underlying_asset": {
                        "change_to_break_even": -2.029999999999999804600747665972448885440826416015625,
                        "last_updated": 1781515569565312190,
                        "price": 293.30000000000001136868377216160297393798828125,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                }
            ],
            "status": "OK",
            "request_id": "18cdadcb94fa67fe0f8e38f459a306d1",
            "next_url": "https://api.tradeiqai.com/v3/snapshot/options/AAPL?cursor=YXA9TyUzQUFBUEwyNjA2MTVDMDAyODAwMDAlM0EyODAuMDAmYXM9JmV4cGlyYXRpb25fZGF0ZS5ndGU9MjAyNi0wNi0xNSZsaW1pdD0xMCZzb3J0PXRpY2tlcg"
        }
    }
}