Nexus/API Reference/Spreads

Your spread orders

GEThttps://app.skylit.ai/api/nexus/v1/spreads/orders

Without date: the spread orders resting now, whatever day you placed them. With date (a New York day): every spread order of that day, whatever its status. Orders you placed on the Spreads ticket in Nexus are here too. Main account only.

curl -s "https://app.skylit.ai/api/nexus/v1/spreads/orders?date=2026-11-18" \
  -H "Authorization: Bearer $SKYLIT_API_KEY"

Authorization

Authorization: Bearer <your API key>

Required. A missing header returns 401; an invalid, revoked or expired key returns 403.

Query parameters

  • datestringdate

    YYYY-MM-DD, a New York day: that day's spread orders, whatever their status. Leave it out for the orders resting now, whatever day they were placed.

  • accountstring

    main or left out. Spreads are on your main account only.

    main

Responses

  • 200

    The orders, with how many.

  • 400

    Refused before anything was sent. Codes: bad_request (an unknown field, a leg that isn't options or stocks, legs that don't form the strategy, a missing limitPrice on a limit, a market order with one, a quantity over 100, a modify with neither quantity nor limitPrice, a date that isn't YYYY-MM-DD), expiry_day_cutoff (on a leg's expiration day, new spread opens stop at 3:00 PM ET; closes are never refused).

  • 401

    No key, or a key that isn't valid. Codes: missing_api_key, invalid_api_key.

  • 422

    Read fine, but the account says no. Codes: port_unsupported (any account but main, or any port), insufficient_buying_power (with orderId when the order was recorded as rejected), order_rejected (recorded as rejected as it was placed; orderId points to it), contract_expired.

  • 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. Codes: no_live_quote (a leg, or the underlying, has no live quote; quotes older than 15 s never fill), unavailable (spreads aren't on this server, or a check couldn't be read).

Response fields

  • dataobject[]required
    • orderIdstringuuid
    • clientOrderIdstring
    • accountstring
      main
    • strategystring
    • underlyingstring
    • positionEffectstring
      OPENCLOSE
    • netEffectstring
      DEBITCREDIT
    • orderTypestring
      LIMITMARKET
    • timeInForcestring
      DAYGTC
    • quantityinteger
    • filledQuantityinteger
    • limitPricenumber | null

      Per spread. null on a market order.

    • averageFillPricenumber | null

      The net per spread it filled at. null until it fills.

    • realizedPnlnumber | null

      Dollars a filled close made or lost. null on an open, and until a close fills.

    • feesnumber | null

      Dollars the fill paid. null before it fills.

    • statusstring

      Upper case, as on the Spreads ticket in Nexus.

      WORKINGFILLEDCANCELLEDREJECTEDEXPIRED
    • cancellableboolean

      true while it rests.

    • receivedAtstring | nulldate-time
    • messagestring | null

      Why it was rejected or ended, when there's a reason.

    • legsobject[]
  • metaobjectrequired
    • accountstring
      main
    • totalinteger

      How many orders are in data.

Last updated

Was this page helpful?