TRONENS API

Response format

A real API response always contains success and, on success, data. Errors contain a machine-readable error code. The diagnostic test file also shows method, url, http_code, duration_ms, request, response and curl_error; those fields are not part of the public API. The actual TRONENS response is the value inside response.

{
  "success": true,
  "data": { ... }
}

{
  "success": false,
  "error": "ERROR_CODE"
}

Authentication

Authorization: Bearer te_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Send the Bearer token in the Authorization header. The key is created in the account and shown in full only once.

Each key can have an IP whitelist, per-minute rate limit and expiration. Responses include X-RateLimit-Limit and X-RateLimit-Remaining; HTTP 429 also includes Retry-After.

Quote

Returns the customer price including the account discount.

GET /api/v1/quote/?package_id=1&duration_minutes=15
GET /api/v1/quote/?energy_amount=65000&duration_minutes=60

Example response

{
  "success": true,
  "data": {
    "type": "custom",
    "energy_amount": 65000,
    "duration_minutes": 60,
    "base_price_trx": 1.961,
    "discount_percent": 0,
    "discount_trx": 0,
    "price_trx": 2.05
  }
}

Energy estimate

Estimates the Energy requirement for a recipient TRON address.

{
  "recipient_address": "T...",
  "has_usdt": true
}

Example response

{
  "success": true,
  "data": {
    "estimated_energy": 65000,
    "recommended_package": {
      "id": 1,
      "name": "65 000 Energy",
      "energy_amount": 65000,
      "duration_minutes": 15
    }
  }
}

Create order

Creates a real order and debits the calculated amount from the account TRX balance. The recipient TRON address must already be activated before the order is created. New API orders are accepted asynchronously with HTTP 202. Always use external_id when possible: repeating it returns the existing order without a second debit.

{
  "external_id": "merchant_93481",
  "package_id": 1,
  "duration_minutes": 15,
  "address": "T..."
}

Example response

HTTP 202
{
  "success": true,
  "data": {
    "order_id": 123,
    "external_id": "merchant_93481",
    "status": "processing",
    "idempotent": false
  }
}

Order status

Returns the current order data and status.

GET /api/v1/status/?id=123
GET /api/v1/status/?external_id=merchant_93481

Time fields use YYYY-MM-DD HH:MM:SS in the TRONENS server timezone.

Example response

{
  "success": true,
  "data": {
    "id": 123,
    "external_id": "merchant_93481",
    "address": "T...",
    "energy_amount": 65000,
    "duration_minutes": 15,
    "price_trx": 1.14,
    "status": "delegated",
    "txid": "...",
    "refunded": false,
    "error_code": null,
    "created_at": "2026-10-03 18:01:00",
    "delivered_at": "2026-10-03 18:01:12",
    "completed_at": null,
    "updated_at": "2026-10-03 18:01:12"
  }
}

Status

Balance

Current available TRX balance of the account.

{"success":true,"data":{"balance_trx":125.5}}

Webhook

Webhooks deliver order data when its status changes. Verify the signature against the raw JSON body and webhook secret.

X-Webhook-Event: order.delegated
X-Webhook-Id: order-123-order.delegated-...
X-Webhook-Signature: sha256=<hex_hmac>

expected = HMAC_SHA256(raw_json_body, webhook_secret)

{
  "event": "order.delegated",
  "event_id": "order-123-order.delegated-...",
  "created_at": "2026-10-03T15:01:12Z",
  "data": {
    "order_id": 123,
    "external_id": "merchant_93481",
    "address": "T...",
    "energy_amount": 65000,
    "duration_minutes": 15,
    "price_trx": 1.14,
    "status": "delegated",
    "txid": "...",
    "refunded": false,
    "error_code": null,
    "created_at": "2026-10-03 18:01:00",
    "delivered_at": "2026-10-03 18:01:12",
    "completed_at": null,
    "updated_at": "2026-10-03 18:01:12"
  }
}

Events: order.processing, order.delegating, order.delegated, order.undelegating, order.completed, order.review, order.failed. HTTP 2xx marks delivery successful; temporary failures are retried up to 8 times with backoff. Deduplicate by event_id.

Errors

error codes are intended for programmatic handling. Use the HTTP status and the error field.