如果你在做钱包、交易所、DApp 或商户结算系统，TRX 能量 API 接入能让你的用户在零 TRX 余额下完成 USDT 转账，提升留存与转化。本文给出 cantrx.com 完整 API 接入流程。

API 总览

全能TRX 提供三类核心接口：

  • POST /v1/energy/rent — 能量闪租，按笔即时下单
  • GET /v1/energy/balance — 查询账号剩余笔数与能量额度
  • POST /v1/swap/usdt2trx — USDT 一键闪兑 TRX

第一步：开通 API 密钥

联系商务（bd@cantrx.com）开通代理账户，会拿到一对 AppId 和 AppSecret。代理账户享受批发价格，可自定义下游售价。

第二步：请求签名

每个请求需在 Header 中带 X-App-Id、X-Timestamp、X-Sign。签名规则：

  1. 按字段名 ASCII 升序排列所有参数
  2. 拼接成 k1=v1&k2=v2&timestamp=... 形式
  3. 末尾追加 &secret=AppSecret
  4. 对整串 HMAC-SHA256 后取 hex

第三步：调用能量闪租

示例（伪代码）：

  1. 构造请求体：{ "to_address": "TUserABC...", "tx_count": 1 }
  2. POST 到 https://api.cantrx.com/v1/energy/rent
  3. 响应包含 order_id、energy、tx_hash 三个核心字段
  4. 能量在 3 秒内自动委托到 to_address

第四步：处理回调

能量到账后平台会向你配置的 notify_url POST 回调，包含订单号、能量数量、链上哈希、签名。验签通过后即可在自己业务系统标记订单完成。

典型接入场景

  • 钱包内置代付：用户发起 USDT 转账时检测能量不足，调用 API 自动代付能量后继续转账，体验完全无感。
  • 交易所提现：用户提 U 出去时由交易所代付能量，减少新用户因 TRX 不足无法提现的客诉。
  • 商户结算：批量代发 USDT 工资 / 返佣前，先调用一次批量能量闪租，节省 70% 燃烧成本。

对接技术支持

商务对接邮箱 bd@cantrx.com，开通代理账户后会提供：

  • OpenAPI 3.0 文档与 Postman 集合
  • Node.js / Python / PHP / Go 四种语言 SDK
  • 专属工程师 1v1 联调，覆盖钱包、商户系统等接入场景
建议从 sandbox 环境开始：先用 100 TRX 测试余额跑通整个链路，再切到生产环境配置回调地址。