For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/get-order-status.md.
Get order status
Returns the current status of an order
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.
uuidOrder status retrieved
application/json- response
Order status response
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 GET 'https://api.truemarkets.co/v1/gateway/orders/string/status' \ -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11'{ "status": "complete"}Modify an active limit order PATCH
Changes the price and/or quantity of an active CeFi limit order. The change is asynchronous: the order's stored price and quantity update once the exchange confirms the modification. Only active limit orders are modifiable. On a DeFi-settled market, a modification that holds more than the CeFi balance covers first allocates the difference from the user's DeFi wallet and is queued until it lands; if the queued modification then fails, the user is notified and the order keeps its previous price and quantity.
List user transfers GET
Returns a paginated list of transfers for the authenticated user