Skip to main content
GET
Get Wallet Balance
Retrieves the user’s wallet balance from the blockchain using their wallet address. The endpoint follows a fallback strategy, first attempting to fetch USDC balance, then ETH, and finally any other non-zero balance.

Request Headers

string
required
Your API key for authentication

Response

boolean
Whether the balance retrieval was successful
string
Current wallet balance formatted as a string to preserve precision
string
Asset type (USDC, ETH, or other cryptocurrency)
string
Additional information about the balance retrieval (appears when balance fetching methods fail)

Status Codes

Notes

  • Requires authentication with a valid API key.
  • The endpoint uses a fallback strategy: first checks USDC, then ETH, and finally any other non-zero balance.
  • Balance is returned as a string to preserve precision for financial calculations.
  • If all balance fetching methods fail, the API will return a successful response with a zero balance and an explanatory message.