能量 API 文档

# 请求：下单租 65000 能量 1 小时
curl "https://api.trxapi.io/api/v1/openapi/getenergy?apikey=YOUR_API_KEY&add=TR7NHqjeKQx...&value=65000&hour=1"

# 响应
{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "orderId": "10001",
    "amount": "16.9",
    "currency": "TRX",
    "balance": "1263.60",
    "txid": "a1b2c3d4..."
  },
  "traceId": "7c2c1d6f..."
}

# 请求：激活地址
curl "https://api.trxapi.io/api/v1/openapi/activation?apikey=YOUR_API_KEY&add=TR7NHqjeKQx..."

# 响应
{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "add": "TR7NHqjeKQx...",
    "txid": "a1b2c3d4...",
    "amount": "2.5"
  }
}

# 请求：查询订单状态
curl "https://api.trxapi.io/api/v1/openapi/order?apikey=YOUR_API_KEY&orderId=10001"

# 响应
{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "orderId": "10001",
    "status": "completed",
    "txid": "a1b2c3d4...",
    "source": "api"
  }
}

# 请求：查询商户余额
curl "https://api.trxapi.io/api/v1/openapi/balance?apikey=YOUR_API_KEY"

# 响应
{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "balance": "1280.50",
    "currency": "TRX",
    "usdtBalance": "0"
  }
}

# all tiers
curl "https://api.trxapi.io/api/v1/openapi/price?apikey=YOUR_API_KEY"
{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "currency": "TRX",
    "prices": [
      { "value": 65000, "hour": 1, "price": "3.9" },
      { "value": 130000, "hour": 1, "price": "7.6" }
    ]
  }
}

# single tier
curl "https://api.trxapi.io/api/v1/openapi/price?apikey=YOUR_API_KEY&value=65000&hour=1"
{ "code": 200, "data": { "value": 65000, "hour": 1, "price": "3.9", "currency": "TRX" } }

# top up the sender before paying USDT to a recipient
curl "https://api.trxapi.io/api/v1/openapi/estimate?apikey=YOUR_API_KEY&receiver=TSenderAddr...&destination=TRecipient..."
{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "ordered": true,
    "sufficient": false,
    "pending": false,
    "currentEnergy": 1200,
    "value": 130000,
    "hour": 1,
    "hasUsdt": false,
    "activated": true,
    "conservative": false,
    "orderId": "10002",
    "amount": "7.6",
    "currency": "TRX",
    "txid": "e5f6a7b8...",
    "balance": "1256.00"
  }
}

# keep at least 65,000 energy on the address
curl "https://api.trxapi.io/api/v1/openapi/topup?apikey=YOUR_API_KEY&add=TR7NHqjeKQx...&value=65000&hour=1"
# energy already enough → no order, no charge
{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "ordered": false,
    "sufficient": true,
    "pending": false,
    "currentEnergy": 71000,
    "value": 65000,
    "hour": 1,
    "balance": "1263.60"
  }
}

curl "https://api.trxapi.io/api/v1/openapi/topup/save?apikey=YOUR_API_KEY&add=TR7NHqjeKQx...&value=65000&hour=1&label=hot-wallet&daily_limit=20"
{ "code": 200, "data": { "add": "TR7NHqjeKQx...", "label": "hot-wallet", "value": 65000, "hour": 1, "auto": true, "dailyLimit": 20 } }

# 服务器 → 你的回调地址
POST https://your-domain.com/webhook
X-Timestamp: 1712345678
X-Signature: sha256=9f86d081884c...

{
  "event": "order.completed",
  "orderId": "10001",
  "status": "completed",
  "txid": "a1b2c3d4...",
  "timestamp": 1712345678
}

# 验签：用你的密钥按下式计算，与 X-Signature 比对
sig = "sha256=" + hex(hmac_sha256(secret, ts + "." + rawBody))

# Python (Flask)
import hmac, hashlib

def verify(secret: str, ts: str, raw_body: bytes, header_sig: str) -> bool:
    mac = hmac.new(secret.encode(), f"{ts}.".encode() + raw_body, hashlib.sha256)
    expected = "sha256=" + mac.hexdigest()
    return hmac.compare_digest(expected, header_sig)

// Node.js (Express — use the raw body, not the parsed JSON)
const crypto = require('crypto');

function verify(secret, ts, rawBody, headerSig) {
  const expected = 'sha256=' + crypto.createHmac('sha256', secret)
    .update(ts + '.' + rawBody).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(headerSig));
}