快速开始

本指南带你从零到完成一笔能量订单。你需要一个已充值的账户和一个 API key。

1. 创建账户和 API key

API key 在主站发放，而不是通过 API：

在 https://www.hexvetron.com 登录首页。
打开账户菜单（你的邮箱），选择 API，然后点击创建 API key。
点击发送邮件验证码，输入发到你邮箱的验证码，然后创建 key。
保存 access key id 和 secret —— secret 只显示一次。

secret 加密存储；如果丢失，请吊销该 key 并重新创建一个。

2. 签名请求

每个请求都用 HMAC-SHA256 签名。完整方案见认证。下面是一个自包含的 bash 示例，用于创建报价：

SECRET="YOUR_API_SECRET"
KEY="YOUR_ACCESS_KEY_ID"

BODY='{"amount":64400,"duration_minutes":60}'
TS=$(date +%s)
NONCE=$(openssl rand -hex 16)
BODY_HASH=$(printf '%s' "$BODY" | openssl dgst -sha256 -hex | awk '{print $2}')
CANONICAL=$(printf 'TEA1-HMAC-SHA256\nPOST\n/api/v1/energy/quotes\n\n%s\n%s\n%s' "$TS" "$NONCE" "$BODY_HASH")
SIGNATURE=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$SECRET" -hex | awk '{print $2}')

curl -X POST "https://api.hexvetron.com/api/v1/energy/quotes" \
  -H "content-type: application/json" \
  -H "x-api-key: $KEY" \
  -H "x-timestamp: $TS" \
  -H "x-nonce: $NONCE" \
  -H "x-body-hash: $BODY_HASH" \
  -H "x-signature: $SIGNATURE" \
  -d "$BODY"

响应是一个报价，包含 quote_id 和 customer_price：

{
  "data": {
    "quote_id": "qte_…",
    "product": "TRON_ENERGY",
    "amount": 64400,
    "duration_minutes": 60,
    "customer_price": "2.093",
    "currency": "TRX",
    "expires_at": "2026-09-22T12:01:00.000Z",
    "target_activated": true
  },
  "request_id": "…"
}

3. 下单

单次调用创建订单——传入数量、时长、目标地址，以及你自己生成的幂等键：

BODY='{"amount":64400,"duration_minutes":60,"target_address":"TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE","idempotency_key":"idem-0001"}'
# 用同样的方案签名（method 为 POST，path 为 /api/v1/energy/orders），然后 POST 到 https://api.hexvetron.com/api/v1/energy/orders

价格在下单时实时解析。如果你在第 2 步创建了报价并想锁定该价格，可凭报价下单，使用 POST /api/v1/energy/apply_quote_orders。

对于无时长的能量充值，请改用能量速充接口 POST /api/v1/energy/flash_orders。

4. 轮询直到订单结算

# GET https://api.hexvetron.com/api/v1/energy/orders/<order_id> （需签名）

每隔几秒轮询一次，直到 status 为 COMPLETED、FAILED 或 RECONCILIATION_REQUIRED。订单完成后，能量会代理到目标地址。