Skip to main content
GET
List wallets

Authorizations

Authorization
string
header
required

API key issued during merchant onboarding.

Query Parameters

customer_id
string

Restrict to one customer (cust_… id). Omit to list all wallets in the integration.

Example:

"cust_01HXYZABC1234567890ABCDEFG"

currency
string

2–8 uppercase alphanumerics. Exact match.

Example:

"USDC"

page
integer
default:1

1-indexed page number.

Required range: 1 <= x <= 1000000
Example:

1

per_page
integer
default:20

Page size (1–50). Capped tighter than other list endpoints because each wallet is composed with a live ledger balance.

Required range: 1 <= x <= 50
Example:

20

Response

Wallets fetched successfully

status
enum<boolean>
required
Available options:
true
Example:

true

message
string
required

Human-readable summary

Example:

"Wallets fetched successfully"

code
enum<string>
required
Available options:
ok
Example:

"ok"

data
object[]
required
meta
object
required