API v1 · REST, JSON

合作伙伴 API

为您的用户自动购买 TRON 能量：查询价格、为地址下单、跟踪状态。价格在下单时锁定，并从预付余额中扣除。

基础 URL https://cryptosales.io

身份验证

每个请求都需在请求头中携带合作伙伴 API 密钥： X-API-Key （或 Authorization: Bearer …）。密钥可在个人中心或 Telegram 机器人中生成；请将其保存在服务器端，切勿暴露在客户端代码中。

curl https://cryptosales.io/api/v1/balance \
  -H "X-API-Key: cs_live_…"

金额与余额

所有金额均为 以 TRX 计的字符串 ，保留 6 位小数，例如 "3.640000"。订单从预付余额中支付：创建订单时冻结相应金额，如果订单未完成， 将自动退回.

余额

GET/api/v1/balance

{ "balance": "96.360000", "name": "Your company" }

价格

您账户的当前价格。适合在下单前展示给用户；最终价格在创建订单时锁定。

GET/api/v1/price?energy=65000&duration=1h

参数	类型	说明
energy	integer	能量数量。65,000 用于 USDT 转账，131,000 用于转给未持有 USDT 的地址。
duration	string	`15m`, `1h`, `3h`, `6h`, `1d`, `3d`, `7d`, `14d`, `30d`。默认值为 `1h`.

{
  "energy": 65000, "duration": "1h", "available": true,
  "price": "3.640000", "priceUsd": 1.2,
  "burn": "6.500000", "savingsPct": 44
}

GET /api/v1/prices?energy=65000 会一次返回所有可用时长的价格： {"prices": [ … ]}.

创建订单

POST/api/v1/orders

字段	类型	说明
receiveAddress	string	接收能量代理的 TRON 地址。必填。
energy	integer	能量数量。必填。
duration	string	租赁时长，默认值为 `1h`.
clientRef	string	您的唯一订单 ID（最多 128 个字符）。建议填写。

幂等性。 使用相同的 clientRef 重复请求时，将返回已创建的订单，不会重复扣款。请始终传递 clientRef，并在网络错误时重试请求。

curl -X POST https://cryptosales.io/api/v1/orders \
  -H "X-API-Key: cs_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "receiveAddress": "TXk8…",
    "energy": 65000,
    "duration": "1h",
    "clientRef": "withdraw-1842"
  }'

// 201 Created
{
  "id": "cs_8f2a91c04be7d3a1e2f0",
  "clientRef": "withdraw-1842",
  "receiveAddress": "TXk8…",
  "energy": 65000,
  "duration": "1h",
  "price": "3.640000",
  "status": "success",
  "refunded": false,
  "createdAt": "2026-10-26T18:30:12Z"
}

能量通常在数秒内到账，状态会立即变为 success。如果状态为 pending ，请使用下方接口每 10–30 秒查询一次订单。

订单状态

GET/api/v1/orders/{id}

{id} 可以是我们的订单 ID，也可以是您的 clientRef。响应为订单对象，与创建时相同。

订单列表

GET/api/v1/orders?limit=20&offset=0

{ "orders": [ … ], "total": 128 }

订单状态

状态		含义
processing		订单已受理，正在执行。
pending		正在等待链上确认代理。
success		能量已代理到该地址。
failed		订单未完成，费用已退回余额（`refunded: true`).
refunded		经审核后已人工退款。

错误与限制

错误会以 HTTP 状态码和如下响应体返回： {"error": "说明"}.

状态码		原因
400		参数无效：地址、数量或时长。
401		API 密钥无效。
402		余额不足。
403		合作伙伴访问已被暂停。
404		订单不存在。
429		超出频率限制——每分钟 300 次请求。
503		暂无可用报价，或订单未完成（资金已退回）。

需要密钥或专属条件？联系我们.