Chain — API reference

Read-only TRON helpers.

Base URL https://api.tenergy.me/v1, or https://api-nile.tenergy.me/v1 on Nile (Environments). Every request below is signed as in Authentication unless its Auth line says otherwise.

Resource situation of an address

GET /v1/resources/{address} · getAddressResources

Auth: Public — no credentials needed; a request signed with an API key (HMAC) is accepted too.

What the chain currently says about an address: whether it is activated, how much free energy and bandwidth it has, how much is delegated to it and by whom, and which of those delegations came from us.

Read from our own node with a short cache (as_of tells you how fresh it is). Use it to decide whether an order is needed at all — the cheapest energy is the energy you do not buy.

Public. No credentials are needed; anonymous calls are limited per source IP and get our_active_orders: []. A signed request lists that account’s own active orders on the address and is counted against the key’s budget.

Parameters

Responses

Response fields (AddressResources)

Example 200 response, from the contract (illustrative values — live numbers come from the API):

{
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "activated": true,
  "balance_sun": 4120000,
  "holds_usdt": true,
  "energy": {"limit":131000,"used":0,"available":131000,"delegated_in":131000},
  "bandwidth": {"limit":1600,"used":0,"available":1000,"delegated_in":0,"free_net_limit":600},
  "our_active_orders": [
    {
      "order_id": "ord_01J9Z5P8T3WQ",
      "amount": 65000,
      "resource": "energy",
      "expires_at": "2026-09-11T19:04:07.900Z"
    }
  ],
  "as_of": "2026-09-11T18:40:00.000Z"
}

Energy and bandwidth an address used and burned

GET /v1/resources/{address}/usage · getAddressUsage

Auth: Public — no credentials needed; a request signed with an API key (HMAC) is accepted too.

The transactions this address sent (and paid for) over the last 7 or 30 UTC days, today included: how much energy they used, how much TRX they burned for energy and for bandwidth, and the same per day. It answers “how much energy do I need, and what does burning cost me now” from the address’s own history.

Read from TronGrid’s indexed API and cached for 5 minutes per address and period. At most 2,000 transactions are read; capped: true means there were more and the totals are a lower bound.

Public. No credentials are needed; calls are limited per source IP, and fresh reads are also limited per server, so a burst can answer 429 with retry_after.

Parameters

Responses

Response fields (AddressUsage)

Example 200 response, from the contract (illustrative values — live numbers come from the API):

{
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "days": 7,
  "transactions": 2,
  "usdt_transfers": 2,
  "out_of_energy": 0,
  "energy_used": 130285,
  "energy_burned_sun": 6514200,
  "bandwidth_burned_sun": 345000,
  "capped": false,
  "per_day": [
    {
      "date": "2026-10-08",
      "transactions": 2,
      "energy_used": 130285,
      "energy_burned_sun": 6514200,
      "bandwidth_burned_sun": 345000
    }
  ],
  "as_of": "2026-10-09T10:00:00.000Z"
}

Service status

GET /v1/status · getStatus

Auth: Public.

Whether TEnergy is working right now, component by component: the database, incoming payments (how long ago the payment scanner last advanced), energy delivery over the last hour (orders, failures, median seconds from order to delegation) and energy available to sell. status is the worst component. Delivery is judged only on an hour with at least 3 orders; a quiet hour is not an incident.

Public. No credentials are needed. The answer is cached for 10 seconds. It is 503 when a component is down, so a plain HTTP check alerts without reading the body.

Responses

Response fields (ServiceStatus)

Example 200 response, from the contract (illustrative values — live numbers come from the API):

{
  "status": "operational",
  "network": "mainnet",
  "as_of": "2026-09-29T10:00:00.000Z",
  "components": {
    "api": {"status":"operational"},
    "database": {"status":"operational"},
    "payments": {"status":"operational","scanner_updated_s_ago":3},
    "delivery": {"status":"operational","orders_1h":42,"failed_1h":0,"median_delivery_s_1h":6},
    "supply": {"status":"operational","available_energy":18500000}
  }
}

Energy needed for a TRC-20 transfer

POST /v1/estimate/transfer · estimateTransferEnergy

Auth: API key (HMAC).

How much energy a TRC-20 transfer from from_address to to_address will consume, and what renting that much would cost. Defaults to the network’s USDT when contract_address is omitted: TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t on mainnet, TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf on Nile.

The number depends on whether the recipient already holds a non-zero balance of that token — a first-time recipient costs roughly twice as much — which is why both addresses are required. The estimate is produced by a triggerConstantContract simulation against our node, so it reflects the current contract state, not a table.

Add a safety margin before ordering: the simulation is taken now and the transfer is broadcast later, and the recipient’s balance may change in between. recommended_amount already includes the platform’s margin and is the number to order.

Request body

JSON (TransferEstimateRequest), required.

Example request body, from the contract (illustrative values):

{
  "from_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "to_address": "TXXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

Responses

Response fields (TransferEstimate)

Example 200 response, from the contract (illustrative values — live numbers come from the API):

{
  "from_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "to_address": "TXXxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
  "recipient_holds_token": false,
  "energy_required": 130285,
  "recommended_amount": 131000,
  "bandwidth_required": 345,
  "tier": "1h",
  "price_sun_per_unit": 20,
  "energy_amount_sun": 2620000,
  "activate_amount_sun": 1200000,
  "total_amount_sun": 3820000,
  "burn_alternative_sun": 13028500,
  "as_of": "2026-09-11T18:41:00.000Z"
}