🚀 TRC20 API v2.4 · 企业级稳定

波场 TRC20 开发者接口
即插即用 · 毫秒响应

专为交易所、钱包、DeFi 设计的 TRC20 API,支持代币余额、交易广播、合约事件。单节点日处理量超 5000 万次请求。

✅ 免费测试额度 ⚡ 99.99% 可用性 🔐 企业级安全
TRC20 API 接口仪表盘示意
⚙️ 为什么选择 TRC20 API

为高频区块链业务而生

基于波场TRON主网深度优化,提供RESTful + WebSocket 双通道,开发者友好。

极速广播

交易广播平均确认 < 2s,支持批量交易上链,内部节点集群自动路由。

🔎

余额与代币查询

查询任意 TRC20 代币余额、精度、总供应量,支持多地址批量请求。

🔔

事件与日志监听

WebSocket 实时推送 Transfer、Approval 等事件,轻松同步链上状态。

🧩 核心能力

TRC20 API 全方位功能矩阵

覆盖开发全周期,从测试到生产无缝过渡

TRC20 API 功能结构图
1
代币信息 & 持有量

根据合约地址获取代币名称、符号、精度,以及指定地址的余额。支持 TRC20 全系列。

2
交易构建 & 离线签名

提供交易序列化接口,配合离线签名,保障私钥安全。支持 USDT、USDC 等主流 TRC20。

3
合约调用 (智能合约)

通过 API 直接调用合约只读方法或写入方法,返回 decoded 结果,无需搭建节点。

4
交易历史 & 归集

获取地址全部 TRC20 转账记录,支持分页、时间过滤,轻松实现自动归集。

📘 快速接入

开发者文档 · 一分钟上手

基于 RESTful 设计,返回标准 JSON,支持 HTTPS

GET 查询代币余额

GET /v1/trc20/balance?contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t&address=TDk...&api_key=your_key

返回示例:{ "balance": "125000000", "decimals": 6, "symbol": "USDT" }

支持批量查询(最多50个地址),适用于钱包资产展示。

POST 广播交易

POST /v1/trc20/broadcast
{ "transaction": "0x...hex", "signature": "..." }

返回 txid 及上链状态,广播后1-2秒即可查询确认。

支持 TronGrid 快速节点,失败自动重试路由。

WS 实时事件推送

wss://api.trc20.io/v1/ws?events=transfer&contract=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

订阅指定合约的 Transfer 事件,实时推送。

适用于支付监听、链上通知等场景。

🔑 身份验证

所有 API 请求需在 Header 携带 X-API-Key,或作为查询参数 ?api_key=。新用户自动获得每日 10000 次免费调用。

📌 测试网支持 NILE 及 SHASTA

TRC20 API 代码示例
❓ 常见问题

开发者高频提问

我们整理了接入 TRC20 API 时的典型疑问

1. TRC20 API 需要申请吗?是否有免费额度?

注册即享每天 10,000 次免费请求,覆盖余额查询和交易广播。升级专业版可提升至每分钟 600 次。

2. 如何保证 API 密钥安全?

建议将 API Key 存放在服务端环境变量,避免前端暴露。我们支持 IP 白名单及 HMAC 签名模式。

3. 是否支持 TRC20 中的 USDT、USDC、BTT 等代币?

完全支持。只需传入对应的合约地址,接口自动识别代币精度与符号。内置主流代币别名。

4. 交易广播失败一般是什么原因?

常见原因:签名错误、账户带宽不足、合约地址有误。API 会返回具体错误码及原因说明,方便调试。

5. 如何搭建 WebSocket 事件监听?

使用标准 WebSocket 客户端连接 wss 地址,订阅所需事件类型。我们提供 JavaScript、Python、Java 示例。

6. 是否支持查询历史交易?

支持。通过 /v1/trc20/transactions 接口,可按地址、代币、时间范围查询,返回分页结果。

TRC20 API 常见问题图解