Compare energy rental prices
resource-markets-get-prices
Report what TronRelic's tracked energy rental markets advertise, as captured from each market's own rate card on a schedule an admin sets, which can change at any time, so read the spacing between captures from the "capturedAt" times returned rather than assuming one: which market is cheapest for a given order, every market's advertised price range and open orderbook, one market's full rate card and price history, and what each market pays TRX holders who supply it energy. Use it first for "which market is cheapest for N transfers", "what does this market charge", "how has its advertised price moved", or "which market pays holders the most". Prices here are what markets advertise; for what renters actually paid, use resource-markets-get-activity, and compare the two to see whether a market charges what it advertises. Do not use it for how a market is set up (use resource-markets-get-config). Read-only. Parameters: "slug" (optional), a market slug such as "catfee", to report one market in full; "transfers" (optional), how many USDT transfers the order must cover, 1 to 100000, default 1; "periodMinutes" (optional), the minutes within which they are sent, 1 to 129600, default 60; "usage" (optional), for a period longer than a day, "flexible" when the transfers may be sent at any time, which only a rental of a day or longer can serve, or "batched" when each day's transfers are sent together inside one rental that may last only minutes, default "flexible"; "historyDays" (optional), days back from now to look over past capture runs, 1 to 30: with "slug" it sets that market's history, default 7; without "slug" it adds a "history" summary to the ranking and is left out by default. Use "historyDays" without "slug" for "which market was cheapest for this order over the week": it prices the order on the rate card each market showed at every capture run in the window, not on the newest one. Every answer carries "pageUrl", TronRelic's page comparing every market, and every market entry carries its own "pageUrl", its TronRelic page with its rate card and prices paid; when you cite a price, link the matching page so the reader can check it there. Either is null when the site address is unknown. Without "slug", returns { success, asOf, order, pageUrl, current, outdated, unpriced, history? }. "current" is the markets priced in the newest capture run, cheapest first: those whose rate card can price the order come first by total cost, then the rest by lowest advertised rate. Markets equal to the SUN are tied, and their order is a daily rotation by the capture's UTC day of the month, not a price difference: report them as tied. "outdated" is markets missing from the newest capture run, so their capture is older than the freshest; their prices stopped updating and they are not ranked. Each is { slug, displayName, pageUrl, capturedAt, cheapest, dearest, usdtTransferEnergy, hasRateCard, quote, orderbook, supplyYield }. "cheapest" and "dearest" are the market's advertised extremes as { trxPerTransfer, transfersRequired, durationMinutes, discountPercent }; "transfersRequired" above 1 means the price needs an order that large. "quote" is the order priced on the market's best tier as { totalTrx, trxPerTransfer, energy, durationMinutes, purchases, raisedToMinimum } or null when the market has no rate card or no tier takes the order. A period of a day or less is priced as one burst; a longer one spreads the transfers evenly and renews a tier shorter than the period, once a day for a batched tier shorter than a day. When quoting a batched order on a tier shorter than a day, say that each day's transfers must be sent inside that one rental. "purchases" counts the rentals bought, including a fixed-size package bought several times; "energy" is summed across them. Splitting an order across different tiers is not modelled. "orderbook" is { capturedAt, bid?, ask? } with { orderCount, totalEnergy, vwapSun } per side, or null. "supplyYield" is { advertisedBestRatePercent (the highest yearly rate among the market's open programs), openPrograms, witnessedRatePercent (the yearly rate the chain shows it paid), witnessedHolders } or null when the market buys no energy from holders; an advertised rate is the market's claim and the witnessed rate is the evidence. "unpriced" lists markets with no advertised price as { slug, displayName, pageUrl, supplyYield }. "history", present only when "historyDays" was given, is { historyDays, runs, firstRunAt, lastRunAt, markets, unquoted }: "runs" counts the capture runs in the window; each "markets" entry is { slug, displayName, lowest, highest, runsCaptured, runsQuoted, firstCapturedAt, lastCapturedAt }, where "lowest" and "highest" are { capturedAt, quote } for the cheapest and dearest quote of the order in the window (a tie to the SUN goes to the newest run), sorted by the lowest quote's totalTrx, cheapest first; markets whose lowest totalTrx is equal to the SUN are tied, so report them as tied. "firstCapturedAt" and "lastCapturedAt" are the market's own oldest and newest capture in the window, which can be later than "firstRunAt" when its price fetch failed for part of it. "unquoted" lists markets the window captured whose rate card never took the order, as { slug, displayName, runsCaptured }. A market missing from the window entirely had no capture in it. With "slug", returns { success, asOf, order, historyDays, pageUrl, market: { slug, displayName, pageUrl, advertised, supplyYield } }. No link to a market's own site is returned; send readers to "pageUrl", where the market's site is linked. "advertised" is null for a market with no price fetcher, and otherwise { capturedAt, price, rateCard, orderbook, priceHistory, quoteHistory, quote }: "rateCard" is { capturedAt, usdtTransferEnergy, cells (up to 100), cellsTotal } where each cell is { minutes, sun, minBorrow?, maxBorrow?, discountPercent? } and "sun" is the price for the whole rental in SUN per unit of energy with TRON's one-day minimum applied, so an order of E energy costs sun × E / 1,000,000 TRX; "priceHistory" is [{ capturedAt, minTrxPerTransfer, maxTrxPerTransfer, usdtTransferEnergy }], one per capture run, oldest first, within the last "historyDays" days; "minTrxPerTransfer" is the cheapest point anywhere on the rate card and can need a larger order or another rental length than the one asked about. "quoteHistory" is [{ capturedAt, quote }] over the same runs, the order itself priced on each run's rate card, with "quote" null when no tier took it; use it, not "priceHistory", for what this order cost. "supplyYield" is the full { advertised, witnessed } part: "advertised" lists the market's programs with their yearly rate, resource, how a holder takes part ("delegate", "permission", or "custodial-staking"), and whether each is open; "witnessed" gives the measured rate with its window, holders, payouts, and stake. "capturedAt" hours behind "asOf" means the market's price fetch has been failing. An unknown slug returns { success: false, error } listing the known slugs.
Schema valid · SHA-256 c33b198461fe…
View input schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Market slug such as \"catfee\". Omit to price the order on every market and rank them."
},
"transfers": {
"type": "integer",
"description": "USDT transfers the order must cover, 1 to 100000. Omit for 1."
},
"periodMinutes": {
"type": "integer",
"description": "Minutes within which the transfers are sent, 1 to 129600. Omit for 60."
},
"usage": {
"type": "string",
"enum": [
"flexible",
"batched"
],
"description": "For a period longer than a day: \"flexible\" (sent at any time) or \"batched\" (each day's transfers sent together in one rental). Omit for \"flexible\"."
},
"historyDays": {
"type": "integer",
"description": "Days back over past capture runs, 1 to 30. With \"slug\": the market's history, default 7. Without \"slug\": adds the \"history\" summary of every market's lowest and highest quote for the order; omit for no summary."
}
},
"required": [],
"description": "Which market to report, the order to price, and how much price history to return.",
"additionalProperties": false
}