Docs
⌘ K

Historical Balances

GET/v1/evm/balances/historical

Returns wallet token balance changes over time in OHLCV format.

OHLCV historical depth is subject to plan restrictions.

Query Parameters

ParameterDescriptionValue
network
string

The Graph Network ID for EVM networks https://thegraph.com/networks

  • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, optimism, polygon, unichain
Required
mainnet
address
string

Filter by address

  • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
  • Format: evm-address
Required
contract
string

Filter by contract address
Single value or array of values* (separate multiple values with ,)
*Plan restricted.

  • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
  • Format: evm-address
interval
string

The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).
*Plan restricted.

  • Default value: 1d
  • Accepted values: 1h, 4h, 1d, 1w
1d
start_time
string

UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

    end_time
    string

    UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

      limit
      integer

      Number of items* returned in a single request.
      *Plan restricted.

      • Default value: 10
      • Minimum value: 1
      • Maximum value: 1000
      page
      integer

      Page number to fetch.
      Empty data array signifies end of results.

      • Default value: 1
      • Minimum value: 1
      • Maximum value: 767465558638

      Potential Responses

      StatusDescription
      200

      Successful Response

      400

      Client side error

      401

      Authentication failed

      403

      Forbidden

      404

      Not found

      500

      Server side error