Skip to main content
The following functionality exists for wallets reconstituted server-side. More on Privy architecture here
  • REST API
  • NodeJS
  • Java
  • Rust
Privy supports fetching wallet balances by the wallet ID.To do so, make a GET request to
https://api.privy.io/v1/wallets/<wallet_id>/balance
replacing <wallet_id> with the ID of your desired wallet.

​
Response

​
balance
string
The wallet’s native token balance in the smallest denomination (e.g., wei for Ethereum). Returned as a string to maintain precision.
​
chain_type
string
The blockchain type (e.g., “ethereum”, “solana”).
​
address
string
The wallet’s public address.

​
Example

For example, your app might fetch a wallet’s balance using the cURL request below.
$ curl --request GET https://api.privy.io/v1/wallets/<wallet_id>/balance \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H 'Content-Type: application/json'
The response might look like
{
  "balances": [
    {
      "chain": "base",
      "asset": "eth",
      "raw_value": "1000000000000000000",
      "raw_value_decimals": 18,
      "display_values": {
        "eth": "0.001",
        "usd": "2.56"
      }
    }
  ]
}

​
Parameters and Returns

Check out the API reference for more details.