API v2 - Документация

Котировка. Заказ. Статус.
Energy за минуты.

Публичный API v2 для Energy, Bandwidth, flash и auto-refill. От нуля до первого делегирования за минуты.

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

Живая цена на 1-hour Energy (TRX или USDT)

Query

?count=65000&currency=TRX

Response

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

Купить Energy и делегировать на TRON-адрес

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

Проверить статус заказа и on-chain txid

Response

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

Баланс TRX / USDT и адрес для депозита

Response

{ "balances": { "trx": "1250.5", "usdt": "420.0" }, "deposit_address": "TXa..." }
Статус заказа

Заказ сразу возвращается как pending, затем закрывается on-chain. Опрашивайте GET /api/v2/orders/:order_id до status completed - обычно в пределах минуты.

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

{
  "order_id": "a1b2c3d4-...",
  "status": "completed",
  "address": "TXa...",
  "count": 65000,
  "amount": "2.73",
  "currency": "TRX",
  "txid": "abc123..."
}
Коды ошибок

Структурированные ошибки
для каждого сценария сбоя

CodeHTTPDescription
E_RATE_LIMIT429Слишком много запросов. Повторите после указанной задержки.
E_INSUFFICIENT_BALANCE402Недостаточно TRX или USDT на аккаунте.
E_VALIDATION422Некорректные параметры запроса.
E_NOT_ACTIVATED428Адрес не активирован. Сначала активируйте или передайте activate: true в Energy-заказе.
E_TEMP_UNAVAILABLE503Временная проблема с ёмкостью. Повторите через 30 секунд.
Specs

Спецификации API
и лимиты

≤ 10s

Время ответа API (среднее)

без сети клиента

10 req/s

Rate limit

на API-ключ

3-60s

Ончейн-делегирование

обычно, зависит от сети

Free

Стоимость вызова API

платите только за energy

Authentication

Все запросы требуют API-ключ в заголовке X-API-Key. Получите ключ в дашборде Profeex.

X-API-Key: your_api_key_here
Начало работы

Первое делегирование
менее чем за 30 минут

API-ключ, sandbox, типизированные SDK - большинство команд интегрируются за одну сессию. Неудачные или незавершённые запросы - по коммерческому соглашению и опубликованному SLA.

Получить API-ключКейсы