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_priceintegerInteger (e.g., 276)
data.results.results[].dayarrayEmpty array
data.results.results[].detailsobject
data.results.results[].details.propertiesunknown
data.results.results[].greeksobject
data.results.results[].greeks.propertiesunknown
data.results.results[].implied_volatilitydoubleFloating point number (e.g., 10.202526869346)
data.results.results[].last_quoteobject
data.results.results[].last_quote.propertiesunknown
data.results.results[].last_tradearrayEmpty array
data.results.results[].open_interestintegerInteger (e.g., 0)
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., d7e76e9a8f324b9f236d2e57165e9bff)
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": 276,
                    "day": [],
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-02-11",
                        "shares_per_contract": 100,
                        "strike_price": 180,
                        "ticker": "O:AAPL260211C00180000"
                    },
                    "greeks": {
                        "delta": 0.993337278204178719676065156818367540836334228515625,
                        "gamma": 0.0003702176617750304959096607770874243215075694024562835693359375,
                        "theta": -4.03458983282869976250140098272822797298431396484375,
                        "vega": 0.00086456179441000979846165819253656081855297088623046875
                    },
                    "implied_volatility": 10.2025268693464994385067257098853588104248046875,
                    "last_quote": {
                        "ask": 97.5499999999999971578290569595992565155029296875,
                        "ask_size": 227,
                        "ask_exchange": 300,
                        "bid": 94.4500000000000028421709430404007434844970703125,
                        "bid_size": 37,
                        "bid_exchange": 318,
                        "last_updated": 1770843597960983571,
                        "midpoint": 96,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": [],
                    "open_interest": 0,
                    "underlying_asset": {
                        "change_to_break_even": 0.11999999999999999555910790149937383830547332763671875,
                        "last_updated": 1770847999944192289,
                        "price": 275.8799999999999954525264911353588104248046875,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 276.07499999999998863131622783839702606201171875,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 72.25,
                        "high": 72.25,
                        "last_updated": 1769806800000000000,
                        "low": 72.25,
                        "open": 72.25,
                        "previous_close": 72.25,
                        "volume": 1,
                        "vwap": 72.25
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-02-11",
                        "shares_per_contract": 100,
                        "strike_price": 185,
                        "ticker": "O:AAPL260211C00185000"
                    },
                    "greeks": {
                        "delta": 0.9896618976978175385994518364896066486835479736328125,
                        "gamma": 0.000543287849542074970619898177659479188150726258754730224609375,
                        "theta": -6.07904908484519790334843492018990218639373779296875,
                        "vega": 0.0020451678048732254387720441712872343487106263637542724609375
                    },
                    "implied_volatility": 10.3437707792947062301891492097638547420501708984375,
                    "last_quote": {
                        "ask": 92.650000000000005684341886080801486968994140625,
                        "ask_size": 192,
                        "ask_exchange": 300,
                        "bid": 89.5,
                        "bid_size": 3,
                        "bid_exchange": 300,
                        "last_updated": 1770843598277328347,
                        "midpoint": 91.0750000000000028421709430404007434844970703125,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1769785967860000000,
                        "conditions": [
                            232
                        ],
                        "price": 72.25,
                        "size": 1,
                        "exchange": 312,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 0,
                    "underlying_asset": {
                        "change_to_break_even": 0.195000000000000006661338147750939242541790008544921875,
                        "last_updated": 1770847999944192289,
                        "price": 275.8799999999999954525264911353588104248046875,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 276.05000000000001136868377216160297393798828125,
                    "day": [],
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-02-11",
                        "shares_per_contract": 100,
                        "strike_price": 190,
                        "ticker": "O:AAPL260211C00190000"
                    },
                    "greeks": {
                        "delta": 0.9901449303182150440960640480625443160533905029296875,
                        "gamma": 0.000564862377366771796667610505693346567568369209766387939453125,
                        "theta": -5.4262514042093759059071089723147451877593994140625,
                        "vega": 0.0020738745703221457029885588241313598700799047946929931640625
                    },
                    "implied_volatility": 9.5827808579548534595460296259261667728424072265625,
                    "last_quote": {
                        "ask": 87.599999999999994315658113919198513031005859375,
                        "ask_size": 60,
                        "ask_exchange": 320,
                        "bid": 84.5,
                        "bid_size": 46,
                        "bid_exchange": 320,
                        "last_updated": 1770843599778088344,
                        "midpoint": 86.0499999999999971578290569595992565155029296875,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": [],
                    "open_interest": 0,
                    "underlying_asset": {
                        "change_to_break_even": 0.1700000000000000122124532708767219446599483489990234375,
                        "last_updated": 1770847999944192289,
                        "price": 275.8799999999999954525264911353588104248046875,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 275.875,
                    "day": [],
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-02-11",
                        "shares_per_contract": 100,
                        "strike_price": 195,
                        "ticker": "O:AAPL260211C00195000"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 82.599999999999994315658113919198513031005859375,
                        "ask_size": 147,
                        "ask_exchange": 300,
                        "bid": 79.150000000000005684341886080801486968994140625,
                        "bid_size": 186,
                        "bid_exchange": 300,
                        "last_updated": 1770843599527225650,
                        "midpoint": 80.875,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": [],
                    "open_interest": 0,
                    "underlying_asset": {
                        "change_to_break_even": -0.005000000000000000104083408558608425664715468883514404296875,
                        "last_updated": 1770847999944192289,
                        "price": 275.8799999999999954525264911353588104248046875,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 275.82499999999998863131622783839702606201171875,
                    "day": [],
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-02-11",
                        "shares_per_contract": 100,
                        "strike_price": 200,
                        "ticker": "O:AAPL260211C00200000"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 77.599999999999994315658113919198513031005859375,
                        "ask_size": 161,
                        "ask_exchange": 323,
                        "bid": 74.0499999999999971578290569595992565155029296875,
                        "bid_size": 100,
                        "bid_exchange": 323,
                        "last_updated": 1770843598650785706,
                        "midpoint": 75.8250000000000028421709430404007434844970703125,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": [],
                    "open_interest": 0,
                    "underlying_asset": {
                        "change_to_break_even": -0.055000000000000000277555756156289135105907917022705078125,
                        "last_updated": 1770847999944192289,
                        "price": 275.8799999999999954525264911353588104248046875,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 275.82499999999998863131622783839702606201171875,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 72.31999999999999317878973670303821563720703125,
                        "high": 72.31999999999999317878973670303821563720703125,
                        "last_updated": 1770411600000000000,
                        "low": 72.31999999999999317878973670303821563720703125,
                        "open": 72.31999999999999317878973670303821563720703125,
                        "previous_close": 72.31999999999999317878973670303821563720703125,
                        "volume": 1,
                        "vwap": 72.31999999999999317878973670303821563720703125
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-02-11",
                        "shares_per_contract": 100,
                        "strike_price": 205,
                        "ticker": "O:AAPL260211C00205000"
                    },
                    "greeks": [],
                    "last_quote": {
                        "ask": 72.5,
                        "ask_size": 182,
                        "ask_exchange": 300,
                        "bid": 69.150000000000005684341886080801486968994140625,
                        "bid_size": 205,
                        "bid_exchange": 300,
                        "last_updated": 1770843599827837393,
                        "midpoint": 70.8250000000000028421709430404007434844970703125,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1770403299312000000,
                        "conditions": [
                            232
                        ],
                        "price": 72.31999999999999317878973670303821563720703125,
                        "size": 1,
                        "exchange": 312,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 0,
                    "underlying_asset": {
                        "change_to_break_even": -0.055000000000000000277555756156289135105907917022705078125,
                        "last_updated": 1770847999944192289,
                        "price": 275.8799999999999954525264911353588104248046875,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 276.05000000000001136868377216160297393798828125,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 64.75,
                        "high": 64.75,
                        "last_updated": 1770325200000000000,
                        "low": 64.75,
                        "open": 64.75,
                        "previous_close": 64.75,
                        "volume": 1,
                        "vwap": 64.75
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-02-11",
                        "shares_per_contract": 100,
                        "strike_price": 210,
                        "ticker": "O:AAPL260211C00210000"
                    },
                    "greeks": {
                        "delta": 0.9872285976706065557806368815363384783267974853515625,
                        "gamma": 0.00093328006451089844976165554868430263013578951358795166015625,
                        "theta": -5.0447969333581017536971558001823723316192626953125,
                        "vega": 0.002183594117944671897380004566002753563225269317626953125
                    },
                    "implied_volatility": 7.18710133581548316072939996956847608089447021484375,
                    "last_quote": {
                        "ask": 67.599999999999994315658113919198513031005859375,
                        "ask_size": 15,
                        "ask_exchange": 301,
                        "bid": 64.5,
                        "bid_size": 17,
                        "bid_exchange": 301,
                        "last_updated": 1770843599989853776,
                        "midpoint": 66.0499999999999971578290569595992565155029296875,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1770314883358000000,
                        "conditions": [
                            232
                        ],
                        "price": 64.75,
                        "size": 1,
                        "exchange": 308,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 0,
                    "underlying_asset": {
                        "change_to_break_even": 0.1700000000000000122124532708767219446599483489990234375,
                        "last_updated": 1770847999944192289,
                        "price": 275.8799999999999954525264911353588104248046875,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 276.05000000000001136868377216160297393798828125,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 59.280000000000001136868377216160297393798828125,
                        "high": 59.6400000000000005684341886080801486968994140625,
                        "last_updated": 1770757200000000000,
                        "low": 59.280000000000001136868377216160297393798828125,
                        "open": 59.6400000000000005684341886080801486968994140625,
                        "previous_close": 59.280000000000001136868377216160297393798828125,
                        "volume": 2,
                        "vwap": 59.46000000000000085265128291212022304534912109375
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-02-11",
                        "shares_per_contract": 100,
                        "strike_price": 215,
                        "ticker": "O:AAPL260211C00215000"
                    },
                    "greeks": {
                        "delta": 0.986245914750824237415827155928127467632293701171875,
                        "gamma": 0.0010775668472545285418717764258644820074550807476043701171875,
                        "theta": -4.94862025981259279205914936028420925140380859375,
                        "vega": 0.0022101075338333549084868234757550453650765120983123779296875
                    },
                    "implied_volatility": 6.6241950636969431087663906509988009929656982421875,
                    "last_quote": {
                        "ask": 62.60000000000000142108547152020037174224853515625,
                        "ask_size": 203,
                        "ask_exchange": 300,
                        "bid": 59.5,
                        "bid_size": 26,
                        "bid_exchange": 302,
                        "last_updated": 1770843596389328470,
                        "midpoint": 61.0499999999999971578290569595992565155029296875,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1770740916240865514,
                        "conditions": [
                            233
                        ],
                        "price": 59.280000000000001136868377216160297393798828125,
                        "size": 1,
                        "exchange": 302,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 0,
                    "underlying_asset": {
                        "change_to_break_even": 0.1700000000000000122124532708767219446599483489990234375,
                        "last_updated": 1770847999944192289,
                        "price": 275.8799999999999954525264911353588104248046875,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 276.1000000000000227373675443232059478759765625,
                    "day": {
                        "change": 0,
                        "change_percent": 0,
                        "close": 54.35000000000000142108547152020037174224853515625,
                        "high": 54.5799999999999982946974341757595539093017578125,
                        "last_updated": 1770757200000000000,
                        "low": 54.35000000000000142108547152020037174224853515625,
                        "open": 54.5799999999999982946974341757595539093017578125,
                        "previous_close": 54.35000000000000142108547152020037174224853515625,
                        "volume": 2,
                        "vwap": 54.465000000000003410605131648480892181396484375
                    },
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-02-11",
                        "shares_per_contract": 100,
                        "strike_price": 220,
                        "ticker": "O:AAPL260211C00220000"
                    },
                    "greeks": {
                        "delta": 0.9818190953387653241435373274725861847400665283203125,
                        "gamma": 0.0014389670883953394227294797502736400929279625415802001953125,
                        "theta": -5.9700340410161469861805016989819705486297607421875,
                        "vega": 0.002236010033775733159278065187436368432827293872833251953125
                    },
                    "implied_volatility": 6.29795416658613493865459531662054359912872314453125,
                    "last_quote": {
                        "ask": 57.64999999999999857891452847979962825775146484375,
                        "ask_size": 41,
                        "ask_exchange": 320,
                        "bid": 54.5499999999999971578290569595992565155029296875,
                        "bid_size": 16,
                        "bid_exchange": 302,
                        "last_updated": 1770843597934199228,
                        "midpoint": 56.10000000000000142108547152020037174224853515625,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": {
                        "sip_timestamp": 1770740916240870503,
                        "conditions": [
                            233
                        ],
                        "price": 54.35000000000000142108547152020037174224853515625,
                        "size": 1,
                        "exchange": 302,
                        "timeframe": "REAL-TIME"
                    },
                    "open_interest": 0,
                    "underlying_asset": {
                        "change_to_break_even": 0.2200000000000000011102230246251565404236316680908203125,
                        "last_updated": 1770847999944192289,
                        "price": 275.8799999999999954525264911353588104248046875,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                },
                {
                    "break_even_price": 275.8999999999999772626324556767940521240234375,
                    "day": [],
                    "details": {
                        "contract_type": "call",
                        "exercise_style": "american",
                        "expiration_date": "2026-02-11",
                        "shares_per_contract": 100,
                        "strike_price": 222.5,
                        "ticker": "O:AAPL260211C00222500"
                    },
                    "greeks": {
                        "delta": 0.997424785784179146475025845575146377086639404296875,
                        "gamma": 0.0003591900918340750208275491406340051980805583298206329345703125,
                        "theta": -0.76755366251330048310563824998098425567150115966796875,
                        "vega": 0.000350638854227466553216407962878520265803672373294830322265625
                    },
                    "implied_volatility": 4.4719812433545431673564962693490087985992431640625,
                    "last_quote": {
                        "ask": 55.10000000000000142108547152020037174224853515625,
                        "ask_size": 138,
                        "ask_exchange": 300,
                        "bid": 51.7000000000000028421709430404007434844970703125,
                        "bid_size": 172,
                        "bid_exchange": 300,
                        "last_updated": 1770843599828554012,
                        "midpoint": 53.39999999999999857891452847979962825775146484375,
                        "timeframe": "REAL-TIME"
                    },
                    "last_trade": [],
                    "open_interest": 0,
                    "underlying_asset": {
                        "change_to_break_even": 0.0200000000000000004163336342344337026588618755340576171875,
                        "last_updated": 1770847999944192289,
                        "price": 275.8799999999999954525264911353588104248046875,
                        "ticker": "AAPL",
                        "timeframe": "REAL-TIME"
                    }
                }
            ],
            "status": "OK",
            "request_id": "d7e76e9a8f324b9f236d2e57165e9bff",
            "next_url": "https://api.tradeiqai.com/v3/snapshot/options/AAPL?cursor=YXA9TyUzQUFBUEwyNjAyMTFDMDAyMjI1MDAlM0EyMjIuNTAmYXM9JmV4cGlyYXRpb25fZGF0ZS5ndGU9MjAyNi0wMi0xMSZsaW1pdD0xMCZzb3J0PXRpY2tlcg"
        }
    }
}