Fetch balance via API

Privy supports fetching wallet balances by wallet ID. Balances can be queried for named assets (e.g. eth, usdc) or custom assets by contract address.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.

Query parameters

string | string[]

Named asset(s) to query (e.g. eth, usdc). Use together with chain. Cannot be used with token.Supported values: usdc, usdc.e, eth, pol, usdt, eurc, usdb, pathusd, sol, trx

string | string[]

Chain(s) to query named assets on. Use together with asset. Cannot be used with token.Supported values: ethereum, arbitrum, base, tempo, linea, optimism, polygon, solana, tron, zksync_era, sepolia, arbitrum_sepolia, base_sepolia, linea_testnet, optimism_sepolia, polygon_amoy, solana_devnet, solana_testnet, tron_nile

string | string[]

Token contract address(es) in chain:address format. Use this to query balances for arbitrary ERC-20 or SPL tokens.

EVM example: base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Solana example: solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Tron example: tron:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

Cannot be used together with asset/chain or include_currency. Up to 10 tokens per request.

string

Convert balances to a fiat currency. Supported values: usd, eur. Not supported when token is provided.

Examples

Named assets

Fetch a named asset balance using asset and chain:

$ curl --request GET 'https://api.privy.io/v1/wallets/<wallet_id>/balance?asset=eth&chain=base&include_currency=usd' \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H 'Content-Type: application/json'

{
  "balances": [
    {
      "chain": "base",
      "asset": "eth",
      "raw_value": "1000000000000000000",
      "raw_value_decimals": 18,
      "display_values": {
        "eth": "0.001",
        "usd": "2.56"
      }
    }
  ]
}

Custom tokens

Fetch the balance of an arbitrary token by contract address using the token parameter:

$ curl --request GET 'https://api.privy.io/v1/wallets/<wallet_id>/balance?token=base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H 'Content-Type: application/json'

{
  "balances": [
    {
      "chain": "base",
      "asset": "erc20:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "raw_value": "1000000",
      "raw_value_decimals": 6,
      "display_values": {
        "token": "1.0"
      }
    }
  ]
}

Tron (TRX and TRC-20)

Fetch TRX balance on Tron mainnet:

$ curl --request GET 'https://api.privy.io/v1/wallets/<wallet_id>/balance?asset=trx&chain=tron&include_currency=usd' \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H 'Content-Type: application/json'

{
  "balances": [
    {
      "chain": "tron",
      "asset": "trx",
      "raw_value": "1000000",
      "raw_value_decimals": 6,
      "display_values": {
        "trx": "1.0",
        "usd": "0.23"
      }
    }
  ]
}

Fetch USDT on Tron mainnet:

$ curl --request GET 'https://api.privy.io/v1/wallets/<wallet_id>/balance?asset=usdt&chain=tron' \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H 'Content-Type: application/json'

Fetch a custom TRC-20 token by contract address:

$ curl --request GET 'https://api.privy.io/v1/wallets/<wallet_id>/balance?token=tron:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t' \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H 'Content-Type: application/json'

Use chain=tron_nile for the Tron Nile testnet. Supported named Tron assets: trx, usdt, usdc. All Tron assets use 6 decimal places.

Full reference

Check out the API reference for more details.

​Query parameters

​Examples

​Named assets

​Custom tokens

​Tron (TRX and TRC-20)

​Full reference

Query parameters

Examples

Named assets

Custom tokens

Tron (TRX and TRC-20)

Full reference