For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/get-order.md.

Get a single order

Organization tokenNo token

GET
/orders/{id}

Returns full execution details for an order owned by the authenticated user.

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 retrieved

application/json
  1. response

Order with execution data, returned by the list-orders and get-order endpoints for orders of any status. Includes fill information from the CeFi exchange for CeFi orders.

order_id?string

Unique order identifier

asset_id?|

Asset id the order was placed against. May be null for orders sourced directly from the venue.

Formatuuid
economic_asset_id?|

Economic asset the order's listing lists, shared by its listings on every venue and chain. Null when the order recorded none.

Formatuuid
asset_symbol?|

Asset symbol the order was placed against. May be null for orders sourced directly from the venue.

base_asset?string

Base asset symbol (e.g. BTC, ETH, SOL)

quote_asset?string

Quote asset symbol (the CeFi listing's instrument quote, e.g. PYUSD or USDC; USDC for DeFi)

type?OrderType

The type of order to place — how the order executes.

  • market — Execute immediately at the best available price. Buy orders require qty_unit: quote. Price must not be specified.
  • limit — Place an order at a specific price. Requires price and qty_unit: base. chain is optional: omit it for a CeFi limit order, or supply a DeFi chain (e.g. hypercore-spot) to rest the order on-chain. With a trigger, the type is how the fired order executes and must be market.
Value in"market""limit"
side?OrderSide

The side of the order.

  • buy — Purchase the base asset using the quote asset.
  • sell — Sell the base asset in exchange for the quote asset.
Value in"buy""sell"
price?|

For limit orders, the limit price submitted. For market orders, the reference price at order creation. Null when no price was recorded.

qty?string

Original order quantity in the denomination specified by qty_unit at creation

qty_unit?string

Denomination of qty at creation

Value in"base""quote"
executed_qty?string

Quantity of the base asset that has been filled so far

leaves_qty?string

Remaining base asset quantity yet to be filled. Zero when the order is complete.

executed_vwap?string

Volume-weighted average price across all fills for this order

fee?string

Total fee charged for this order in the quote asset, 0 until part of it fills. For CeFi orders this is the cumulative trade_fee across all fills; for DeFi orders it is the order's fee once any of it has filled. The fee an order is expected to pay before it fills is the quote's fee.

tx_hash?string

On-chain transaction hash for DeFi orders. Omitted for CeFi orders.

explorer_url?string

Public block-explorer page for the order. Hyperliquid orders link to the wallet's address page on the Hyperliquid explorer, since only the venue order id is recorded. Set on GET /orders and the transaction feed, like asset_type; omitted for CeFi orders and until the venue has acknowledged the order.

failure_reason?string

Human-readable reason the order failed, such as insufficient balance. Present only on failed orders.

venue?Venue

The trading venue to filter by.

  • defi — Decentralized exchange (on-chain swaps).
  • cefi — Centralized exchange (off-chain order book).
Value in"defi""cefi"
chain?string

Chain the DeFi order executed on. Omitted for CeFi orders.

Value in"solana""base""robinhood""hypercore-spot""hypercore-perp"
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"
created_at?string

Timestamp when the order was created (RFC 3339)

Formatdate-time
asset_type?string

Product type of the traded asset. perp for Hyperliquid perpetuals, spot otherwise. Lets clients tell perp orders apart from spot ones sharing the same symbol.

Value in"spot""perp"
trigger?

Set on a TP/SL trigger order, the same shape it was created with. Such an order is a market close, so price is null while it rests.

placed_by?string

Who placed the order: the user, or a platform service acting for them, such as a strategy trading from their Strategies wallet.

Value in"user""service"
strategy_managed?boolean

True on an order a platform service placed for the user (placed_by is service). It is read-only here: POST /orders/{id}/cancel and modify return 422. A live open order conductor has no record of carries its DeFi order id as order_id. Omitted otherwise.

Example Request
curl -X GET 'https://api.truemarkets.co/v1/gateway/orders/string' \  -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11'
Example Response
{  "order_id": "string",  "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",  "economic_asset_id": "7f93aecf-1e3c-4189-b692-a8b4a0ef8e5b",  "asset_symbol": "string",  "base_asset": "string",  "quote_asset": "string",  "type": "market",  "side": "buy",  "price": "string",  "qty": "string",  "qty_unit": "base",  "executed_qty": "string",  "leaves_qty": "string",  "executed_vwap": "string",  "fee": "string",  "tx_hash": "string",  "explorer_url": "string",  "failure_reason": "string",  "venue": "defi",  "chain": "solana",  "status": "complete",  "created_at": "2019-08-24T14:15:22Z",  "asset_type": "spot",  "trigger": {    "type": "take_profit",    "price": "70000.00"  },  "placed_by": "user",  "strategy_managed": true}