Get balance
curl --request GET \
--url https://api.example.com/api/v1/user/balanceconst options = {method: 'GET'};
fetch('https://api.example.com/api/v1/user/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/api/v1/user/balance"
response = requests.get(url)
print(response.text)Financials
Get balance
List all accounts and current balances for the authenticated user.
GET
/
api
/
v1
/
user
/
balance
Get balance
curl --request GET \
--url https://api.example.com/api/v1/user/balanceconst options = {method: 'GET'};
fetch('https://api.example.com/api/v1/user/balance', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.example.com/api/v1/user/balance"
response = requests.get(url)
print(response.text)Requires
Authorization: Bearer <user-access-token> — the token from Verify login code. See Authentication for details.id from the response to reference a specific account in deposit, transfer, or transaction requests.
This returns the same data as List accounts — both are backed by the same endpoint.
Request
GET /api/v1/user/balance
Authorization: Bearer <user-access-token>
Response
200 OK{
"items": [
{
"id": 619,
"asset": "USDC",
"type": "LIABILITY",
"credits": "1500.00000000",
"debits": "0.00000000"
}
],
"meta": {
"totalItems": 1,
"totalPages": 1,
"currentPage": 1,
"itemsPerPage": 20
}
}
items[]
| Field | Type | Description |
|---|---|---|
id | number | Account ID |
asset | string | Currency — always "USDC" today |
type | string | "LIABILITY" |
credits | string | Total decimal amount credited to the account — not a smallest-unit integer |
debits | string | Total decimal amount debited from the account — not a smallest-unit integer |
Available balance is
credits - debits. There is no separate balance field in the response.meta
| Field | Type | Description |
|---|---|---|
totalItems | number | Total number of accounts |
totalPages | number | Total pages |
currentPage | number | Current page number |
itemsPerPage | number | Items per page (default 20) |