---
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`

## Request

- Base URL: `https://public-api.voyager.online/beta`
- URL: `https://public-api.voyager.online/beta/contracts/{contractAddress}/erc20-balance-history`
- Auth: API key in header `x-api-key`

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.dev/voyager/apis/voyager-public-api.md) - [All operations](https://skmtc.dev/voyager/apis/voyager-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voyager/apis/voyager-public-api/revisions/172c04ee8115?raw)