---
title: "Base ERC-20 Balance: Token Balance of Any Wallet on Base"
method: GET
path: "/v1/base-erc20-balance"
tags: ["Base"]
---

# Base ERC-20 Balance: Token Balance of Any Wallet on Base

`GET /v1/base-erc20-balance`

## Request

- Base URL: `https://api.ambolt.dev`
- URL: `https://api.ambolt.dev/v1/base-erc20-balance`
- Auth: none required

ERC-20 token balance of a wallet address on Base mainnet (USDC, WETH, any token): raw units, decimals, symbol and formatted amount, read live via eth_call.

## Query parameters

- `address` string, required: Wallet address.
- `token` string, required: ERC-20 token contract address on Base.
- `free` '1'

## Response `200`

Result (JSON). Every result names its source and the time it was read.

- object

## Other responses

- `400`: Invalid input; not charged.
- `402`: Payment required: 0.003 USD in USDC (x402 v2).

---

[API](https://skmtc.dev/ambolt/apis/ambolt-data-tools.md) · [All operations](https://skmtc.dev/ambolt/apis/ambolt-data-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/ambolt/apis/ambolt-data-tools/revisions/8397885dd82f?raw)