Build with Tronify.store

Authentication

Include your API key in the Authorization header.

Authorization: Bearer ts_live_xxxxxxxxxxxxxxxxxx

Base URL:

https://api.tronify.store/v1

Sandbox: https://sandbox.tronify.store/v1 with ts_test_ prefix.

Error Handling

Standard HTTP codes with JSON error and message.

{
  "error": "insufficient_balance",
  "message": "Account balance too low for this order",
  "request_id": "req_9f3c7a"
}

Rate Limits

Headers: X-RateLimit-Remaining, X-RateLimit-Reset.

Get Quote

GET/quote

Real-time price estimate.

Response

{
  "energy": 1303000,
  "price_trx": 6.75,
  "price_usd": 1.62,
  "duration_hours": 168,
  "is_promo": true,
  "valid_until": "2025-06-15T12:00:00Z"
}

Create Order

POST/orders

Response

{
  "id": "bid_8f2a9c3d",
  "status": "awaiting_payment",
  "price_trx": 6.75,
  "payment_address": "TLm2p...",
  "expires_at": "2025-06-15T12:30:00Z"
}

Order Status

GET/orders/{order_id}

{
  "id": "bid_8f2a9c3d",
  "status": "active",
  "target_address": "TJxK7...",
  "energy_delegated": 1303000,
  "activated_at": "2025-06-15T12:01:14Z",
  "expires_at": "2025-06-22T12:01:14Z",
  "tx_hash": "a3f9..."
}

Account Balance

GET/account/balance

{
  "trx_balance": 142.50,
  "active_orders": 3,
  "total_energy_active": 3909000,
  "lifetime_orders": 847
}

Webhooks

POST to your URL, signed with HMAC-SHA256.

X-Tronify-Signature: sha256=abc123...

{
  "event": "order.activated",
  "data": { ... },
  "timestamp": "2025-06-15T12:01:14Z"
}

Verify by computing HMAC-SHA256 of the raw body with your webhook secret.

Event Types