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

Organization tokenNo token

GET
/orders/{id}/status

Returns the current status of an order

Authorization

bearerAuth
headerAuthorizationBearer <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.

Path Parameters

id*string

Order ID

Header Parameters

TM-On-Behalf-Of?string

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

Formatuuid

Response Body

Order status retrieved

application/json
  1. response

Order status response

status?OrderStatus

The 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).
Value in"initialized""pending""cancel_pending""complete""canceled""active""failed"
Example Request
curl -X GET 'https://api.truemarkets.co/v1/gateway/orders/string/status' \  -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11'
Example Response
{  "status": "complete"}