Retrieve all wallets and their balances for a given account. Each wallet holds a single currency.

Example Request

curl https://api.neutron.me/api/v2/account/YOUR_ACCOUNT_ID/wallet/ \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

⚠️
Note the trailing slash on /wallet/ — it's required.

Example Response

{
  "data": [
    {
      "id": "wal_btc_001",
      "ccy": "BTC",
      "amount": 0.01523,
      "availableBalance": 0.01500,
      "accountId": "ne01-abc123def456",
      "createdAt": "2025-01-15T10:00:00.000Z",
      "updatedAt": "2026-02-08T12:00:00.000Z"
    },
    {
      "id": "wal_usdt_001",
      "ccy": "USDT",
      "amount": 250.00,
      "availableBalance": 250.00,
      "accountId": "ne01-abc123def456",
      "createdAt": "2025-03-01T10:00:00.000Z",
      "updatedAt": "2026-02-07T18:00:00.000Z"
    },
    {
      "id": "wal_vnd_001",
      "ccy": "VND",
      "amount": 5000000,
      "availableBalance": 5000000,
      "accountId": "ne01-abc123def456",
      "createdAt": "2025-06-01T10:00:00.000Z",
      "updatedAt": "2026-02-06T09:00:00.000Z"
    }
  ]
}

Response Fields

Field	Type	Description
`id`	string	Unique wallet identifier
`ccy`	string	Currency code (`BTC`, `USDT`, `VND`, `USD`, `CAD`, etc.)
`amount`	number	Total balance (includes reserved funds)
`availableBalance`	number	Balance available for transactions
`accountId`	string	Account that owns this wallet
`createdAt`	string	Wallet creation timestamp
`updatedAt`	string	Last update timestamp

Balance vs Available Balance

Field	Meaning
`amount`	Total balance including funds reserved by pending transactions
`availableBalance`	What you can actually spend right now

When a transaction is in quoted or srccreated state, funds may be reserved — amount stays the same but availableBalance decreases.

Access Control

The authenticated account must be the same as or the parent of the requested accountId
Requesting wallets for an unrelated account returns 401 Unauthorized

200Success

401Unauthorized

403Forbidden

404Not Found