Chain — API reference

Read-only TRON helpers.

Generated from openapi.yaml at build time. 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":1600,"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"
}

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 USDT (TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t) when contract_address is omitted.

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"
}