Move a futures stop to break-even
https://app.skylit.ai/api/nexus/v1/trading/accounts/{account}/breakevenMove the position's stop to its break-even price (the entry plus the round trip's commission, to the tick), the same as the BE button on the Futures Desk. With no stop yet it places one. Price must already be far enough past break-even, and it never loosens a stop: otherwise 422 order_refused and nothing moves.
No clientOrderId: moving a stop to a level is safe to repeat, so one is refused with 400 bad_request. Only takes risk off, so it isn't held by the main account switch or an agent pause. The same checks as a close: your own named account, no trading on an ended account or a challenge entry, and it counts against your write limit.
curl -s -X POST "https://app.skylit.ai/api/nexus/v1/trading/accounts/agent/breakeven" \
-H "Authorization: Bearer $SKYLIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ticker": "NQ"}'
Authorization
Authorization: Bearer <your API key>Required. A missing header returns 401; an invalid, revoked or expired key returns 403.
Path parameters
accountstringrequiredpractice,agent(your bot's account),evaluationorfunded(when you have exactly one running), or a futures account id from capabilities.
Request body
tickerstringrequiredThe position, like
NQorNQZ26.
Responses
- 200
The order the engine placed or moved.
- 400
The request was refused and nothing moved. Codes:
bad_request(noticker, aroleorprice, or aclientOrderId),bad_contract. - 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. - 409
The order clashes with what you hold or sent before. Codes:
duplicate_position(withtradeId: add to it instead),trade_closed,open_position_limit(open positions plus resting opens through the API are at 50),working_order_limit(50 options and stock orders already resting through the API),position_size_limit(an add would take the position past 1,000 contracts or 100,000 shares),client_order_id_used,request_in_progress,account_locked,account_busy,account_ended,order_not_working(it already filled, expired, or was cancelled or rejected),stop_triggered(a stop that's been set off is filling now, so it can't be cancelled or changed). - 422
order_refused: price isn't far enough past break-even yet, there's no position, or the stop is already tighter. Alsomarket_closed,account_not_tradable,account_locked. - 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
dataobjectThe order the action placed or moved, and the account it is in.
accountobjectorderobjectA futures order. It's not a
Trade: futures keep their own book. Prices are in index points, money in cents.
metaobjectExtra facts about an order. Each field is there only when it applies.
fillobjectThe fill:
price,priceSource(marketorclient), and when you sent a price, thebidandaskit was checked against. On an exit,quantityis how many sold.clientOrderIdstringidempotentReplaybooleanThis answer is a repeat of an earlier order with the same
clientOrderId.testbooleanA test order: nothing was placed.
notCheckedstring[]Futures test orders: what the preview couldn't check, like
account_rules_judgmentorbracket_netting.discordRoutingobjectWhere Nexus routed the trade to Discord, when it did.
nothingToClosebooleanstillOpenstring[]A repeated
closeAll: positions still open.tradeIdstringuuidA resting exit or an options stop: the trade it closes or protects.
triggerOnstringAn options stop:
underlying. A stock stop:lastTrade.underlyingPricenumberAn options stop: the stock's price right now.
marketOpenbooleanAn options stop: whether the market's open for the contract.
firesNowbooleanAn options stop: the stock's already through a level, so it fires on the next check.
firesOnsays which leg.wouldFireNowbooleanA test options stop: what
firesNowwould say.wouldFillNowbooleanA test limit: whether the real one would've filled right away, with
fillPrice.wouldTriggerNowbooleanA test stock stop: the last trade's already through it.
wouldRestBecausestringA test limit: why the real one would rest.
alreadyCancelledbooleanA repeated cancel: it was already cancelled.
Last updated