Docs
搜索⌘ K
  • 主页
  • 关于 The Graph
  • 支持的网络
  • 协议合约
  • 子图
    • 子流
      • 代币 API
        • AI Suite
          • 索引
            • 资源
              代币 API > EVM端点

              Historical Balances

              GET/historical/balances/evm/{address}

              Provides historical ERC-20 & Native balances by wallet address.

              路径参数

              参数描述值
              address
              string

              Filter by address

                必填

                查询参数

                参数描述值
                network_id
                string

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

                • 默认值: mainnet
                • 可选值: arbitrum-one, avalanche, base, bsc, mainnet, matic, optimism, unichain
                必填
                mainnet
                interval

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

                  contracts
                  array
                  • 默认值:
                  startTime
                  integer

                  UNIX timestamp in seconds.

                  • 最小值: -9007199254740991
                  • 最大值: 9007199254740991
                  endTime
                  integer

                  UNIX timestamp in seconds.

                  • 默认值: 9999999999
                  • 最小值: -9007199254740991
                  • 最大值: 9007199254740991
                  limit
                  integer

                  The maximum number of items returned in a single request.

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

                  The page number of the results to return.

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

                  可能的反应

                  状态描述
                  200Successful Response
                  400Client side error
                  401Authentication failed
                  403Forbidden
                  404Not found
                  500Server side error
                  ⁠在GitHub上编辑⁠

                  Transfer Events按合约地址分类的代币持有人
                  测试此终点

                  1curl --request GET \2  --url 'https://token-api.thegraph.com/historical/balances/evm/{address}?network_id=mainnet&startTime=0&endTime=9999999999&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                  1{2  "data": [3    {4      "datetime": "2025-05-29 00:00:00",5      "contract": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",6      "name": "Native",7      "symbol": "ETH",8      "decimals": 18,9      "open": 237.63774262699187,10      "high": 237.6377453469919,11      "low": 0.10533323067535896,12      "close": 0.15438623067535898,13      "network_id": "mainnet"14    }15  ]16}
                  The GraphStatusTestnetBrand AssetsForum安全Privacy PolicyTerms of Service