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

                按合约地址分类的代币持有人

                GET/holders/evm/{contract}

                EVM 控件端点提供关于持有特定代币地址的信息,包括每个控件持有人的余额。 这有助于分析特定合约的代币分布情况。

                路径参数

                参数描述值
                contract
                string

                Filter by contract 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
                  orderBy
                  string

                  The field by which to order the results.

                  • 默认值: value
                  • 可选值: value
                  value
                  orderDirection
                  string

                  The order in which to return the results: Ascending (asc) or Descending (desc).

                  • 默认值: desc
                  • 可选值: asc, desc
                  desc
                  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上编辑⁠

                  Swap Events代币持有人和按合约地址的供应
                  测试此终点

                  1curl --request GET \2  --url 'https://token-api.thegraph.com/holders/evm/{contract}?network_id=mainnet&orderBy=value&orderDirection=desc&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                  1{2  "data": [3    {4      "block_num": 23381678,5      "last_balance_update": "2025-09-17 08:42:59",6      "address": "0x36aff7001294dae4c2ed4fdefc478a00de77f090",7      "amount": "2896517981175142125080776739",8      "value": 2896517981.1751423,9      "name": "Graph Token",10      "symbol": "GRT",11      "decimals": 18,12      "network_id": "mainnet"13    }14  ]15}
                  The GraphStatusTestnetBrand AssetsForum安全Privacy PolicyTerms of Service