Nexus/API Reference/Options and stocks

Read live option quotes

GEThttps://app.skylit.ai/api/nexus/v1/trading/quotes

The 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, a reason, 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=open gives each one its live mark and 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

  • symbolsstringrequired

    One 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 no limitPrice), 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 no stopPrice), 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-After seconds, then retry. Codes: rate_limited, and stream_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-After when 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[]
    • symbolstring

      The OCC symbol, cleaned up (no spaces, no prefix).

    • tickerstring
    • expirationstringdate
    • strikenumber
    • directionstring
      callput
    • liveboolean

      true when a market order on this contract would fill from this quote right now: a buy at ask, a sell at bid.

    • reasonstring

      When it isn't live (stale_quote, market_closed, no_quote, contract_not_found), or one_sided on a live quote with no mid.

    • bidnumber
    • asknumber
    • marknumber

      The mid of the bid and ask: what open positions are marked at.

    • underlyingPricenumber
    • quoteTimestringdate-time
    • ageMsinteger
  • metaobject
    • asOfstringdate-time
    • maxQuoteAgeSecondsinteger

      How old a quote can be and still be live (15).

Last updated

Was this page helpful?