---
title: "List user transactions"
url: https://docs.truemarkets.co/api/gateway/list-transactions
description: "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."
---

Docs index: https://docs.truemarkets.co/llms.txt

# 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`.

## Request

```
GET https://api.truemarkets.co/v1/gateway/transactions
```

### Authentication

Bearer token in `Authorization`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `TM-On-Behalf-Of` | header | string (uuid) | no | 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. |
| `type` | query | array of string, one of `order`, `transfer`, `ramp`, `received_transfer` | no | Comma-separated types to include. Defaults to all. |
| `status` | query | array of string, one of `pending`, `active`, `completed`, `failed`, `canceled` | no | Comma-separated statuses to include. Defaults to all. |
| `asset_symbol` | query | array of string | no | Comma-separated asset symbols, matched exactly. |
| `asset_type` | query | array of string, one of `spot`, `perp` | no | Comma-separated asset types. Returns orders only. |
| `order_type` | query | array of string, one of `market`, `limit`, `take_profit`, `stop_loss` | no | Comma-separated order types. A take-profit or stop-loss order matches only its trigger type. Returns orders only. |
| `asset_class` | query | array of string, one of `crypto`, `stock` | no | Comma-separated asset classes. Returns orders only. |
| `id` | query | string (uuid) | no | One transaction's id. |
| `tx_hash` | query | string | no | One transaction hash, matched regardless of case. |
| `from` | query | string (date-time) | no | Created at or after this instant. |
| `to` | query | string (date-time) | no | Created before this instant. Must be after `from`. |
| `search` | query | string | no | 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. |
| `cursor` | query | string | no | Opaque pagination cursor from the previous page's `next_cursor` |
| `limit` | query | integer | no | Maximum number of transactions to return |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Transactions retrieved successfully

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array of object | no | List of transactions, newest first |
| `data[].id` | string (uuid) | no | Id of the underlying order, transfer, ramp, or received transfer |
| `data[].type` | string, one of `order`, `transfer`, `ramp`, `received_transfer` | no | Kind of activity a transaction-feed row represents. |
| `data[].asset_flow` | string, one of `in`, `out` | no | Direction the row's asset moved relative to the caller's holdings, for rendering a row without reading the typed object. Scoped to `asset_symbol`, so a buy is `in` even though value moved out. Compose your own label from `type` and this field. |
| `data[].status` | string, one of `pending`, `active`, `completed`, `failed`, `canceled` | no | Lifecycle bucket shared by every type. Each type's native status stays verbatim inside the row's typed object; a received transfer has none and is always `completed`. `active` is an order resting on its venue (`active`, or `cancel_pending` until the cancel lands); `pending` is one not yet live there. |
| `data[].created_at` | string (date-time) | no | When the row was created; for a received transfer, the time of the block that carried it |
| `data[].completed_at` | string (date-time), nullable | no | When the row reached a terminal status; null while in flight |
| `data[].qty` | string, nullable | no | Quantity denominated in `asset_symbol`: executed quantity for a filled order, requested quantity for an unfilled one, tokens sent for a transfer (its base quantity until it sends), settled amount for a ramp, received amount for a received transfer. Null when none is known yet: an unfilled quote-denominated order, a quote-denominated transfer not yet sent, or an unsettled ramp. |
| `data[].asset_id` | string (uuid), nullable | no | Null for ramps until they carry an asset id, and for received transfers |
| `data[].asset_symbol` | string, nullable | no |  |
| `data[].tx_hash` | string, nullable | no | Set once the row settles on-chain |
| `data[].explorer_url` | string, nullable | no | Public block-explorer page for the row: the order's, transfer's, or received transfer's, or the Solana page for a ramp. Null while `tx_hash` is null and for CeFi orders. |
| `data[].failure_reason` | string, nullable | no | Venue-supplied reason, set only on a failed row |
| `data[].order` | object | no | Present only when `type` is `order` |
| `data[].order.order_id` | string | no | Unique order identifier |
| `data[].order.asset_id` | string (uuid), nullable | no | Asset id the order was placed against. May be null for orders sourced directly from the venue. |
| `data[].order.economic_asset_id` | string (uuid), nullable | no | Economic asset the order's listing lists, shared by its listings on every venue and chain. Null when the order recorded none. |
| `data[].order.asset_symbol` | string, nullable | no | Asset symbol the order was placed against. May be null for orders sourced directly from the venue. |
| `data[].order.base_asset` | string | no | Base asset symbol (e.g. `BTC`, `ETH`, `SOL`) |
| `data[].order.quote_asset` | string | no | Quote asset symbol (the CeFi listing's instrument quote, e.g. `PYUSD` or `USDC`; `USDC` for DeFi) |
| `data[].order.type` | string, one of `market`, `limit` | no | 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`. |
| `data[].order.side` | string, one of `buy`, `sell` | no | 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. |
| `data[].order.price` | string, nullable | no | For limit orders, the limit price submitted. For market orders, the reference price at order creation. Null when no price was recorded. |
| `data[].order.qty` | string | no | Original order quantity in the denomination specified by `qty_unit` at creation |
| `data[].order.qty_unit` | string, one of `base`, `quote` | no | Denomination of `qty` at creation |
| `data[].order.executed_qty` | string | no | Quantity of the base asset that has been filled so far |
| `data[].order.leaves_qty` | string | no | Remaining base asset quantity yet to be filled. Zero when the order is complete. |
| `data[].order.executed_vwap` | string | no | Volume-weighted average price across all fills for this order |
| `data[].order.fee` | string | no | 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`. |
| `data[].order.tx_hash` | string | no | On-chain transaction hash for DeFi orders. Omitted for CeFi orders. |
| `data[].order.explorer_url` | string | no | 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. |
| `data[].order.failure_reason` | string | no | Human-readable reason the order failed, such as insufficient balance. Present only on failed orders. |
| `data[].order.venue` | string, one of `defi`, `cefi` | no | The trading venue to filter by. * **defi** — Decentralized exchange (on-chain swaps). * **cefi** — Centralized exchange (off-chain order book). |
| `data[].order.chain` | string | no | Chain the DeFi order executed on. Omitted for CeFi orders. |
| `data[].order.status` | string, one of `initialized`, `pending`, `cancel_pending`, `complete`, `canceled`, `active`, `failed` | no | 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). |
| `data[].order.created_at` | string (date-time) | no | Timestamp when the order was created (RFC 3339) |
| `data[].order.asset_type` | string, one of `spot`, `perp` | no | 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. |
| `data[].order.trigger` | object | no | 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. |
| `data[].order.trigger.type` | string, one of `take_profit`, `stop_loss` | yes | Trigger direction relative to the position. |
| `data[].order.trigger.price` | string | yes | Trigger price per unit of base asset as a decimal string. |
| `data[].order.placed_by` | string, one of `user`, `service` | no | Who placed the order: the user, or a platform service acting for them, such as a strategy trading from their Strategies wallet. |
| `data[].order.strategy_managed` | boolean | no | 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. |
| `data[].transfer` | object | no | Present only when `type` is `transfer` |
| `data[].transfer.id` | string (uuid) | yes | Unique transfer identifier |
| `data[].transfer.status` | string, one of `awaiting_signature`, `pending`, `completed`, `failed` | yes | The current status of the transfer. * **awaiting_signature** — Transfer has been created and is waiting for the client to sign the unsigned payloads and call the execute endpoint. * **pending** — Signed transaction has been submitted and is awaiting on-chain confirmation. * **completed** — Transfer has been confirmed on-chain. * **failed** — Transfer failed due to an on-chain error or rejection. |
| `data[].transfer.venue` | string, one of `defi`, `cefi` | yes | The trading venue to filter by. * **defi** — Decentralized exchange (on-chain swaps). * **cefi** — Centralized exchange (off-chain order book). |
| `data[].transfer.asset_id` | string (uuid) | yes | Asset identifier |
| `data[].transfer.asset_symbol` | string | yes | Asset ticker symbol (e.g. `USDC`, `SOL`) |
| `data[].transfer.chain` | string, nullable | yes | Blockchain network (e.g. `solana`, `base`) for DeFi transfers, or null for CeFi transfers |
| `data[].transfer.network` | string, nullable | yes | Destination network the CeFi withdrawal was submitted on (one of the asset's supported networks from `GET /assets`), or null for DeFi transfers. |
| `data[].transfer.to` | string | yes | Destination wallet address |
| `data[].transfer.qty` | string | yes | Transfer quantity as a decimal string |
| `data[].transfer.qty_unit` | string, one of `base`, `quote` | yes | Unit of the quantity |
| `data[].transfer.sent` | string | yes | Amount sent as a decimal string |
| `data[].transfer.fee` | string | yes | Fee as a decimal string |
| `data[].transfer.received` | string | yes | Amount received as a decimal string |
| `data[].transfer.tx_hash` | string | yes | On-chain transaction hash |
| `data[].transfer.explorer_url` | string, nullable | no | Public block-explorer page for `tx_hash`, null until the transfer is broadcast |
| `data[].transfer.payloads` | array of object | yes | Unsigned transaction payloads for the client to sign. Present when status is `awaiting_signature`; empty array after execution. |
| `data[].transfer.payloads[].digest` | string | yes | Lowercase hex SHA-256 of the `payload` bytes. A signing API that takes a pre-hashed input signs the hex-decoded digest; a library that hashes its input takes `payload` instead. Passing the hex digest to a library that hashes signs the wrong bytes. |
| `data[].transfer.payloads[].payload` | string | yes | The exact text to sign: a Turnkey activity as JSON, including its trailing newline. Sign its UTF-8 bytes as-is with ECDSA P-256 and SHA-256; never decode, reformat or re-serialize it. |
| `data[].transfer.created_at` | string (date-time) | yes | Timestamp when the transfer was created (RFC 3339) |
| `data[].transfer.updated_at` | string (date-time) | yes | Timestamp of the last status update (RFC 3339) |
| `data[].ramp` | object | no | Present only when `type` is `ramp` |
| `data[].ramp.id` | string (uuid) | yes |  |
| `data[].ramp.payment_method` | string, one of `COINBASE`, `PAYPAL`, `APPLE_PAY`, `GOOGLE_PAY` | yes | Rail the ramp is funded or paid out through. DeFi routes the provider from it, so it is the caller's only choice of venue. `APPLE_PAY` and `GOOGLE_PAY` are onramp-only and require a `channel`. |
| `data[].ramp.direction` | string, one of `onramp`, `offramp` | yes |  |
| `data[].ramp.status` | string, one of `created`, `pending`, `completed`, `failed`, `expired` | yes | Ramp lifecycle: `created` until funds move, `pending` while the provider settles, then `completed`, `failed`, or `expired` if it was abandoned before any funds moved. |
| `data[].ramp.amount` | string | yes | Amount requested at creation, in the settlement asset |
| `data[].ramp.chain` | string | yes | Chain the ramp settles on |
| `data[].ramp.asset_symbol` | string | no |  |
| `data[].ramp.asset_amount` | string | no | Amount actually settled |
| `data[].ramp.fiat_currency` | string | no |  |
| `data[].ramp.fiat_amount` | string | no |  |
| `data[].ramp.fee_amount` | string | no |  |
| `data[].ramp.fee_currency` | string | no |  |
| `data[].ramp.exchange_rate` | string | no |  |
| `data[].ramp.wallet_address` | string | no | Address the ramp settles against |
| `data[].ramp.provider_wallet_address` | string | no | Provider deposit address the offramp transfer sends to |
| `data[].ramp.tx_hash` | string | no |  |
| `data[].ramp.redirect_url` | string | no |  |
| `data[].ramp.failure_reason` | string | no |  |
| `data[].ramp.created_at` | string (date-time) | yes |  |
| `data[].ramp.updated_at` | string (date-time) | yes |  |
| `data[].ramp.completed_at` | string (date-time) | no |  |
| `data[].received_transfer` | object | no | Present only when `type` is `received_transfer` |
| `data[].received_transfer.id` | string (uuid) | yes |  |
| `data[].received_transfer.chain` | string | yes | Chain the transfer landed on |
| `data[].received_transfer.tx_hash` | string | yes |  |
| `data[].received_transfer.from_address` | string | yes | Address the transfer came from |
| `data[].received_transfer.to_address` | string | yes | The caller's wallet address it credited |
| `data[].received_transfer.token_address` | string | yes | Contract or mint address of the token received |
| `data[].received_transfer.token_symbol` | string | yes |  |
| `data[].received_transfer.amount` | string | yes | Amount received, in `token_symbol` |
| `data[].received_transfer.observed_at` | string (date-time) | yes | Time of the block that carried the transfer |
| `pagination` | object | no | Cursor-based pagination metadata. The cursor is opaque and must be passed back verbatim; never parse or construct one. |
| `pagination.next_cursor` | string, nullable | no | Opaque cursor for the next page, null when the feed is exhausted |
| `pagination.limit` | integer | no | Number of items per page |

### 400

Bad request

### 401

Unauthorized

### 403

Forbidden. On order creation this also covers an asset that is not available to trade from the country the request came from.

### 500

Internal server error

### 503

Service unavailable
