Get TRON Burn / Stake Revenue Statistics

Fields

Example

# Query daily burn revenue statistics
curl -s 'https://apilist.tronscanapi.com/api/consumption/statistic?size=1000&start=1575129600000&end=1725847289598&timeType=0&type=burn' \
  -H 'TRON-PRO-API-KEY: <your-key>'

Fields

Top-level

Rate, Ratio, and comparison periods

With type=burn, top-level summaries use netBurnIncome and energyBurnIncome; with type=stake, they use netStakeIncome and energyStakeIncome. Total revenue for the selected type is bandwidth plus energy revenue for the same period. data[] still includes both revenue types.

• Rate = component revenue / total revenue of the selected type for the same period. Returns 0 when that total is zero or negative.
• Ratio = (current-period revenue − baseline-period revenue) / baseline-period revenue. Total, bandwidth, and energy revenue each use their own current and baseline values. Returns 0 when the baseline is zero, negative, or absent, so 0 alone does not establish that revenue was unchanged.
• Both are decimal ratios rounded to 6 decimal places using half-up rounding. Multiply by 100 to display percentages. Rate is a 0–1 share; Ratio can be negative or greater than 1.

Let D be the statistics date of the effective end, and T = D + 1 day. If end is later than the latest data-ready time, the endpoint caps it at that time. In the table, day is a daily record’s date; interval endpoints are excluded.

If the selected type’s total revenue on D is zero, negative, or absent, all Yester fields use D − 1 day, with D − 2 days as the baseline. Month, 3Month, and Year are rolling intervals. With complete data, the current boundaries include 29, 89, and 364 daily records respectively; they are not calendar months, quarters, or years.

All top-level summaries use only the latest size daily records retained within start through the effective end, including both dates. The endpoint does not fetch additional baseline data. Incomplete windows sum only the available records; absent records contribute 0. timeType changes the aggregation of data[] only, not the daily records or comparison periods used by top-level summaries.

data[] elements

Example

Actual response to the request above. Only the last two daily records from data[] are shown; total=1000 is the full response count, and top-level summaries retain their original values.

{
  "code": 200,
  "message": "request ok",
  "status": "1",
  "total": 1000,
  "lastUpdateSeconds": 1792637691,
  "totalIncomeYester": 1714073.661906,
  "totalNetIncomeYester": 87236.962150,
  "totalEnergyIncomeYester": 1626836.699756,
  "totalNetIncomeYesterRate": 0.050895,
  "totalEnergyIncomeYesterRate": 0.949105,
  "totalIncomeYesterRatio": 0.524343,
  "totalNetIncomeYesterRatio": 0.243209,
  "totalEnergyIncomeYesterRatio": 0.543054,
  "totalIncomeMonth": 61302973.620324,
  "totalNetIncomeMonth": 2789920.208875,
  "totalEnergyIncomeMonth": 58513053.411449,
  "totalNetIncomeMonthRate": 0.045510,
  "totalEnergyIncomeMonthRate": 0.954490,
  "totalIncomeMonthRatio": 0.653123,
  "totalNetIncomeMonthRatio": 0.519076,
  "totalEnergyIncomeMonthRatio": 0.660108,
  "totalIncome3Month": 137860775.224973,
  "totalNetIncome3Month": 6447460.606151,
  "totalEnergyIncome3Month": 131413314.618822,
  "totalNetIncome3MonthRate": 0.046768,
  "totalEnergyIncome3MonthRate": 0.953232,
  "totalIncome3MonthRatio": 0.183936,
  "totalNetIncome3MonthRatio": 0.456735,
  "totalEnergyIncome3MonthRatio": 0.173158,
  "totalIncomeYear": 494694023.421357,
  "totalNetIncomeYear": 19734396.338962,
  "totalEnergyIncomeYear": 474959627.082395,
  "totalNetIncomeYearRate": 0.039892,
  "totalEnergyIncomeYearRate": 0.960108,
  "totalIncomeYearRatio": 0.443968,
  "totalNetIncomeYearRatio": 0.427046,
  "totalEnergyIncomeYearRatio": 0.444680,
  "data": [
    {
      "day": "2024-09-08",
      "trxPriceInUsd": 0.1531,
      "totalIncome": 5619413.042218,
      "burnIncome": 1124467.409354,
      "stakeIncome": 4494945.632863,
      "energyIncome": 5339887.246793,
      "netIncome": 279525.795425,
      "energyBurnIncome": 1054296.594447,
      "energyStakeIncome": 4285590.652345,
      "netBurnIncome": 70170.814907,
      "netStakeIncome": 209354.980518
    },
    {
      "day": "2024-09-09",
      "trxPriceInUsd": 0.1545,
      "totalIncome": 7077509.975790,
      "burnIncome": 1714073.661906,
      "stakeIncome": 5363436.313885,
      "energyIncome": 6744178.827467,
      "netIncome": 333331.148322,
      "energyBurnIncome": 1626836.699756,
      "energyStakeIncome": 5117342.127712,
      "netBurnIncome": 87236.962150,
      "netStakeIncome": 246094.186173
    }
  ]
}

Here, Yester is 2024-09-09 and its baseline is 2024-09-08. Recomputing from burn revenue and rounding to 6 decimal places:

• totalNetIncomeYesterRate = 87236.962150 / 1714073.661906 ≈ 0.050895.
• totalIncomeYesterRatio = (1714073.661906 − 1124467.409354) / 1124467.409354 ≈ 0.524343.
• In the full response, the current Month period is 2024-08-12 through 2024-09-09, and its baseline is 2024-07-13 through 2024-08-10. Their burnIncome sums are 61302973.620324 and 37083125.168911 TRX, so totalIncomeMonthRatio ≈ 0.653123.
• Changing only size to 2 makes totalIncomeMonth, totalIncome3Month, and totalIncomeYear each equal the two-day burn revenue sum of 2838541.071260 TRX. All three baseline periods then lack records, so their Ratio fields return 0.