v1

latestOpenAPI 3.0.02026-07-22243670.8 KB
Token

Get the on-chain ERC-20 balance of an address

Reads balanceOf(owner) on the ERC-20 token contract. Used to display the balance of the connected wallet the user will pay with.

get/v1/token/balance

Query parameters

token_addressstring required
Example:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

The ERC-20 token contract address

ownerstring required
Example:0x8ba1f109551bd432803012645ac136ddd64dba72

The address owning the tokens

chainstring required
Example:ethereum_sepolia

The EVM chain to read from, e.g. ethereum_mainnet, ethereum_sepolia, base_mainnet or base_sepolia

Response

Successful response.

balancestring required

The balance as a uint256 decimal string in the token's smallest unit

object'token_balance' required

String representing the object's type. Objects of the same type share the same value.

Example response

{
  "balance": "1000000"
}