API ReferenceTransactions

List transactions

View as MarkdownOpen in Claude
Recent history for that asset, newest first, capped by the service's page size (10 by default). Every chain is normalised to the same row shape. `type` is `send` or `receive` relative to this user, `amount` is denominated in the asset, and `fee` is denominated in the chain's **native** currency. Sources: Bitcoin Core `listtransactions`, Etherscan v2 (EVM), TronGrid (TRON), RPC signatures (Solana). An empty history is `[]`, not an error.

Authentication

AuthorizationBearer

A 15-minute token from /auth. Required on every endpoint except /auth.

Headers

X-Request-IdstringOptional
Correlation id. Generated if omitted, echoed on every response, and written to the audit log.
X-USER-IDstringOptionalformat: "^[0-9a-fA-F]{24}$"

Sent by the trusted gateway. When present it overrides any userId in the body.

Request

This endpoint expects an object.
userIdstringRequiredformat: "^[0-9a-fA-F]{24}$"

24-character hex id, returned by /create.

assetIdenumRequired
Primary asset selector. An all-digit string (`"21"`) is accepted and normalised to an integer. - `1` — BITCOIN BTC (native, 8 decimals) - `2` — ETHEREUM ETH (native, 18 decimals) - `21` — ETHEREUM USDT (ERC20, 6 decimals) - `22` — ETHEREUM USDC (ERC20, 6 decimals) - `3` — BNB BNB (native, 18 decimals) - `31` — BNB USDT (BEP20, 18 decimals) - `32` — BNB USDC (BEP20, 18 decimals) - `4` — TRON TRX (native, 6 decimals) - `41` — TRON USDT (TRC20, 6 decimals) - `42` — TRON USDC (TRC20, 6 decimals) - `5` — POLYGON POL (native, 18 decimals) - `51` — POLYGON USDT (ERC20, 6 decimals) — mainnet only - `52` — POLYGON USDC (ERC20, 6 decimals) - `6` — SOLANA SOL (native, 9 decimals) - `61` — SOLANA USDT (SPL, 6 decimals) — mainnet only - `62` — SOLANA USDC (SPL, 6 decimals)

Response

OK
resultlist of objects
requestIdstring

Echo of the inbound X-Request-Id, or a generated one.

Errors

400
Bad Request Error
401
Unauthorized Error
503
Service Unavailable Error