ERC20 地址:格式、balanceOf 与通过 API 创建
ERC20 地址是 Ethereum 为每个钱包使用的、以 0x 开头的 42 个字符的账户地址。账户持有遵循 ERC-20 标准的代币时,它就被称为 ERC-20 地址。同一个字符串在 Polygon 和 Arbitrum 上也有效,因为它们与 EVM 兼容,但代币和余额各链独立。
对合约调用 balanceOf(address) 得到 ERC-20 余额。通过 REST,GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} 返回已解码的同一数值。接收分享地址即可,发送需要密钥和 gas 用的 ETH。
本页涵盖地址格式、balanceOf、同一地址在 Polygon 和 Arbitrum 上的用法,以及通过 REST 创建地址。
ERC-20 标准是什么?
ERC-20 是 Ethereum 上同质化代币的标准接口。EIP-20 定义了六个函数:totalSupply、balanceOf、transfer、transferFrom、approve 和 allowance,以及 Transfer 和 Approval 两个事件。实现了这些函数的合约就是合规的代币。因此钱包和交易所支持新代币时,不必为每个代币单独开发。
ethereum.org 的 ERC-20 概述用示例讲解了同一套接口。完整机制见我们的 ERC20 代币标准文章。本页只讲地址这一侧:ERC-20 地址是什么,以及如何在代码中使用。
ERC-20 地址是什么样的?
ERC-20 地址就是普通的 Ethereum 地址,例如 0x5aAeb6053F3E94C9b9A09f33669435E7Ef1BeAed。它由 0x 加 40 个十六进制字符组成,共 42 个字符。ethereum.org 账户文档把它描述为账户公钥 Keccak-256 哈希的最后 20 字节。
这个名称只在特定语境中出现。当讨论的是地址所持有的代币时,它才被称为「ERC-20 地址」。字符串本身没有任何标记表明它支持代币,同一个地址可以用于 ETH、所有 ERC-20 代币和 NFT。
- 0x 前缀表示该值为十六进制。
- 40 个十六进制字符即 20 字节,是公钥 Keccak-256 哈希的最后 20 字节。
- 总共 42 个字符。其中大小写字母的混合排布就是 EIP-55 校验和。
balanceOf 如何读取 ERC-20 余额?
balanceOf(address) 是只读函数,返回某个地址的代币余额。余额并不存放在地址上,而是保存在代币的智能合约里,是一个以地址为键的映射,balanceOf 负责查询它。
直接调用它,意味着要对代币合约编码一个 JSON-RPC eth_call,再解码返回的十六进制数据。结果是以代币最小单位表示的整数,所以还必须读取 decimals()。许多稳定币用 6 位小数,其他的用 18 位,搞错小数位是造成相差一百万倍的常见原因。
Chaingateway API 替你完成编码和小数位处理。余额接口返回普通数字,原本的原始 RPC 问题就变成了一次普通的 REST 响应。
同一个 ERC-20 地址在 Polygon 和 Arbitrum 上也有效吗?
有效。Polygon 和 Arbitrum 与 EVM 兼容,所以它们的地址使用完全相同的 0x 格式。由同一私钥派生的地址,在 Ethereum、Polygon 和 Arbitrum 上是同一串字符。
但该地址上的代币并不共享。部署在 Ethereum 上的代币合约,在 Polygon 上并不存在,除非有人在那里部署它或桥接该资产。因此余额是各链独立的,即使地址相同。Polygon 上的代币遵循同一套 ERC-20 接口,所以一套代码路径就能服务这三条链。
ERC-721 与 ERC-721A:另一套标准,相同的地址格式
ERC-721 是 Ethereum 的非同质化代币标准。每个代币 ID 都是唯一的,这与 ERC-20 可互换的余额不同。EIP-721 规定了它的接口。
ERC-721A 是同一接口的 gas 优化实现,常用于批量铸造的系列。它改变的是合约内部存储数据的方式,而不是持有者地址的样子。两套标准都用同样的 0x 地址表示所有权。ERC721 代币标准文章深入讲解 NFT 一侧。
通过 REST 创建并读取 ERC-20 地址
六个路由覆盖了支付集成中地址的整个生命周期。
| 接口 | 作用 |
|---|---|
POST /api/v2/ethereum/addresses | 生成新的 Ethereum 地址 |
POST /api/v2/ethereum/addresses/import | 导入私钥,让 API 能够代表该地址签名 |
GET /api/v2/ethereum/balances/{address}/erc20/{contract_address} | 单个 ERC-20 代币的余额,已解码 |
GET /api/v2/ethereum/balances/{address}/erc20 | 钱包中所有代币的余额 |
POST /api/v2/ethereum/webhooks | 注册 webhook,监控该地址收到的 ERC-20 存款 |
POST /api/v2/ethereum/transactions/erc20 | 从该地址发送 ERC-20 代币 |
把路径中的 /ethereum/ 换成 /polygon/ 或 /arbitrum/,请求格式保持不变,因为三条链共用同一种地址格式和 ERC-20 接口。
不用 eth_call 读取 ERC-20 余额
下面的合约地址是 Ethereum 主网上的 USDT。加上 X-Network: testnet 可改为查询测试网代币。
curl https://app.chaingateway.io/api/v2/ethereum/balances/0xYourAddress/erc20/0xdAC17F958D2ee523a2206206994597C13D831ec7 \
-H "Authorization: Bearer YOUR_API_KEY"发送前如何校验 ERC-20 地址?
来源
- EIP-20: Token Standard
- ERC-20 token standard(ethereum.org)
- Ethereum accounts(ethereum.org)
- ERC-55: Mixed-case checksum address encoding
查证日期:2026 年 11 月 5 日。
想读取 ERC-20 余额,又不想手动解码 balanceOf 调用?创建免费账户,通过 REST 查询测试网地址:7 天试用,无需信用卡,无需 KYC。
常见问题:ERC-20 地址
准备好在 Ethereum、Polygon 或 Arbitrum 上开发了吗?
创建账户,今天就查询一次测试网 ERC-20 余额:7 天试用,无需信用卡,无需 KYC。完整参考见 Ethereum API 文档,也可以用多链区块链 API覆盖全部七条链。