---
title: "Get ERC20 balance history"
method: GET
path: "/contracts/{contractAddress}/erc20-balance-history"
tags: ["Contracts"]
---

# Get ERC20 balance history

`GET /contracts/{contractAddress}/erc20-balance-history`

Retrieve the historical daily balances of ERC20 tokens ever held by a contract address.

## Path parameters

- `contractAddress` string, required — Starknet contract address (0x-prefixed hex).

## Query parameters

- `timerange` '1y' | '1m' | '3m' | '6m' | '1w' — Time window: "1w", "1m", "3m", "6m", or "1y". Defaults to "1m".
- `token_address` string — Token contract address (0x-prefixed hex).

## Response `200`

Balance history data points

- object[], nullable
  - `address` string, required
  - `name` string, required
  - `symbol` string, required
  - `decimals` number, nullable, required
  - `balance` string, nullable
  - `logo` string
  - `isVerified` boolean, nullable
  - `lastTransferTime` number, nullable
  - `balanceHistory` object[], required
    - `day` string, required
    - `balance` string, nullable

## Other responses

- `400` — Bad Request
- `403` — Forbidden - Missing or invalid API key
- `404` — Not Found
- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.net/voyager/apis/voyager-public-api.md) · [All operations](https://skmtc.net/voyager/apis/voyager-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voyager/voyager-public-api/revisions/172c04ee8115/schema)