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

    		Required
    contract
    string

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

      interval
      string

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

      • 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", ...).

      • Default value: 2025-01-01
      end_time
      string

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

      • Default value: 2050-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