Price and terms

Terms — GET /v1/terms (Read)#

[{"term": "1h", "seconds": 3600, "available": true, "min_energy": 32000, "max_energy": 10000000}]

Terms are always listed in the order 5m 15m 1h 1d 3d 7d 30d. available: false means the term cannot be ordered right now (45006); it comes back on its own.

Price — GET /v1/price?energy=65000&term=1h (Read)#

{"energy": 65000, "term": "1h",
 "price_trx": "2.08", "price_usdt": "0.62", "usdt_trx_rate": "3.39",
 "sun_per_energy": "32", "available": true,
 "quote_expires_at": "2026-10-13T08:01:00Z"}

To make sure an order never costs more than you expect, pass max_price_trx when you create it (see Orders).

How much energy does an address need?#

GET /v1/address/{address}/resources?usdt_to_address=&transfers=1 (Read)

{"address": "TXYZ…", "checked": true, "activated": true,
 "energy_available": 0, "bandwidth_free": 600,
 "usdt_to_holds_usdt": true, "energy_per_transfer": 65000,
 "energy_needed": 65000, "already_has_energy": null}

• A USDT transfer costs ~65,000 energy when the recipient already holds USDT and ~131,000 when it does not. Without usdt_to_address we assume the recipient already holds USDT (65,000); pass the recipient for an exact answer (usdt_to_holds_usdt is null without it).
• transfers (1–20) sizes for several transfers: energy_needed = max(energy_per_transfer × transfers − energy_available, 0). It is not clamped to the term's min_energy — round up to it yourself.
• already_has_energy is {"energy": 65000, "until": "…Z"} when one of our delegations to that address is still running (until = when the latest one ends), else null.
• activated: false — the address has never been used on chain. An address that was never activated cannot receive a delegation; activate it first.
• checked: false means the chain could not be read — size for 131,000 to be safe.