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).
      *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