List account wallets

Retrieve all the wallets' information associated with the account

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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

FieldTypeDescription
idstringUnique wallet identifier
ccystringCurrency code (BTC, USDT, VND, USD, CAD, etc.)
amountnumberTotal balance (includes reserved funds)
availableBalancenumberBalance available for transactions
accountIdstringAccount that owns this wallet
createdAtstringWallet creation timestamp
updatedAtstringLast update timestamp

Balance vs Available Balance

FieldMeaning
amountTotal balance including funds reserved by pending transactions
availableBalanceWhat 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
Path Params
string
required

The unique identifier of the account to retrieve

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain