Docs
Nexus/API Reference/Options and stocks resting orders

See what's resting on a wallet

GEThttps://app.skylit.ai/api/nexus/v1/trading/wallets/{book}/orders/working

Every options and stock order resting on that wallet, oldest first: limits, stock stops, and options stop-losses and targets. The main wallet's list shows orders you placed on the Options Desk in Nexus too. Yours carry "source": "api" and your clientOrderId.

Authorization

Authorization: Bearer <your API key>

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

Path parameters

  • bookstringrequired

    main is your own paper wallet, agent is your bot's.

    mainagent

Responses

  • 200

    The resting orders. meta.count is how many.

  • 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.

  • 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.

  • 404

    Not on your account. Codes: trade_not_found, account_not_found, order_not_found.

  • 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).

  • 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[]
    • idstringuuid
    • assetClassstring
      optionsstocks
    • sourcestring

      api when a key placed it. Left out on an order placed on the Options Desk in Nexus.

    • bookstring
      mainagent
    • clientOrderIdstring
    • tickerstring
    • strikenumber

      Options only.

    • directionstring

      call or put on an option. long or short on a stock: the side of the position it opens or closes.

    • expirationstringdate

      Options only.

    • sidestring
      buysell
    • positionEffectstring
      openclose
    • quantityinteger
    • filledQuantityinteger
    • orderTypestring

      stop, take_profit and bracket on an option are options stops. A trailing stop set on the Options Desk shows as trailing_stop (with triggerOn premium when it trails the option's own bid), and a desk market order as market, on the main wallet's list.

      limitstoptake_profitbrackettrailing_stopmarket
    • timeInForcestring
      daygtc
    • statusstring
      workingfilledcancelledrejectedexpired
    • statusReasonstring

      Why, when there's a reason.

    • limitPricenumber
    • stopPricenumber

      A stock stop's level.

    • stopLossnumber

      An options stop: the stock price the stop fires at.

    • takeProfitnumber

      An options stop: the stock price the target fires at.

    • triggerOnstring

      underlying on an options stop: its levels are the stock's price.

      underlyingpremium
    • underlyingstring

      The stock an options stop watches.

    • firedLegstring

      Which leg of an options stop fired.

      stop_losstake_profit
    • triggeredAtstringdate-time

      When a stop was set off. It can't be cancelled or changed after that.

    • triggerPricenumber

      The trade (or for an options stop, the stock price) that set it off.

    • fillOrderIdstringuuid

      An options stop that fired: the sell it sent.

    • fillPricenumber

      The average fill: the ask a buy paid, the bid a sell got, or a stock's trade price.

    • tradeIdstringuuid

      The trade the fill went to, or the trade an options stop protects.

    • reservedCentsinteger

      Buying power a resting open holds back. 0 once it stops resting, and on a close.

    • placedAtstringdate-time
    • filledAtstringdate-time
    • expiresAtstringdate-time
    • testboolean

      true on a test order. It never fills.

Last updated

Was this page helpful?