Retrieve details for a specific wallet by ID, including currency and balance.

Example Request

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

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"
  }
}

Response Fields

Field	Type	Description
`id`	string	Unique wallet identifier
`ccy`	string	Currency code (`BTC`, `USDT`, `VND`, `USD`, 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

amount — Total balance, including funds reserved by pending transactions
availableBalance — What you can actually spend

If availableBalance is less than amount, you have pending transactions with reserved funds.

When to Use This vs List Wallets

Endpoint	Use when
List account wallets	You need all wallet balances (e.g., dashboard overview)
Get wallet info (this page)	You need a specific wallet's balance (e.g., checking BTC before a send)

Access Control

The authenticated account must be the same as or the parent of the requested accountId
Invalid wallet ID returns 404 Not Found
Wrong account returns 403 Forbidden

200Success

401Unauthorized

403Forbidden

404Not Found