How to check the native token balance for a wallet.

Wallet Balance

Check a Wallet's Balance

Endpoint: GET /baas/wallets/:address/balance

Required scope: wallet:read

Note: use the wallet address (not the ID) in the URL path.

bash

curl https://gateway.dev.passkallet.com/sepolia/api/v1/passkallet/baas/wallets/0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18/balance \
  -H "x-api-key: pk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4"

json

{
  "statusCode": 200,
  "content": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
    "nativeBalance": "1500000000000000000",
    "nativeBalanceFormatted": "1.5"
  }
}

Response Fields

Field	Description
`address`	The wallet address queried
`nativeBalance`	Raw balance in wei (smallest unit, as string)
`nativeBalanceFormatted`	Human-readable balance (e.g. "1.5" means 1.5 POL)

Understanding Balances

The native token on Polygon is POL. Balances are returned in two formats:

nativeBalance: The raw wei value as a string (e.g. "1500000000000000000" = 1.5 POL)
nativeBalanceFormatted: Human-readable decimal format (e.g. "1.5")

Balances are live. This endpoint queries the blockchain in real time. Consider caching for a few seconds to avoid hitting rate limits. Use webhooks to know when a wallet receives tokens instead of polling.

This endpoint only returns the native token (POL) balance. To check ERC-20 token balances, use the token resolve endpoint or query on-chain directly.