Pricing

These two endpoints need no API key and allow any origin (CORS), so you can call them from a browser, a price widget or a script. They show our price. To get the exact cost of a relay for your account, use Estimate.

Current priceCopy Anchor Link

Returns what an amount of energy costs right now. It uses the same provider choice and pricing rules as Estimate, and provider prices are refreshed every minute. An answer can be up to a minute old. Limit: 60 requests per minute per IP address.

curl "https://apiv2.tronergy.io/api/relayer_tron/public/rate?energy=65000" \
  -H "x-api-key: $TRONERGY_API_KEY"

const response = await fetch("https://apiv2.tronergy.io/api/relayer_tron/public/rate?energy=65000", {
  method: "GET",
  headers: {
    "x-api-key": process.env.TRONERGY_API_KEY,
  },
});

const data = await response.json();

import os
import requests

response = requests.get(
    "https://apiv2.tronergy.io/api/relayer_tron/public/rate",
    headers={
        "x-api-key": os.environ["TRONERGY_API_KEY"],
    },
    params={
        "energy": 65000,
    },
)
data = response.json()

{
  "ok": true,
  "currency": "TRX",
  "energy": 65000,
  "billedEnergy": 65000,
  "priceTrx": "1.120000",
  "priceSun": "1120000",
  "sunPerEnergy": 17.2308,
  "quotedAt": "2026-10-27T09:12:30.000Z"
}

The price is for energy only. Bandwidth and activating a new address are not included; Estimate adds them for a real transaction, and can come out lower if the address already has energy. Prices follow the market and can change between calls.

Errors use the standard format:

curl "https://apiv2.tronergy.io/api/relayer_tron/public/rate?energy=131000"

Price historyCopy Anchor Link

Returns our price for each hour over a recent window, for a price chart. An answer can be up to five minutes old.

curl "https://apiv2.tronergy.io/api/relayer_tron/public/price-history?hours=48&energy=65000" \
  -H "x-api-key: $TRONERGY_API_KEY"

const response = await fetch("https://apiv2.tronergy.io/api/relayer_tron/public/price-history?hours=48&energy=65000", {
  method: "GET",
  headers: {
    "x-api-key": process.env.TRONERGY_API_KEY,
  },
});

const data = await response.json();

import os
import requests

response = requests.get(
    "https://apiv2.tronergy.io/api/relayer_tron/public/price-history",
    headers={
        "x-api-key": os.environ["TRONERGY_API_KEY"],
    },
    params={
        "hours": 48,
        "energy": 65000,
    },
)
data = response.json()

{
  "ok": true,
  "currency": "TRX",
  "energy": 65000,
  "interval": "hour",
  "window": { "from": "2026-10-25T10:00:00.000Z", "to": "2026-10-27T10:00:00.000Z" },
  "latest": { "time": "2026-10-27T09:00:00.000Z", "priceTrx": 1.12, "sunPerEnergy": 17.2308, "basis": "quote" },
  "points": [
    { "time": "2026-10-27T08:00:00.000Z", "priceTrx": 1.12, "sunPerEnergy": 17.2308, "basis": "quote" },
    { "time": "2026-10-27T09:00:00.000Z", "priceTrx": 1.12, "sunPerEnergy": 17.2308, "basis": "quote" }
  ]
}

Each point is one hour. priceTrx is a number here, not a string. Hours with no known price have priceTrx, sunPerEnergy and basis set to null. latest is the newest point with a price, or null if there is none. basis says where a point comes from:

• quote: the price we quoted in that hour.
• sale: the average price of energy we sold in that hour. Used only for hours before we started recording quotes.
• carried: no new price in that hour, so the previous price is repeated.

A point's price is the per-unit price multiplied by energy, so for amounts far from 65,000 it is approximate. Use Current price for an exact amount.

A bad hours or energy answers 400 with error: "Invalid query". If the history cannot be loaded you get 502.