DocumentationBrowse sections

Price history

Returns observations from the normalized energy archive. Older records that mixed durations are excluded. History begins when the new archive starts; missing history is returned as an empty array, not reconstructed prices.

GET/api/v1/prices/history
providerstringOPTIONAL
Optional monitored provider, for example catfee, powersun or tronsave.
resourcestringOPTIONAL
BANDWIDTH currently returns an empty array and an unavailable status header.One of: ENERGYBANDWIDTHDefault: ENERGY
amountnumberOPTIONAL
65000 or 131000 energy. Other amounts return 400.Default: 65000
durationnumberOPTIONAL
Only 3600 seconds of requested coverage is supported.Default: 3600
periodstringOPTIONAL
Requested historical window; it does not imply that the whole window has data.One of: 1h6h24h7d30dDefault: 24h
curl "https://merx.exchange/api/v1/prices/history?provider=catfee&resource=ENERGY&amount=65000&duration=3600&period=7d"

Response

The success envelope contains data, an array. Rows identify provider, resource_type, amount, requested_duration_sec, billed_duration_sec, availability_basis, effective price_sun, nullable available, sample_count and polled_at.

A tariff limit is not verified supply. Observations are not completed sales. Do not treat an absent row as zero price or assume uninterrupted coverage.

For daily coverage, publication eligibility and methodology, use GET /api/v1/market/energy?amount=65000&days=30 and the methodology page.