Billing

Tronergy is prepaid. You keep a TRX balance, and each relay is paid from it. Sandbox has free test credit. You only deposit for live.

Fund your balanceCopy Anchor Link

curl "https://apiv2.tronergy.io/api/payment_gateways/portal/deposit?chain=tron&environment=live" \
  -H "x-api-key: $TRONERGY_API_KEY"

Check your balanceCopy Anchor Link

curl "https://apiv2.tronergy.io/api/gas_tank/portal/balance?environment=live" \
  -H "x-api-key: $TRONERGY_API_KEY"

{ "ok": true, "chain": "tron", "environment": "live", "currency": "TRX", "available": "125.5", "inflight": "2.95", "total": "128.45" }

Amounts are in TRX.

• available: what you can spend now.
• inflight: held for relays that are still running.
• total: both together.

Use environment=sandbox for your sandbox balance. List balances returns every account at once, in sun.

What you payCopy Anchor Link

1. When you call execute, Tronergy quotes the relay.
2. That amount is held on your balance.
3. When the relay completes, you pay the quote. Not more, not less.

The charge is saved on the operation as estimatedFee.

When a relay does not completeCopy Anchor Link

• Cancelled or expired: the hold is released. You pay nothing.
• Failed before anything was spent: you pay nothing.
• Failed after Tronergy already spent TRX on it (for example on bandwidth or activating the account): you pay only what was actually spent, never more than the quote. The rest is released.

Low balanceCopy Anchor Link

If your balance is below the quote, execute returns 422 INSUFFICIENT_BALANCE. Nothing is broadcast or charged. Top up and retry with the same idempotencyKey.

To avoid this:

• Turn on a low-balance alert in the dashboard (Gas Tank → Alerts).
• Or read balance.available on a schedule and top up when it drops.

You can also set a monthly budget cap in the dashboard. A relay that would go over it ends as failed with BUDGET_CAP_EXCEEDED.

Fees from your usersCopy Anchor Link

In fee modes, the user also pays a fee on-chain. Your balance is still charged the quote. The user's fee is a separate payment to you.

History and withdrawalsCopy Anchor Link

• Deposits and charges: GET /gas_tank/portal/transactions
• Spend this week or month: GET /gas_tank/portal/usage
• Withdraw unused balance from the dashboard. API keys cannot withdraw.

See balance for every endpoint and field.