List Wallets

Returns a paginated list of active customer wallets — one entry per customer, currency and network — with the customer's display name, the network, the on-chain wallet address, current available balance, and wallet status.

Query Parameters

Field	Type	Description
`page`	`integer`	Page number, starting at 1. Default `1`.
`pageSize`	`integer`	Items per page, 1–100. Default `50`.
`customerId`	`string (uuid)`	Restricts results to one customer's wallets. Optional — see note below.

Note: customerId is optional on this endpoint and on List Transactions — every other endpoint in this API requires it and rejects the request with 422 when it's missing. Here, omitting it returns active wallets for every customer in the tenant, paginated. If a partner integration should only ever see its own customers' wallets, always pass customerId explicitly when calling this endpoint.

Response envelope

This endpoint does not use the standard data / requestId / timestamp envelope. It returns:

{
  "data": [ ],
  "pagination": { "total": 0, "limit": 50, "offset": 0, "hasMore": false }
}

The request ID is available in the X-Request-Id response header instead of the response body.

Response Fields

Field	Type	Description
`data[].customerName`	`string`	Customer's display name — the business name for business accounts, otherwise the customer's full name
`data[].currency`	`string`	Currency ticker of the wallet (e.g. `USDT`)
`data[].network`	`string`	Blockchain network of the wallet (e.g. `TRC-20`)
`data[].walletAddress`	`string`	On-chain wallet address for that currency and network
`data[].balance`	`number`	Current available balance in that currency
`data[].status`	`string`	Wallet status (e.g. `Active`)
`pagination.total`	`integer`	Total matching wallets across all pages
`pagination.limit`	`integer`	Page size used
`pagination.offset`	`integer`	Number of items skipped before this page
`pagination.hasMore`	`boolean`	Whether a further page is available

{ "data": [ { "customerName": "Acme Trading Ltd", "currency": "USDT", "network": "TRC-20", "walletAddress": "TWFgpZGWq85xkGmUS8guHsuXQhkCqedfsj", "balance": 1250.75, "status": "Active" }, { "customerName": "Jane Doe", "currency": "BTC", "network": "BTC", "walletAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh", "balance": 0.0431, "status": "Active" } ], "pagination": { "total": 2, "limit": 50, "offset": 0, "hasMore": false } }

Request

Responses