List wallets
Lists the balance-holding wallets provisioned in the project, most recent first — fiat and custodial — unless orderBy=balance is set. Balance ordering uses available balance valued in USD; balances without a USD estimate are placed last. The default direction is descending. Balance ordering uses live values, not a point-in-time snapshot. Balance or token decimal metadata changes between pages can cause wallets to be skipped or repeated during traversal. Internal deposit-routing addresses and native gas-token wallets (e.g. pol, eth, sol) are not returned. Omitting customerId returns every wallet in the project; providing it scopes the list to that customer. A well-formed customerId that matches no customer returns an empty list; a present-but-blank customerId is a 400. Each item carries customer, an object holding the owning customer’s id. When customerId names a customer enrolled with the custody provider and type is either omitted or custodial, the listing refreshes that customer’s custodial wallets from the custody provider before rendering; every other request, the project-wide listing included, is served from OMS’s own records with no per-request provider call. Balances are re-read on that same refresh only once the stored values have aged past a freshness window. The refresh is best-effort and no failure of it is ever surfaced, whatever its cause: the response carries the records OMS holds. Balance ordering requires stored balances and token decimal metadata; failure to load either returns 500.
Authorizations
Token from POST /auth/token
Query Parameters
Opaque cursor from nextCursor on the previous page.
Scope to a customer. cst_ prefix.
Filter by wallet type: custodial and fiat return rows whose type is walletCrypto and walletFiat. An empty value is treated as omitted. noncustodial currently returns an empty list.
Public wallet variants accepted by the top-level wallet list filter.
custodial, noncustodial, fiat Free-text search. Matches wallet id or on-chain address.
Alias for search.
Order by available balance's estimated USD value.
balance Balance sort direction. Defaults to desc; requires orderBy=balance.
asc, desc claimed adds wallets that a live deposit address or virtual account currently claims, which the default page leaves out. It also includes custodial wallets the default page leaves out for address reuse. Omitting this param leaves default behavior unchanged.
Values GET /wallets' includeHidden param accepts. claimed widens the default page to include wallets a live deposit address or virtual account currently claims. Omitting the param leaves default listing behavior unchanged. Deleted wallets are never listed.
claimed Response
The request has succeeded.
Canonical paginated envelope for the top-level wallet list.
list The walletCrypto variant — one crypto asset on one network, held on the customer's behalf by the custody provider, currently "Coinme Inc.". address is the on-chain deposit address and is omitted until the provider reports one.
- Crypto wallet
- Fiat wallet