v2 API Reference
GasSaver API
Delegate TRON energy to any wallet — eliminating USDT transfer fees entirely.
1 Credit = 1 Delegation
Each energy delegation costs 1 credit. Top up with USDT at 1.1 USDT per credit.
API Key auth
All API calls use X-API-Key header. Generate keys from your dashboard.
Idempotent requests
Pass idempotencyKey on delegate calls — safe to retry without double-charging.
Authentication
Include your API key in every request:
X-API-Key: sk_live_your_api_key_hereResponse format
// Success
{ "success": true, "data": { ... } }
// Error
{ "success": false, "message": "Human-readable error", "error": "CODE" }HTTP status codes
200OK — request succeeded
400Bad Request — validation error or invalid input
401Unauthorized — missing or invalid API key
402Payment Required — insufficient credits
422Unprocessable — energy delegation failed on-chain
429Too Many Requests — rate limit exceeded
500Server Error — retry with exponential backoff
Integration flow
1
User deposits USDT
Into a deposit wallet address
2
Call POST /energy/delegate
Pass deposit wallet as walletAddress, main wallet as recipientWallet
3
Poll GET /energy/check/:address
Wait until isReadyForTransfer: true (usually < 5 seconds)
4
Sweep USDT
Wallet now has energy — transfer to main wallet costs zero TRX