For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/list-orders.md.
List user orders
Returns a paginated list of the authenticated user's orders with execution data. All statuses are returned by default; narrow the results with the status query parameter.
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.
limit?integerMaximum number of orders to return
1 <= value <= 10050cursor?stringOpaque pagination cursor from the previous page's next_cursor
status?stringComma-separated list of order statuses to filter by
venue?stringComma-separated list of trading venues to filter by (defi, cefi). Defaults to all venues (cefi,defi) when omitted.
"cefi,defi"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.
uuidOrders retrieved successfully
application/json- response
Paginated list of orders with execution data
data?array<>List of orders
pagination?Cursor-based pagination metadata. The cursor is opaque and must be passed back verbatim; never parse or construct one.
curl -X GET 'https://api.truemarkets.co/v1/gateway/orders' \ -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11'{ "data": [ { "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 } ], "pagination": { "next_cursor": "string", "limit": 0 }}