API v2 - Documentation

Quote. Order. Track.
Ship energy in minutes.

Public API v2 for Energy, Bandwidth, flash top-ups, and auto-refill. From zero to first delegation in minutes.

Quickstart
quickstart.sh
# 1. Get a quote
curl https://api.profeex.io/api/v2/energy/quote \
  -H "X-API-Key: $API_KEY" \
  -G -d "count=65000&currency=TRX"

# 2. Buy energy
curl -X POST https://api.profeex.io/api/v2/energy/orders \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address": "TXa...", "count": 65000, "currency": "TRX"}'

# 3. Check order status
curl https://api.profeex.io/api/v2/orders/$ORDER_ID \
  -H "X-API-Key: $API_KEY"
Endpoints
GET/api/v2/energy/quote

Get a live price for 1-hour Energy (TRX or USDT)

Query

?count=65000&currency=TRX

Response

{ "count": 65000, "price_sun": "42", "amount": "2.73", "currency": "TRX" }
POST/api/v2/energy/orders

Buy Energy and delegate it to a TRON address

Request body

{ "address": "TXa...", "count": 65000, "currency": "TRX" }

Response

{ "order_id": "a1b2c3d4-...", "status": "pending", "amount": "2.73", "currency": "TRX" }
GET/api/v2/orders/:order_id

Check order status and on-chain transaction id

Response

{ "order_id": "a1b2c3d4-...", "status": "completed", "txid": "abc123...", "count": 65000 }
GET/api/v2/account

Check TRX / USDT balances and deposit address

Response

{ "balances": { "trx": "1250.5", "usdt": "420.0" }, "deposit_address": "TXa..." }
Order status

Orders return immediately as pending, then settle on-chain. Poll GET /api/v2/orders/:order_id until status is completed - typically within a minute.

order status
GET /api/v2/orders/a1b2c3d4-...

{
  "order_id": "a1b2c3d4-...",
  "status": "completed",
  "address": "TXa...",
  "count": 65000,
  "amount": "2.73",
  "currency": "TRX",
  "txid": "abc123..."
}
Error codes

Structured errors
for every failure mode

CodeHTTPDescription
E_RATE_LIMIT429Too many requests. Retry after the indicated delay.
E_INSUFFICIENT_BALANCE402Not enough TRX or USDT on the account.
E_VALIDATION422Invalid request parameters.
E_NOT_ACTIVATED428Address is not activated. Activate first or set activate: true on Energy orders.
E_TEMP_UNAVAILABLE503Temporary capacity issue. Retry in 30 seconds.
Specs

API specs
& limits

≤ 10s

API response time (avg)

excl. client network

10 req/s

Rate limit

per API key

3-60s

On-chain delegation

typical, network-dependent

Free

API call cost

pay only for energy

Authentication

All requests require an API key in the X-API-Key header. Get your key from the Profeex dashboard.

X-API-Key: your_api_key_here
Get started

Ship your first delegation
in under 30 minutes

API key, sandbox, typed SDKs - most teams integrate in one session. Failed or incomplete requests follow your commercial agreement and the published SLA.

Get API KeyCase studies