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

Organization tokenNo token

GET
/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.

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.

Query Parameters

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.

Itemsitems <= 50
asset_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?string

One transaction's id.

Formatuuid
tx_hash?string

One transaction hash, matched regardless of case.

Lengthlength <= 128
from?string

Created at or after this instant.

Formatdate-time
to?string

Created before this instant. Must be after from.

Formatdate-time
search?string

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

Length3 <= length <= 128
cursor?string

Opaque pagination cursor from the previous page's next_cursor

limit?integer

Maximum number of transactions to return

Range1 <= value <= 100
Default50

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

Transactions retrieved successfully

application/json
  1. 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.

Example Request
curl -X GET 'https://api.truemarkets.co/v1/gateway/transactions' \  -H 'TM-On-Behalf-Of: 3f6d2c0e-8a41-4c2b-9f1e-2b7d5c0a9e11'
Example Response
{  "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  }}