Transaction History

Returns the transaction history for a specific wallet with pagination and optional filtering.

Authentication

Requires X-API-Key header.

Path parameters

Parameter	Type	Description
`id`	string	Wallet UUID

Query parameters

Parameter	Type	Default	Description
`limit`	number	50	Max records (max 200)
`offset`	number	0	Pagination offset
`status`	string	--	Filter: `pending`, `confirmed`, `failed`
`chain`	string	--	Filter by chain

Request

curl "http://localhost:4000/v1/wallets/WALLET_ID/transactions?limit=10&chain=base" \
  -H "X-API-Key: ak_your_key"

Response (200)

{
  "transactions": [
    {
      "id": "tx-uuid",
      "wallet_id": "wallet-uuid",
      "type": "transfer",
      "chain": "base",
      "from_address": "0x742d35Cc...",
      "to_address": "0xRecipient...",
      "amount": "10.00",
      "currency": "USDC",
      "tx_hash": "0xabc123...",
      "status": "confirmed",
      "cost_usd": 10.00,
      "created_at": "2026-03-26T12:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 10,
    "offset": 0,
    "has_more": true
  }
}

Transaction types

Type	Description
`transfer`	Outgoing token transfer
`withdrawal`	Withdrawal to external address
`funding`	Incoming deposit request
`swap`	Token swap
`trading_query`	Hyperliquid info query
`trading_order`	Hyperliquid order

Errors

Status	Code	Description
404	`NOT_FOUND`	Wallet not found

Transaction History

On this page