For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/execute-cancel-order.md.
Execute a resting DeFi order cancellation
Submits the client's signatures over the payloads returned by
POST /orders/{id}/cancel to cancel a resting DeFi limit or TP/SL order.
The order moves to canceled once the venue confirms, keeping any
quantity that filled before the cancel in executed_qty/executed_vwap.
An order that filled before the cancel landed moves to complete. An
order that is no longer open, including one the venue reports closed
before it can say how, returns 422 with code order_not_open.
bearerAuthAuthorizationBearer <JWT>An access token from POST /v1/auth/api-key/token. An organization token lasts one hour and has no refresh token; a personal token can be refreshed.
id*stringOrder ID
TM-On-Behalf-Of?stringAct as one of your organization's users. The value is the user_id returned when the user was created; the request then reads and writes that user's account. Requires an organization token and a user your organization created: 400 for a personal token, a repeated header or a non-UUID, 403 for a user outside your organization. Not accepted on organization-scoped routes.
uuidapplication/json- body
Request to execute an order that is in initialized status. The client must sign each payload returned by the create endpoint and submit the signatures in the same order.
signatures*array<string>One stamp per payload, in the same order as the payloads returned by the create endpoint. With auth_type: api_key, an entry is the base64url encoding, without padding, of the JSON {"publicKey": "<compressed P-256 public key, hex>", "signature": "<DER signature, hex>", "scheme": "SIGNATURE_SCHEME_TK_API_P256"}, signed as UnsignedPayload describes. With auth_type: web_authn, an entry is the browser's WebAuthn stamp.
1 <= itemsauth_type*SigningMethodThe authentication method used to sign transaction payloads.
- web_authn — Signed using a passkey (WebAuthn/FIDO2 credential) via the browser.
- api_key — Signed using an API key. Suitable for programmatic/headless access.
"web_authn""api_key"Cancellation submitted
application/json- response
Response from executing an order. For DeFi orders, a successful execution transitions the order to complete (an immediate fill) or active (a limit order resting on-chain). For CeFi orders, the order moves to pending while it is processed by the CeFi exchange.
status?OrderStatusThe current status of the order.
- initialized — Order has been created but not yet submitted. For DeFi orders, the client must sign the returned payloads and call the execute endpoint. For CeFi buy orders with insufficient balance, a funding bridge is prepared first.
- pending — Order has been submitted but is not yet confirmed by the CeFi exchange or on-chain.
- active — Order was accepted by the CeFi exchange and is open for trading. Applies to limit orders that are working in the order book.
- cancel_pending — A cancellation request has been sent to the CeFi exchange and is awaiting confirmation.
- complete — Order has been fully executed. For CeFi orders this means the CeFi exchange reported a fill; for DeFi orders the on-chain swap was confirmed.
- canceled — Order was successfully canceled via a cancel request or by exchange/market conditions.
- failed — Order was rejected by the CeFi exchange or DeFi execution failed (e.g. on-chain transaction reverted, balance check failed).
"initialized""pending""cancel_pending""complete""canceled""active""failed"curl -X POST 'https://api.truemarkets.co/v1/gateway/orders/string/cancel/execute' \ -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11' \ -H 'Content-Type: application/json' \ -d '{ "signatures": [ "string" ], "auth_type": "api_key"}'{ "status": "complete"}Cancel a limit or TP/SL order (CeFi or DeFi) POST
Venue-polymorphic cancel. The payloads field is the signal.
Prepare moving resting DeFi TP/SL orders to new trigger prices POST
Prepares one Hyperliquid batch modify, under the client-chosen batch id, moving each listed order to its new trigger price, and returns the single unsigned payload the client signs and posts to POST /orders/modify/{id}/execute with the same id. Reusing an id that is already prepared returns 409. Every order must be the caller's active DeFi TP/SL trigger order on the same account; each keeps the slippage bound it was placed with, scaled to its new trigger. A trigger price on the wrong side of the current price returns 400; an order that is no longer open returns 422 with code order_not_open.