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
Returns full execution details for an order owned by the authenticated user.
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 retrieved
application/json- 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?stringUnique order identifier
asset_id?|Asset id the order was placed against. May be null for orders sourced directly from the venue.
uuideconomic_asset_id?|Economic asset the order's listing lists, shared by its listings on every venue and chain. Null when the order recorded none.
uuidasset_symbol?|Asset symbol the order was placed against. May be null for orders sourced directly from the venue.
base_asset?stringBase asset symbol (e.g. BTC, ETH, SOL)
quote_asset?stringQuote asset symbol (the CeFi listing's instrument quote, e.g. PYUSD or USDC; USDC for DeFi)
type?OrderTypeThe 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
priceandqty_unit: base.chainis optional: omit it for a CeFi limit order, or supply a DeFi chain (e.g.hypercore-spot) to rest the order on-chain. With atrigger, the type is how the fired order executes and must bemarket.
"market""limit"side?OrderSideThe side of the order.
- buy — Purchase the base asset using the quote asset.
- sell — Sell the base asset in exchange for the quote asset.
"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?stringOriginal order quantity in the denomination specified by qty_unit at creation
qty_unit?stringDenomination of qty at creation
"base""quote"executed_qty?stringQuantity of the base asset that has been filled so far
leaves_qty?stringRemaining base asset quantity yet to be filled. Zero when the order is complete.
executed_vwap?stringVolume-weighted average price across all fills for this order
fee?stringTotal 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?stringOn-chain transaction hash for DeFi orders. Omitted for CeFi orders.
explorer_url?stringPublic 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?stringHuman-readable reason the order failed, such as insufficient balance. Present only on failed orders.
venue?VenueThe trading venue to filter by.
- defi — Decentralized exchange (on-chain swaps).
- cefi — Centralized exchange (off-chain order book).
"defi""cefi"chain?stringChain the DeFi order executed on. Omitted for CeFi orders.
"solana""base""robinhood""hypercore-spot""hypercore-perp"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"created_at?stringTimestamp when the order was created (RFC 3339)
date-timeasset_type?stringProduct type of the traded asset. perp for Hyperliquid perpetuals, spot otherwise. Lets clients tell perp orders apart from spot ones sharing the same symbol.
"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?stringWho placed the order: the user, or a platform service acting for them, such as a strategy trading from their Strategies wallet.
"user""service"strategy_managed?booleanTrue 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.
curl -X GET 'https://api.truemarkets.co/v1/gateway/orders/string' \ -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11'{ "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}Execute a prepared TP/SL modify POST
Submits the client's signature over the payload POST /orders/modify/{id}/prepare returned. Each order reports the trigger price it now rests at, or the venue's error when it refused that order, for example a trigger that already fired; refused orders keep their previous trigger. A prepared modify is single-use: an unknown or spent id returns 404.
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.