Read live option quotes
https://app.skylit.ai/api/nexus/v1/trading/quotesThe live bid, ask and mid of up to 20 option contracts, by OCC symbol. These are the quotes your simulated fills use, read by the same rules, so a live quote is what a market order would get right now: a buy at the ask, a sell at the bid.
- When a quote isn't live (the market's shut, the quote's more than 15 seconds old, no quote, or no such contract) you get
live: false, areason, and no prices at all. Hold off rather than guess. - A live quote with no bid or no ask has no
mark(reason: one_sided). - For your own open trades you don't need this:
GET /api/nexus/v1/trades?status=opengives each one its livemarkand P/L.
Symbols are OCC: the root, the expiration as YYMMDD, C or P, then the strike times 1000 in 8 digits. SPXW261016C07800000 is the SPXW 7800 call expiring 2026-10-16, and QQQ261016P00740000 the QQQ 740 put. Lowercase, the padded 21 character form and an O: prefix work too. One call counts as one read.
Authorization
Authorization: Bearer <your API key>Required. A missing header returns 401; an invalid, revoked or expired key returns 403.
Query parameters
symbolsstringrequiredOne or more OCC option symbols, comma separated (at most 20).
Responses
- 200
One quote per symbol, in the order you sent them.
- 400
The request was refused before anything was traded. Codes:
bad_request,bad_contract,invalid_quantity,invalid_price,unsupported_asset_class,unsupported_order_type,only_market_orders,limit_price_required(a limit with nolimitPrice),invalid_limit_price(not in cents, or outside 0.01 to 99,999.99 for options or 999,999.99 for stocks),stop_price_required(a stop with nostopPrice),invalid_stop_price(not in cents, or outside 0.01 to 999,999.99),invalid_take_profit,test_orders_unavailable,test_modify_unavailable,bad_symbol(a quotes symbol that isn't OCC). - 401
No key, or a key that isn't valid. Codes:
missing_api_key,invalid_api_key. - 403
The key works but the account can't do this. Codes:
account_suspended,nexus_access_denied,futures_access_denied. - 429
Over a rate limit. Wait
Retry-Afterseconds, then retry. Codes:rate_limited, andstream_limit_reached(too many live streams open: 3 per key, 6 per account). - 500
Something went wrong on our side. If you sent a
clientOrderId, retry with the same one. Code:internal_error. - 503
Try again in a moment (honour
Retry-Afterwhen it's sent). Codes:stale_quote(the quote, or a stock's last trade, is more than 15 seconds old, so nothing filled),no_live_price,rules_pending,unavailable,auth_unavailable,access_check_unavailable,api_keys_unavailable,trades_api_disabled,stream_unavailable(the live stream isn't on, or the server is restarting: try again shortly, or poll the reads).
Response fields
dataobject[]symbolstringThe OCC symbol, cleaned up (no spaces, no prefix).
tickerstringexpirationstringdatestrikenumberdirectionstringcallputlivebooleantruewhen a market order on this contract would fill from this quote right now: a buy atask, a sell atbid.reasonstringWhen it isn't live (
stale_quote,market_closed,no_quote,contract_not_found), orone_sidedon a live quote with no mid.bidnumberasknumbermarknumberThe mid of the bid and ask: what open positions are marked at.
underlyingPricenumberquoteTimestringdate-timeageMsinteger
metaobjectasOfstringdate-timemaxQuoteAgeSecondsintegerHow old a quote can be and still be live (15).
Last updated