Skip to main content
GET
/
2025-06-09
/
wallets
/
{walletLocator}
/
balances
Get Wallet Balance
curl --request GET \
  --url https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/balances \
  --header 'X-API-KEY: <x-api-key>'
[
  {
    "symbol": "ETH",
    "name": "Ethereum",
    "decimals": 18,
    "amount": "18.8343253454",
    "rawAmount": "18834161225104097789",
    "chains": {
      "base": {
        "contractAddress": "0x123",
        "locator": "base:0x123",
        "amount": "18.833423432423",
        "rawAmount": "18834161225104097789"
      },
      "solana": {
        "mintHash": "123123",
        "locator": "solana:132",
        "amount": "0.000000000000000",
        "rawAmount": "00000000000000000"
      }
    }
  }
]
This is an alpha API and subject to change.

​
Example Request

This example uses placeholder values. Modify the call with the wallet locator, tokens, and chains you would like to use. 
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>'

​
Example Response

The response returns an array of token objects, each containing balance information across the specified chains: 
[
    {
        "symbol": "ETH",
        "name": "Ethereum",
        "decimals": 18,
        "amount": "1.5",
        "rawAmount": "1500000000000000000",
        "chains": {
            "base-sepolia": {
                "locator": "base-sepolia:eth",
                "amount": "1.0",
                "rawAmount": "1000000000000000000"
            },
            "polygon-amoy": {
                "locator": "polygon-amoy:eth",
                "amount": "0.5",
                "rawAmount": "500000000000000000"
            }
        }
    },
    {
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "amount": "100.0",
        "rawAmount": "100000000",
        "chains": {
            "base-sepolia": {
                "locator": "base-sepolia:0x036CbD53842c5426634e7929541eC2318f3dCF7e",
                "amount": "50.0",
                "rawAmount": "50000000",
                "contractAddress": "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
            },
            "polygon-amoy": {
                "locator": "polygon-amoy:0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582",
                "amount": "50.0",
                "rawAmount": "50000000",
                "contractAddress": "0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582"
            }
        }
    },
    {
        "symbol": "SOL",
        "decimals": 9,
        "amount": "2.5",
        "rawAmount": "2500000000",
        "chains": {
            "solana": {
                "locator": "solana:sol",
                "amount": "2.5",
                "rawAmount": "2500000000"
            }
        }
    },
    {
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "amount": "75.0",
        "rawAmount": "75000000",
        "chains": {
            "solana": {
                "locator": "solana:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "amount": "75.0",
                "rawAmount": "75000000",
                "mintHash": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
            }
        }
    }
]

Headers

​
X-API-KEY
string
required

Path Parameters

​
walletLocator
string
required

Query Parameters

​
chains
string
​
tokens
string
required

Response

​
decimals
number
required
Example:
​
amount
string
required
Example:
​
rawAmount
string
required
Example:
​
chains
object
required
Example:
​
symbol
string
​
name
string
Example: