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

                Native Balances

                GET/v1/evm/balances/native

                Returns EVM native balances for wallet addresses.

                查询参数

                参数描述值
                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
                Single value or array of values* (separate multiple values with ,)
                *Plan restricted.

                  必填
                  include_null_balances
                  boolean

                  Include zero/null balances in results

                    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

                    ⁠在GitHub上编辑⁠

                    Historical BalancesToken Balances
                    测试此终点

                    1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/balances/native?network=mainnet&address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045&include_null_balances=false&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                    1{2  "data": [3    {4      "last_update": "2025-10-15 23:16:23",5      "last_update_block_num": 23586308,6      "last_update_timestamp": 1760570183,7      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",8      "contract": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",9      "amount": "784155102524588711",10      "value": 0.7841551025245886,11      "name": "Native",12      "symbol": "ETH",13      "decimals": 18,14      "network": "mainnet"15    }16  ]17}
                    The GraphStatusTestnetBrand AssetsForum安全Privacy PolicyTerms of Service