For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/gateway/list-transactions.md.
List user transactions
Returns the caller's orders, transfers, ramps, and received transfers as one paginated feed, newest first. Each row pairs a type-agnostic envelope with the full typed object named by type, so the per-type endpoints do not need merging client-side.
A received transfer is a transfer into the caller's wallet that none of their own platform activity explains, such as a transfer from an external wallet. It appears a minute or more after its block. Open Hyperliquid orders are served live by GET /orders and appear here once terminal.
Paginate with the previous page's next_cursor.
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.
type?array<>Comma-separated types to include. Defaults to all.
status?array<>Comma-separated statuses to include. Defaults to all.
asset_symbol?array<>Comma-separated asset symbols, matched exactly.
items <= 50asset_type?array<>Comma-separated asset types. Returns orders only.
order_type?array<>Comma-separated order types. A take-profit or stop-loss order matches only its trigger type. Returns orders only.
asset_class?array<>Comma-separated asset classes. Returns orders only.
id?stringOne transaction's id.
uuidtx_hash?stringOne transaction hash, matched regardless of case.
length <= 128from?stringCreated at or after this instant.
date-timeto?stringCreated before this instant. Must be after from.
date-timesearch?stringCase-insensitive text found in a transaction's id, asset symbol or tx hash, or in a transfer's destination or a received transfer's sender address. At least 3 and at most 128 characters.
3 <= length <= 128cursor?stringOpaque pagination cursor from the previous page's next_cursor
limit?integerMaximum number of transactions to return
1 <= value <= 10050TM-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.
uuidTransactions retrieved successfully
application/json- response
Paginated unified feed of orders, transfers, ramps, and received transfers
data?array<>List of transactions, newest first
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/transactions' \ -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11'{ "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "type": "order", "asset_flow": "in", "status": "pending", "created_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z", "qty": "string", "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4", "asset_symbol": "string", "tx_hash": "string", "explorer_url": "string", "failure_reason": "string", "order": { "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 }, "transfer": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": "pending", "venue": "defi", "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4", "asset_symbol": "string", "chain": "string", "network": "bitcoin", "to": "string", "qty": "string", "qty_unit": "base", "sent": "string", "fee": "string", "received": "string", "tx_hash": "string", "explorer_url": "string", "payloads": [ { "digest": "string", "payload": "string" } ], "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" }, "ramp": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "payment_method": "COINBASE", "direction": "onramp", "status": "created", "amount": "string", "chain": "solana", "asset_symbol": "string", "asset_amount": "string", "fiat_currency": "string", "fiat_amount": "string", "fee_amount": "string", "fee_currency": "string", "exchange_rate": "string", "wallet_address": "string", "provider_wallet_address": "string", "tx_hash": "string", "redirect_url": "string", "failure_reason": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z" }, "received_transfer": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "chain": "solana", "tx_hash": "string", "from_address": "string", "to_address": "string", "token_address": "string", "token_symbol": "USDC", "amount": "25.5", "observed_at": "2019-08-24T14:15:22Z" } } ], "pagination": { "next_cursor": "string", "limit": 0 }}Remove test funds (paper trading only) POST
Paper-trading environments only. This endpoint is not served in production, where it answers 404.
List organization transactions GET
Orders, transfers and received transfers of every user the organization serves, newest first, each row naming its user. Ramps are not included.