---
title: "Get the on-chain ERC-20 balance of an address"
method: GET
path: "/v1/token/balance"
tags: ["Token"]
---

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

`GET /v1/token/balance`

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

## Query parameters

- `token_address` string, required
- `owner` string, required
- `chain` string, required

## Response `200`

Successful response.

- TokenBalance — Current on-chain ERC-20 balance of an owner address.
  - `balance` string, 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.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.dev/coinlist/apis/frontline-api.md) · [All operations](https://skmtc.dev/coinlist/apis/frontline-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coinlist/frontline-api/revisions/fa411ea1bdfb/schema)