Developers

API Reference

Automate energy delegation with our REST API. Simple auth, predictable responses.

Authentication

Bearer token in Authorization header.

Authorization: Bearer tf_live_xxxxxxxxxxxxxxxxxx

Base URL:

https://api.tronify.info/v2

Sandbox: https://sandbox.tronify.info/v2 with tf_test_ keys.

Errors

{
  "error": "invalid_address",
  "message": "The target is not a valid TRON address",
  "req": "fr_8d2a1b"
}
CodeMeaning
400Bad request / validation
401Auth failed
404Resource not found
429Rate limit exceeded
500Internal server error

Rate Limits

TierRequests/min
Standard60
Enterprise500

Get Quote

GET/quote

ParamTypeReq
transactionsint (1–100)Yes
hoursint (1–96)Yes

Response

{
  "energy": 1303000,
  "transactions": 20,
  "hours": 1,
  "price_trx": 30.00,
  "price_usd": 7.20,
  "ttl": 300
}

Create Order

POST/orders

FieldTypeReq
targetstring (TRON addr)Yes
transactionsintYes
hoursintYes
refstring (idempotency)No

Response

{
  "id": "fee_9c3d7a",
  "status": "awaiting_payment",
  "price_trx": 30.00,
  "pay_address": "TQmVf...",
  "expires_at": "2025-08-12T10:30:00Z"
}

Order Status

GET/orders/{id}

{
  "id": "fee_9c3d7a",
  "status": "delegated",
  "energy": 1303000,
  "target": "TJxK7...",
  "started_at": "2025-08-12T10:01:05Z",
  "ends_at": "2025-08-12T11:01:05Z"
}
StatusMeaning
awaiting_paymentWaiting for TRX
confirmingPayment seen
delegatedEnergy active
completedPeriod ended
failedError, refunded

Account

GET/account

{
  "balance_trx": 180.50,
  "active_delegations": 3,
  "lifetime_orders": 847
}

Webhooks

POST to your URL. Signed with HMAC-SHA256 in X-Tronify-Sig.

{
  "event": "delegation.active",
  "order_id": "fee_9c3d7a",
  "ts": "2025-08-12T10:01:05Z"
}

Events: delegation.active, delegation.completed, delegation.failed.