Pricing — API reference

Price table, quotes and estimates.

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.

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

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 collected 1h / 1d energy price per public provider (worker collector, every 5 min), plus our own row priced by the same service as GET /v1/prices. Sorted by price_sun_1h ascending, unpriced providers last; our row (slug: tenergy) is placed by its real price and on a tie sorts behind the competitor. 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

The ask ladder for one resource and tier

GET /v1/orderbook · getOrderBook

Auth: Public — no credentials.

Guaranteed delivery at a price that rises with size. The platform publishes a ladder of levels - amount @ price, cheapest first - and an order simply walks it: the first units come from the cheapest level, the next from the one above, and so on. A bigger or a later order pays more per unit, and it is always fillable. There is no “sold out”.

Every level carries a class, which says how the energy reaches you and nothing about who supplies it:

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.

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.

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

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)