Best price and exact quote

Without a target address, returns the compatible one-hour market comparison used by existing clients. Add a target address to request the current exact executable MERX quote.

GET/api/v1/prices/best

Query parameters

resourcestringREQUIRED

Resource type to quote.One of: ENERGYBANDWIDTH

amountnumberOPTIONAL

Without target_address: 65000 or 131000 energy. With target_address: exact order amount, minimum 65000 energy or 1000 bandwidth.Default: 65000

durationnumberOPTIONAL

Without target_address only 3600 is supported. Exact quotes use the fixed duration grid.One of: 12030060090018003600108002160086400Default: 3600

target_addressstringOPTIONAL

TRON recipient. When present, the endpoint returns an exact executable quote.

max_price_sunnumberOPTIONAL

Optional offered price per unit, up to three decimal places. Values below the current quote are rejected.

curl "https://merx.exchange/api/v1/prices/best?resource=ENERGY"

Response and availability

The targetless response retains the original comparison fields, including provider, amount, total_sun, total_trx, price_sun, requested_duration_sec, and billed_duration_sec. It describes a market observation rather than an order commitment.

With target_address, data contains the exact quote fields used by order submission, including total_cost_sun, cost_trx, and the quoted provider. The price is checked again when the order is submitted.

Invalid comparison parameters return 400; unavailable normalized bandwidth comparison returns 404. An unavailable exact quote returns 503.

For raw provider observations, exclusions, and history, use GET /api/v1/market/energy?amount=65000. Read the comparison methodology and use the order preview before placing an order.