List Prices

Returns current energy and bandwidth prices from every active provider. This is the primary endpoint for building comparison UIs and selecting the cheapest source before placing an order.

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).