Pricing — API reference

Price table, quotes and estimates.

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.

The service fee tiers

GET /v1/fees · getServiceFees

Auth: Public — no credentials.

Public. The service fee is a percentage of the provider price, by the account’s spend over the last 30 days. A buyer without history pays the first tier. Market prices (/prices, /market) are before it.

Responses

Response fields

Current price table

GET /v1/prices · getPrices

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

Everything currently sellable, with the price for each tier and the volume tiers that apply. Prices move with the time of day, so the response carries the window in which the quoted numbers hold (valid_until), the current pricing period and the whole day’s schedule of periods with the 1h energy price in each.

Use this to render a tariff table. To pin a price for an order, take a quote (POST /v1/quotes) — a price table entry is informational and is not binding.

Switched-off products. While the 1d tier is switched off, the energy 1d row is listed with available: false, its payment_addresses entry is omitted, and orders, quotes and estimates for it answer 2003 tier_unavailable. While subscriptions are switched off, subscriptions_available is false and new subscriptions are refused with 409 3021 subscriptions_unavailable.

Public. No credentials are needed; anonymous calls are limited per source IP. A signed request is accepted too and is counted against the key’s own budget instead.

The example below is illustrative; live prices come from this endpoint. It carries the day-part schedule of 2026-09-25 — energy 1h from 20 SUN/unit off-peak to 34 SUN/unit at peak, here read in the 30 SUN/unit late-peak period — and activation at 1,200,000 SUN; it shows one item only. The bandwidth grid, the long-tier prices and the volume steps are still being finalised, so the example leaves them out rather than publish a number that is not final yet. Iterate over items; never assume which tiers or resources appear.

Parameters

Responses

Response fields (PriceTable)

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

{
  "network": "mainnet",
  "as_of": "2026-09-11T18:04:05.123Z",
  "valid_until": "2026-09-11T18:09:05.123Z",
  "period": {"id":"peak_late","label":"Late peak","start":"16:00","end":"00:00"},
  "schedule": [
    {
      "id": "drop",
      "label": "Drop",
      "start_utc_minute": 0,
      "end_utc_minute": 60,
      "factor_bps": 13500,
      "price_sun_per_unit": 27
    },
    {
      "id": "off_peak",
      "label": "Off-peak",
      "start_utc_minute": 60,
      "end_utc_minute": 540,
      "factor_bps": 10000,
      "price_sun_per_unit": 20
    },
    {
      "id": "ramp_9",
      "label": "Ramp 09:00",
      "start_utc_minute": 540,
      "end_utc_minute": 660,
      "factor_bps": 11000,
      "price_sun_per_unit": 22
    },
    {
      "id": "ramp_11",
      "label": "Ramp 11:00",
      "start_utc_minute": 660,
      "end_utc_minute": 720,
      "factor_bps": 12000,
      "price_sun_per_unit": 24
    },
    {
      "id": "ramp_12",
      "label": "Ramp 12:00",
      "start_utc_minute": 720,
      "end_utc_minute": 840,
      "factor_bps": 15000,
      "price_sun_per_unit": 30
    },
    {
      "id": "peak",
      "label": "Peak",
      "start_utc_minute": 840,
      "end_utc_minute": 960,
      "factor_bps": 17000,
      "price_sun_per_unit": 34
    },
    {
      "id": "peak_late",
      "label": "Late peak",
      "start_utc_minute": 960,
      "end_utc_minute": 1440,
      "factor_bps": 15000,
      "price_sun_per_unit": 30
    }
  ],
  "available_energy": 412000000,
  "delivered_today": 80600000,
  "available_bandwidth": 1800000,
  "items": [
    {
      "resource": "energy",
      "tier": "1h",
      "price_sun_per_unit": 30,
      "min_amount": 32000,
      "max_amount": 3000000,
      "volume_tiers": []
    }
  ],
  "activation": {"price_sun":1200000}
}

Price of activating addresses

GET /v1/prices/activation · getActivationPrice

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

What activating addresses new TRON addresses together costs now: per address and in all. Addresses activated together, in one batch, cost less each than one alone; the price per address is never above activation.price_sun of GET /v1/prices. An activation-only order (resource: activation) is charged the one-address price; an address that is already active is never charged.

The price moves with the market; to pin it, take a quote (POST /v1/quotes). available is false while activation is not sold.

Public. No credentials are needed; anonymous calls are limited per source IP.

Parameters

Responses

Response fields

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

{
  "addresses": 10,
  "price_per_address_sun": 900000,
  "total_sun": 9000000,
  "available": true,
  "as_of": "2026-10-24T12:00:00.000Z"
}

Public energy rental market board

GET /v1/market · getMarket

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

The latest 1h / 1d energy price of each public provider (its API rate for instant rental; its website or account may show other prices), refreshed every minute, plus our own live price (slug: tenergy). Sorted by price_sun_1h, cheapest first; unpriced providers last. savings_pct = 1 − price / burn_sun; stale = the price row is older than 15 min (or missing). Anonymous; a presented key only buys the per-key budget.

Responses

Response fields (MarketBoard)

One provider’s collected price history

GET /v1/market/history · getMarketHistory

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

Ok collector points for one provider, oldest first. Unknown slug = empty series.

Parameters

Responses

Response fields

What a JustLend rental costs its renter

GET /v1/market/justlend · getMarketJustLend

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

Inputs of the JustLend rental calculator: the rent rate (SUN per energy per day at 65,000 energy, the 0.75-day charge for used energy not included), energy per staked TRX, the contract owner’s energy today (the owner pays 100 - caller_share_pct % of each call’s energy, at most origin_energy_limit, while it has energy left) and the chain burn prices. calls are medians of mainnet receipts for the whole call (owner and caller together), dated measured_on. Read live at most once a minute; when the node fails, the last good read is served with stale: true for 15 minutes, then 503.

Responses

Response fields

Price windows by hour of day

GET /v1/market/hourly-pattern · getMarketHourlyPattern

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

The median 1 h price per UTC hour of day over the last 1, 7 or 30 days - ours (tenergy) and the listed venues together - and our hours merged into windows of one price, labelled by where that price sits between the day’s lowest and highest (cheapest, low, rising, peak; one price all day is flat). cheapest is our lowest hour and what 65,000 energy (one USDT transfer) costs then. Hours with no data are null and split windows. Cached for 1 minute.

Parameters

Responses

Response fields

The market day by day

GET /v1/market/daily · getMarketDaily

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

One row per UTC day over the last days (today is partial): the median and the lowest 1 h price across the listed venues, the venue with the lowest median that day, our median 1 h price, and how many venues and readings it rests on. Our price is taken minute by minute: our own reading, or else the cheapest of CatFee, Netts and SoHu in that minute. Cached for 1 minute.

Parameters

Responses

Response fields

Open order statistics, 7 and 30 days

GET /v1/stats · getOpenStats

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

Shares, medians and p90 of our paid orders, merged from hourly buckets the worker recounts every minute. No count of orders, energy or TRX is published. A metric with fewer than 30 orders behind it is null. Energy and bandwidth are separate blocks; promo grants and activator rentals are not included.

Responses

Response fields

What an address spent on energy, and what it would have cost through us

GET /v1/address-check · getAddressCheck

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

Energy rentals to the address in the window by provider (estimated at that provider’s hourly board median for the term; 1 h and 1 d only), its network burns by UTC day, and the same energy at our price of the same hour. Delegations that filled one of our orders are one TEnergy row at the price paid. Built once an hour per (address, days); at most 10 checks a minute per IP. Chain data from our analyzer.

Parameters

Responses

Response fields (AddressCheck)

Every rental of an address check, a page at a time

GET /v1/address-check/rentals · getAddressCheckRentals

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

The rentals behind /address-check one by one, newest first, with the same figures: our delegations at the price paid, a provider’s at its hourly board median for the term (1 h and 1 d only) and ours that hour with the fee of tenergy_fee_pct; null where not priced. The first page (no before) also carries activity, energy rented per UTC hour by provider. At most 60 pages a minute per IP.

Parameters

Responses

Response fields (AddressCheckRentals)

One month of market prices in figures

GET /v1/market/summary · getMarketSummary

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

The month’s collected prices per provider - every venue on the board plus tenergy - and the median 1 h price by UTC hour of day. Statistics cover ok readings with a price; ok_share is the share of readings that succeeded. For the current month to is the time of the request. A future month or a malformed month is 400. Cached for 1 minute.

Parameters

Responses

Response fields

The ask ladder for one resource and tier

GET /v1/orderbook · getOrderBook

Auth: Public — no credentials.

Coming soon: not available yet.

A price that rises with size. The platform publishes a ladder of levels - amount @ price, cheapest first - and an order walks it: the first units come from the cheapest level, the next from the one above, and so on. A bigger order pays more per unit.

Every level carries a class, which says how the energy reaches you:

Prices are monotonic - a level never undercuts the one before it - and no level is ever below the published floor. Pass amount to get the walk for that size back with the levels: fills, the volume-weighted unit_price_sun and the total_sun.

Anonymous and cached for a few seconds. This is a price display: to pin a price, take a quote (POST /v1/quotes), which also holds the own-capacity part of the ladder for its lifetime so the same units are not sold twice.

Parameters

Responses

Response fields (OrderBook)

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

{
  "resource": "energy",
  "tier": "1h",
  "as_of": "2026-09-19T18:04:05.123Z",
  "valid_until": "2026-09-19T18:04:08.123Z",
  "floor_sun": 20,
  "depth": 14200000,
  "levels": [
    {"price_sun":30,"amount":1200000,"class":"instant"},
    {"price_sun":34,"amount":3000000,"class":"market"},
    {"price_sun":58,"amount":10000000,"class":"deep"}
  ],
  "walk": null,
  "cheaper_from": "2026-09-20T01:00:00.000Z"
}

Stateless price estimate

GET /v1/estimate · estimateOrder

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

What an order would cost right now, without creating anything and without reserving a price. Cheap, safe to call on every keystroke.

The example is illustrative — 65,000 energy at the 20 SUN/unit off-peak placeholder — and live prices come from GET /v1/prices.

The estimate is not binding: between the estimate and the order the pricing period may roll over. If you need the number you showed the user to be the number you are charged, take a quote instead and pass quote_id to POST /v1/orders, or send max_price_sun.

Public. Anonymous calls get the retail price and are limited per source IP. A signed request is priced for its own account, so a contract customer sees the contract price.

Parameters

Responses

Response fields (Estimate)

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

{
  "resource": "energy",
  "amount": 65000,
  "tier": "1h",
  "receiver": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "price_sun_per_unit": 20,
  "energy_amount_sun": 1300000,
  "activate_amount_sun": 0,
  "total_amount_sun": 1300000,
  "receiver_activated": true,
  "as_of": "2026-09-11T18:04:05.123Z"
}

Create a binding quote

POST /v1/quotes · createQuote

Auth: API key (HMAC).

Pins a price for a short window. Pass the returned id as quote_id when creating the order and you are charged exactly total_amount_sun, even if the pricing period rolled over in between.

That fixes the charge, not the fill: if the provider the quote was priced at no longer sells at it, a dearer fill is debited within the order’s max_price_sun, or the order fails and is refunded (POST /v1/orders, price protection).

A quote reserves a price, not inventory. If supply runs out before the order is created, the order fails with 5001 insufficient_supply and nothing is charged. A quote or an order the current supply cannot fill is refused the same way at once, with the amount that is available in details.available_amount.

Parameters

Request body

JSON (QuoteRequest), required.

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

{"resource":"energy","amount":65000,"tier":"1h","receiver":"TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"}

Responses

Response fields (Quote)

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

{
  "id": "qt_01J9Z5NB2K4R",
  "resource": "energy",
  "amount": 65000,
  "tier": "1h",
  "receiver": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "price_sun_per_unit": 20,
  "energy_amount_sun": 1300000,
  "activate_amount_sun": 0,
  "total_amount_sun": 1300000,
  "created_at": "2026-09-11T18:04:05.123Z",
  "expires_at": "2026-09-11T18:06:05.123Z"
}

Build a wallet payment for any receiver

POST /v1/wallet-payments · createWalletPayment

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

Pay from a connected wallet for any receiver, with no account, no memo and no unique amount. Returns an UNSIGNED plain TRX transfer payer → this brand's published address for the tier, built by our node and valid for 10 minutes. Sign it in the payer’s wallet and broadcast it as it is: the energy goes to receiver, priced at the block exactly like a “Send TRX” transfer to the same address.

The receiver is bound to the transaction hash (txid) of these bytes before they exist on chain. A transfer built anywhere else has another hash and keeps the plain rule (energy to the sender). Nothing is charged until the signed transfer is on chain. Anonymous; a presented key only buys the per-key budget.

Request body

JSON (WalletPaymentRequest), required.

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

{
  "payer": "TYBSbQwqDgbdBghzsukTxFbTdR2nQ6u3ig",
  "receiver": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "tier": "1h",
  "amount_sun": 1684000
}

Responses

Response fields (WalletPayment)

Read a quote

GET /v1/quotes/{quoteId} · getQuote

Auth: API key (HMAC).

Returns the quote, including whether it is still usable (expires_at in the future).

Parameters

Responses

Response fields (Quote)