DocumentationBrowse sections

List Prices

Returns current energy and bandwidth prices from every active provider. Use this endpoint for comparison UIs and analytics. Use /prices/best or /orders/preview with exact order fields for an executable quote.

GET/api/v1/prices
Refresh interval
Prices are polled from all providers every 30 seconds. The fetched_at timestamp on each entry shows when that provider was last queried.

Request

No query parameters or request body. No authentication required.

Request examples
curl https://merx.exchange/api/v1/prices

Response

Returns an array of ProviderPrice objects. Each object contains arrays of PricePoint entries for energy and bandwidth, keyed by duration in seconds.

200Success
[
  {
    "provider": "sohu",
    "is_market": false,
    "energy_prices": [
      { "duration_sec": 3600, "price_sun": 28 },
      { "duration_sec": 86400, "price_sun": 32 },
      { "duration_sec": 259200, "price_sun": 35 }
    ],
    "bandwidth_prices": [],
    "available_energy": 4200000,
    "available_bandwidth": 0,
    "fetched_at": "2026-03-29T12:00:30.000Z"
  },
  {
    "provider": "tronsave",
    "is_market": true,
    "energy_prices": [
      { "duration_sec": 3600, "price_sun": 30 },
      { "duration_sec": 86400, "price_sun": 34 },
      { "duration_sec": 604800, "price_sun": 38 }
    ],
    "bandwidth_prices": [
      { "duration_sec": 86400, "price_sun": 40 }
    ],
    "available_energy": 9800000,
    "available_bandwidth": 500000,
    "fetched_at": "2026-03-29T12:00:28.000Z"
  }
]

Response fields

providerstringProvider identifier (e.g. "sohu", "tronsave")
is_marketbooleanTrue if this provider operates a marketplace model
energy_pricesPricePoint[]Array of price tiers for energy by duration
bandwidth_pricesPricePoint[]Array of price tiers for bandwidth by duration
available_energynumberCurrently available energy units from this provider
available_bandwidthnumberCurrently available bandwidth units from this provider
fetched_atstringISO 8601 timestamp of the last successful price fetch

PricePoint object

Each entry in energy_prices or bandwidth_prices is a PricePoint with two fields. Durations are always in seconds. Prices are always in SUN (1 TRX = 1,000,000 SUN).