Get Wallet Balance

curl --request GET \
  --url 'https://staging.crossmint.com/api/2025-06-09/wallets/email:user@example.com:evm/balances?tokens=usdc,eth,pol&chains=base-sepolia,polygon-amoy' \
  --header 'X-API-KEY: <x-api-key>'

const url =
    "https://staging.crossmint.com/api/2025-06-09/wallets/email:user@example.com:evm/balances?tokens=usdc,eth,pol&chains=base-sepolia,polygon-amoy";
const options = { method: "GET", headers: { "X-API-KEY": "<x-api-key>" }, body: undefined };

try {
    const response = await fetch(url, options);
    const data = await response.json();

    // Process each token's balance across chains
    data.forEach((token) => {
        console.log(`${token.symbol}${token.name ? ` (${token.name})` : ""}:`);
        console.log(`  Total amount: ${token.amount} (${token.rawAmount} raw)`);
        console.log(`  Decimals: ${token.decimals}`);

        // Access balance data for each chain
        Object.entries(token.chains).forEach(([chainName, chainBalance]) => {
            console.log(`  ${chainName}: ${chainBalance.amount}`);
            console.log(`    Locator: ${chainBalance.locator}`);
            if (chainBalance.contractAddress) {
                console.log(`    Contract: ${chainBalance.contractAddress}`);
            } else if (chainBalance.mintHash) {
                console.log(`    Mint Hash: ${chainBalance.mintHash}`);
            } else if (chainBalance.contractId) {
                console.log(`    Contract ID: ${chainBalance.contractId}`);
            }
        });
        console.log();
    });
} catch (error) {
    console.error(error);
}

import requests

url = "https://staging.crossmint.com/api/2025-06-09/wallets/email:user@example.com:evm/balances"

querystring = { "tokens": "usdc,eth,pol", "chains": "base-sepolia,polygon-amoy" }

headers = { "X-API-KEY": "<x-api-key>" }

response = requests.get(url, params=querystring, headers=headers)
data = response.json()

# Process each token's balance across chains
for token in data:
    name_part = f" ({token['name']})" if token.get('name') else ""
    print(f"{token['symbol']}{name_part}:")
    print(f"  Total amount: {token['amount']} ({token['rawAmount']} raw)")
    print(f"  Decimals: {token['decimals']}")

    # Access balance data for each chain
    for chain_name, chain_balance in token['chains'].items():
        print(f"  {chain_name}: {chain_balance['amount']}")
        print(f"    Locator: {chain_balance['locator']}")
        if 'contractAddress' in chain_balance:
            print(f"    Contract: {chain_balance['contractAddress']}")
        elif 'mintHash' in chain_balance:
            print(f"    Mint Hash: {chain_balance['mintHash']}")
        elif 'contractId' in chain_balance:
            print(f"    Contract ID: {chain_balance['contractId']}")
    print()