Docs
搜索⌘ K
  • 主页
  • 关于 The Graph
  • 支持的网络
  • 协议合约
  • 子图
    • 子流
      • 代币 API
        • Hypergraph
          • 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.

                    • 默认值: 1735689600
                    • 最小值: -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=1735689600&endTime=9999999999&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

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