能量 API 文档

# 1) rent 65,000 energy for 1 hour
curl "https://api.trxapi.io/api/v1/openapi/getenergy?apikey=YOUR_API_KEY&add=TR7NHqjeKQx...&value=65000&hour=1"

# 2) poll the order until it reaches a terminal state
curl "https://api.trxapi.io/api/v1/openapi/order?apikey=YOUR_API_KEY&orderId=10001"

# 3) check your prepaid balance
curl "https://api.trxapi.io/api/v1/openapi/balance?apikey=YOUR_API_KEY"

{
  "code": 200,          // 200 = success, otherwise an error code
  "message": "SUCCESS", // human-readable, do NOT branch on it
  "data": { /* endpoint-specific payload */ },
  "traceId": "7c2c1d6f..."
}

# Python — order and poll until terminal state
import time, requests

BASE = "https://api.trxapi.io/api/v1/openapi"
KEY  = "YOUR_API_KEY"

def rent(address, value=65000, hour=1, trace=None):
    params = {"apikey": KEY, "add": address, "value": value, "hour": hour}
    if trace: params["traceId"] = trace
    r = requests.get(f"{BASE}/getenergy", params=params, timeout=15).json()
    assert r["code"] == 200, r
    return r["data"]["orderId"]

def wait_done(order_id, timeout=60):
    deadline = time.time() + timeout
    while time.time() < deadline:
        r = requests.get(f"{BASE}/order", params={"apikey": KEY, "orderId": order_id}, timeout=15).json()
        if r["code"] == 200 and r["data"]["status"] in ("completed", "failed"):
            return r["data"]
        time.sleep(2)
    raise TimeoutError(order_id)

order_id = rent("TR7NHqjeKQx...", trace="withdraw-8801")
print(wait_done(order_id))

// Node.js 18+ — order and poll (native fetch)
const BASE = 'https://api.trxapi.io/api/v1/openapi';
const KEY  = process.env.TRXAPI_KEY;

async function call(path, params) {
  const qs = new URLSearchParams({ apikey: KEY, ...params });
  const res = await fetch(`${BASE}/${path}?${qs}`);
  const body = await res.json();
  if (body.code !== 200) throw new Error(`code ${body.code}`);
  return body.data;
}

const { orderId } = await call('getenergy', { add: 'TR7NHqjeKQx...', value: 65000, hour: 1 });
for (;;) {
  const o = await call('order', { orderId });
  if (o.status !== 'processing') { console.log(o); break; }
  await new Promise(r => setTimeout(r, 2000));
}

# example: order rejected for insufficient balance
{
  "code": 502,
  "message": "Insufficient balance",
  "data": null
}