订单 API 概览

POST 面向非托管钱包集成的公开 API。

基础 URL

https://api.tronzap.com

所有接口均接受并返回 JSON 格式数据。

必要请求头

Content-Type: application/json
Accept: application/json

无需认证请求头。订单 API 完全公开。

频率限制

• 所有 /v1/orders* 接口每 IP 每秒最多 1 个请求。
• 超出限制将返回 HTTP 429 Too Many Requests。
• 在同一 address_from + address_to 组合已有订单处于 new 状态时，无法再创建第二个活跃订单。

响应包装格式

每个成功响应都会将数据包装在统一的信封结构中：

{
  "code": 0,
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "result": {}
}

字段	类型	描述
code	integer	成功时为 0，出错时为非零值。参见错误码。
request_id	string	本次请求的唯一 UUID。反馈问题时请附上此值。
result	object	各接口专属的响应数据。

接口列表

方法	接口	描述
POST	/v1/orders/calculate	价格计算——不创建订单
POST	/v1/orders	创建订单并获取充值地址
POST	/v1/orders/check	查询订单状态
POST	/v1/orders/cancel	取消处于 new 状态的订单

referral_code 字段

赚取佣金——始终传入 referral_code

在每次 POST /v1/orders 请求体中包含您的 referral_code。未附有效推荐码的订单不会归属到任何合作伙伴账户，不会产生佣金。

请参阅合作伙伴入驻以获取您的推荐码。