GET /wallets/balance

Fetch on-chain balance for a user-owned wallet.

Returns SOL balance and all token holdings.

Use case

Pre-flight check before a transfer, snipe funding, or volume-bot payment — verify the wallet has enough SOL before you commit.

Query

Param	Required	Description
walletAddress	yes	Pubkey to check.

Response 200

{
  "balance": {
    "address": "…",
    "solBalance": 1.234,
    "solBalanceLamports": 1234000000,
    "tokens": [
      { "address": "mint…", "balance": 1000000, "decimals": 6 }
    ]
  }
}

Field	Description
balance.address	Wallet pubkey.
balance.solBalance	SOL balance in SOL units.
balance.solBalanceLamports	SOL balance in lamports.
balance.tokens	Token accounts held by the wallet.
balance.tokens[].address	Token mint address.
balance.tokens[].balance	Raw token amount.
balance.tokens[].decimals	Token decimals.

Example

curl "$BASE_URL/wallets/balance?walletAddress=…" \
  -H "Authorization: Bearer $ACCESS" \
  -H "x-user-id: $USER_ID"