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.

查询参数

参数描述值
network
string

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

  • 可选值: arbitrum-one, avalanche, base, bsc, mainnet, optimism, polygon, unichain
必填
mainnet
address
string

Filter by address

    		必填
    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.

      • 默认值: 1d
      • 可选值: 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", ...).

      • 默认值: 2025-11-18
      end_time
      string

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

      • 默认值: 2050-01-01
      limit
      integer

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

      • 默认值: 10
      • 最小值: 1
      • 最大值: 1000
      page
      integer

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

      • 默认值: 1
      • 最小值: 1
      • 最大值: 767465558638

      可能的反应

      状态描述
      200

      Successful Response

      400

      Client side error

      401

      Authentication failed

      403

      Forbidden

      404

      Not found

      500

      Server side error