Order Lifecycle
This is what happens between "I need energy" and "energy delivered," step by step. The same lifecycle applies whether you buy through the Workspace, the API, the Telegram bot, or the Energy-Free Node.
The seven stages
- Request a quote. You ask for an amount of energy for a duration — for example, 65,000 Energy for 1 hour — and a target address.
- Aggregate. The engine pulls live prices and available capacity from 13+ providers and our own pool. Quotes reflect the current market, not a cached rate.
- Normalise. Every provider's pricing is converted to the same basis so the comparison is genuinely like-for-like.
- Match & rank. Candidates are sorted by true delivered price, filtered to those that can fill your exact order now, and weighted by TrustScore.
- Route & deliver. The order goes to the best match; energy is delegated on-chain to your target address. If that provider stalls, it fails over to the next best automatically.
- Confirm. Typical delivery is ~30 seconds. You receive a confirmation and an order ID you can use to track it.
- Refund (if needed). If no provider can fill the order, you're refunded automatically — including any reseller markup. You're never charged for energy you didn't receive.
Order states
An order moves through a small set of states you can observe when tracking it:
| State | Meaning |
|---|---|
pending | Order placed and being routed and delivered. |
completed | Energy has been delegated to the target address. |
refunded | No provider could fill the order; balance returned. |
Every order carries a unique ID and, once completed, a receiver address and transaction hash you can verify on Tronscan.
Tracking your order
Every order returns an ID. Use it to check status in the Workspace, or view the order detail (shown above) to see the receiver address and on-chain transaction. See Your First Purchase for the full buy-and-track flow.