Retrieve crypto wallet balance (self-serve)
GET/payment-methods/crypto/:currency/balance
The authenticated account's crypto wallet balance for the given currency, in integer minor units. Account-generic — serves merchants, individuals and partners identically (the account-scoped sibling of GET /balances). Zeros when no wallet/balance exists yet. accountId reads on behalf of an onboarded account.
Request
Path Parameters
currency stringrequired
Crypto currency code, e.g. BASE-USDC.
Query Parameters
accountId uuid
Read on behalf of an account you onboarded (onboarding relationship). Defaults to the authenticated account.
Responses
- 200
- 403
Crypto wallet balance
- application/json
- Schema
- Example (from schema)
Schema
data
object
account_id uuid
currency string
available_minor integer
pending_minor integer
{
"data": {
"account_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"currency": "BASE-USDC",
"available_minor": 10000,
"pending_minor": 0
}
}
Forbidden — accountId is not an account you onboarded.
Loading...