TronScan.energy API v1
Real-time TRON energy and bandwidth market data. Prices from 10+ providers, live sell-side offers, historical data and instant quotes — all in one endpoint.
Getting Started
Quick Start Authentication Plans & Limits Error CodesEndpoints
/rates /offers /market /quote /providers /historyRequest Key
Get your API key →
All requests require an X-API-Key header. Here's how to get energy prices in one call:
curl -H "X-API-Key: YOUR_API_KEY" \ "https://tronscan.energy/api/v1/rates?resource=energy&best=1"
$ch = curl_init('https://tronscan.energy/api/v1/rates?resource=energy&best=1'); curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: YOUR_API_KEY']); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = json_decode(curl_exec($ch), true);
import requests
r = requests.get(
'https://tronscan.energy/api/v1/rates',
headers={'X-API-Key': 'YOUR_API_KEY'},
params={'resource': 'energy', 'best': 1}
)
data = r.json()
Every response follows the same structure:
{
"success": true,
"ts": "2026-03-14T10:00:00+00:00",
"meta": { "provider_count": 8, "total_tiers": 64 },
"data": [ ... ]
}
Pass your API key in the X-API-Key HTTP header with every request.
Query-string passing (?api_key=...) is supported but deprecated.
X-API-Key: ts_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
Auto-approved
No create-order
Manual approval
Priority support
Webhooks
SLA guarantee
Rate limit headers are returned on every response:
X-RateLimit-Limit and X-RateLimit-Remaining.
Exceeding the limit returns HTTP 429.
{
"success": false,
"error": {
"code": "invalid_api_key",
"message": "Invalid API key"
},
"ts": "2026-03-14T10:00:00+00:00"
}
Returns price tiers from provider_price_tiers, updated every ~15 min by the cron. Each tier includes standard and FAST price when available.
curl -H "X-API-Key: YOUR_KEY" \ "https://tronscan.energy/api/v1/rates?resource=energy&best=1"
{
"success": true,
"ts": "2026-03-14T10:00:00+00:00",
"meta": { "resource": "energy", "provider_count": 8, "total_tiers": 64 },
"data": {
"energy": [
{
"duration_sec": 3600,
"duration_label": "1h",
"providers": [
{
"name": "Feee.io",
"slug": "feee_io",
"price_sun": 35,
"price_sun_fast": null,
"qty_available": 9000000,
"qty_min": 32000,
"updated_at": "2026-03-14 10:00:00"
}
]
}
]
}
}
Returns active sell orders from sell_offers, updated every 5 min. Only orders with quantity_available > 0 fetched in the last 15 min are returned.
curl -H "X-API-Key: YOUR_KEY" \ "https://tronscan.energy/api/v1/offers?resource=energy&sort=price_desc&limit=5"
{
"meta": { "total": 328, "page": 1, "limit": 5, "has_more": true },
"data": [
{
"provider": { "name": "Feee.io", "slug": "feee_io" },
"order_no": "2304190664759388169206",
"price_sun": 105,
"quantity": { "available": 399989, "total": 500000, "min": 100000 },
"duration": { "days": 3, "label": "3 days" },
"income": { "max_trx": 94.49, "min_trx": 18.9 },
"is_partial_fill": true,
"is_lock": true
}
]
}
Single-call overview of the current market state: total available energy/bandwidth, price range, top offer.
curl -H "X-API-Key: YOUR_KEY" \ "https://tronscan.energy/api/v1/market"
{
"data": {
"energy": {
"total_offers": 328,
"total_available": 1645427335,
"price_min_sun": 30,
"price_max_sun": 60,
"price_avg_sun": 38.4,
"active_providers": 4,
"top_offer": {
"provider": "TronEnergy.Market",
"price_sun": 60,
"qty_available": 41273711,
"duration_days": 14
}
},
"bandwidth": { "total_offers": 12, "price_min_sun": 600 }
}
}
Calculates total TRX cost across all providers for the requested qty × duration. Useful for bot decision logic. Returns both standard and FAST price when available.
curl -H "X-API-Key: YOUR_KEY" \ "https://tronscan.energy/api/v1/quote?qty=65000&duration=86400&resource=energy"
{
"meta": {
"qty": 65000, "duration_sec": 86400, "duration_days": 1,
"best_price_sun": 35, "best_total_trx": 2.275
},
"data": [
{
"provider": "Feee.io",
"price_sun": 35,
"price_sun_fast": null,
"total_cost_trx": 2.275,
"qty_available": 9000000,
"qty_sufficient": true,
"duration_label": "1g"
}
]
}
Returns slugs, URLs, min quantities, current price ranges and availability for each active provider. Use slugs as the provider param in other endpoints.
curl -H "X-API-Key: YOUR_KEY" \ "https://tronscan.energy/api/v1/providers"
{
"meta": { "total": 10 },
"data": [
{
"name": "Feee.io",
"slug": "feee_io",
"url": "https://feee.io",
"ref_url": "https://feee.io?ref=VVR6",
"min_qty_energy": 32000,
"energy_price_sun": { "min": 35, "max": 120 },
"energy_available": 34264169,
"tier_count": 8,
"prices_updated_at": "2026-03-14 10:00:00"
}
]
}
Returns price time-series from price_snapshots. Data points are recorded every ~15 min. Up to 90 days available.
curl -H "X-API-Key: YOUR_KEY" \ "https://tronscan.energy/api/v1/history?provider=tronsave&field=1g&days=30"
{
"meta": {
"provider": "TronSave", "field": "1g", "days": 30,
"data_points": 2880, "price_min": 30, "price_max": 65, "price_avg": 41.2
},
"data": [
{ "ts": "2026-02-14 00:00:00", "price_sun": 40 },
{ "ts": "2026-02-14 00:15:00", "price_sun": 40 },
{ "ts": "2026-02-14 00:30:00", "price_sun": 38 }
]
}