Skip to main content
GET
/
v1
/
wallets
/
{wallet_id}
/
balance
Get balance
curl --request GET \
  --url https://api.privy.io/v1/wallets/{wallet_id}/balance \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'privy-app-id: <privy-app-id>'
{
  "balances": [
    {
      "chain": "base",
      "asset": "eth",
      "raw_value": "1000000000000000000",
      "raw_value_decimals": 18,
      "display_values": {
        "eth": "0.001",
        "usd": "2.56"
      }
    }
  ]
}

​
SDK methods

Learn more about fetching wallet balances using our SDKs here.

Authorizations

​
Authorization
string
header
required

Basic Auth header with your app ID as the username and your app secret as the password.

Headers

​
privy-app-id
string
required

ID of your Privy app.

Path Parameters

​
wallet_id
string
required

ID of the wallet.

Query Parameters

​
asset
required
Available options:
usdc,
eth,
pol,
usdt,
eurc,
sol,
usdc,
eurc
​
chain
required
Available options:
ethereum,
arbitrum,
base,
linea,
optimism,
polygon,
solana,
zksync_era,
sepolia,
arbitrum_sepolia,
base_sepolia,
linea_testnet,
optimism_sepolia,
polygon_amoy,
solana_devnet,
solana_testnet
​
include_currency
enum<string>
Available options:
usd

Response

200 - application/json

Latest wallet balance.

​
balances
object[]
required