`cancel_open_order`

Cancel an open order · changes money or positions: confirm first, idempotent · scopes: positions:close

Cancel one resting order on an exchange. Use to withdraw an unfilled limit order or a take-profit. A held position's stop-loss cannot be cancelled (move it with a new stop or close the position): this keeps every position protected. Not for closing positions (use close_perp_position_reduce_only). Inputs: order_id (from get_my_open_orders), symbol, venue. Works while trading is halted. Next: get_my_open_orders.

Call it

MCP tools/call

{"name": "cancel_open_order", "arguments": {"order_id": "123456", "symbol": "BTC"}}

REST

DELETE /v1/orders/{order_id}

Inputs

Name	Meaning (* required)
`order_id` *	From get_my_open_orders
`symbol` *	Base coin, e.g. BTC
`venue`	Venue: sandbox, hyperliquid, okx, bybit or binance. Omitted: the agent's only venue, else hyperliquid, else your only connected venue, else sandbox

Returns

Field	Meaning and unit
`ok`	False when rejected or failed
`request_id`	Order request id; get_order_request_status(request_id) follows it
`status`	pending_approval, armed (a trigger entry waiting for its price), executed, rejected, failed, expired, declined, cancelled, or executing (TradeHub has not confirmed the outcome yet: check get_order_request_status)
`venue`	Venue name
`order_id`	Venue order id of the fill
`sl_oid`	Venue order id of the protective stop
`fill_price`	Average fill, USD per coin
`filled_size`	Filled size, in the base coin (e.g. BTC), not USD
`approval_expires_at`	While pending: when the approval request lapses, ISO 8601 UTC
`error`	Why it was rejected or failed
`checks`	Checks run at execution
`receipt`	Signed receipt (compact JWS, EdDSA) once executed: request, checks, preview price, fill, slippage, order ids, delegation. Verify with /.well-known/tradehub-receipts.jwks
`take_profits`	set_take_profit_levels: the take-profits now on the exchange
`trigger_price`	status armed: opens at market when the mark reaches this, USD per coin
`trigger_expires_at`	status armed: when it lapses unless reached, ISO 8601 UTC
`fee`	Once executed: the trading fee, estimated at once and replaced by the amount the exchange charged once its fill records show it

Rejections: error codes, each with what to do.