在以太坊生态中，ERC20代币是最常见的代币标准，被广泛应用于稳定币（如USDT、USDC）、治理代币（如UNI、AAVE）、NFT相关代币等多种场景，无论是项目方进行代币分发管理、投资者分析代币分布，还是安全研究员追踪异常资金流向，查询ERC20代币的持有者信息都是核心需求，本文将详细介绍以太坊查询ERC20代币持有者的多种方法，包括区块链浏览器、专业数据API、节点工具及代码实现,帮助不同技术背景的用户高效获取所需数据。
区块链浏览器是以太坊上最直观、最易用的数据查询工具，它将链上数据以可视化界面呈现,无需技术基础即可完成ERC20代币持有者查询。
以太坊常用的区块链浏览器包括：
ERC20代币的所有信息（包括持有者列表）都存储在其智能合约中，因此首先需要知道代币的合约地址。
打开Etherscan，在顶部搜索框输入代币合约地址，进入代币详情页，输入USDT的合约地址0xdAC17F958D2ee523a2206206994597C13D831ec7，即可看到代币基本信息（如名称、符号、总供应量等）。
在代币详情页顶部导航栏找到“Token Holders”（代币持有者）标签，点击进入，页面会展示以下关键信息：
对于需要频繁查询、批量获取数据或集成到应用中的用户，专业数据API是更高效的选择，这些API由区块链数据服务商提供，封装了复杂的链上交互逻辑,支持通过简单调用获取结构化数据。
访问Moralis官网，注册账号后进入“Dashboard”，创建新应用即可获取API Key（免费版有一定调用次数限制）。
Moralis提供了getTokenOwners接口，专门用于查询ERC20代币持有者，以下是以Python为例的代码实现：
import requests
import json
# 配置API Key和代币合约地址
API_KEY = "your_moralis_api_key"
CONTRACT_ADDRESS = "0xdAC17F958D2ee523a2206206994597C13D831ec7" # USDT合约地址
CHAIN = "eth" # 以太坊链
# 构建请求URL
url = f"https://deep-index.moralis.io/api/v2.2/erc20/{CONTRACT_ADDRESS}/owners"
# 设置请求头
headers = {
"Accept": "application/json",
"X-API-Key": API_KEY,
}
# 可选参数：分页、排序等
params = {
"chain": CHAIN,
"limit": 100, # 每页返回100条
"offset": 0, # 起始偏移量
}
# 发送GET请求
response = requests.get(url, headers=headers, params=params)
data = response.json()
# 解析结果
if "result" in data:
for owner in data["result"]:
address = owner["owner_of"]
balance = owner["balance"] # 余额为原始数值，需除以代币精度（如USDT精度为18）
print(f"地址: {address}, 余额: {float(balance) / 1e18:.2f} USDT")
else:
print("查询失败:", data.get("error", "未知错误"))
limit：每页返回结果数量（默认100，最大1000）； offset：分页偏移量，用于获取下一页数据（如第一页offset=0，第二页offset=100）； chain：链标识（如eth为以太坊，bsc为币安链）； to_block：可选参数，指定查询的区块高度（如需历史数据）。 对于需要完全自主控制数据、避免依赖第三方服务的用户，可以通过搭建以太坊节点，直接调用智能合约的balanceOf方法查询持有者余额，这种方法技术门槛较高，但数据最实时、最可控。
以Geth为例，执行以下命令启动全节点（首次同步需下载大量数据，建议使用SSD硬盘）：
geth --syncmode full --http --http.addr 0.0.0.0 --http.port 8545
--syncmode full：同步所有区块数据（归档节点需--gcmode archive）； --http：开启HTTP API，方便其他工具调用； --http.addr和--http.port：设置HTTP服务地址和端口（默认8545）。 ERC20代币的持有者余额通过balanceOf(address)方法查询，该方法返回指定地址的代币余额（原始数值，需除以代币精度）。
from web3 import Web3
# 连接到本地以太坊节点
w3 = Web3(Web3.HTTPProvider("http://127.0.0.1:8545"))
# 代币合约ABI（balanceOf方法的部分）
abi = "[{'constant':True,'inputs
友情链接：
