Rewards

---

Reward Totals

GET https://api.helium.io/v1/rewards/sum

Returns the total rewards for the whole network in a given timeframe. Timestamps can be given in ISO 8601 format (e.g. 2020-08-27T00:00:00Z) or in relative time (e.g. -1 week, which when url esacped becomes -1%20week). When ommitted the current time is assumed.

The results can also be bucketed in time by specifying a bucket query parameter which buckets information per bucket in the given timeframe. Data is bucketed by time. Valid bucket values include hour, day and week).

For example to get the last 7 days of rewards bucketed by day use the following path/parameters: ?min_time=-7%20day&bucket=day

The block that contains the max_time timestamp is excluded from the result.

Request

Query Parameters

param	Type	Note
min_time (required)	string	First time to include rewards for
max_time (required)	string	Last time to include rewards for
bucket (optional)	string	Bucket specifier

Response

200: OK

Return the last 7 days of rewards bucketed by day

{
  "meta": {
    "min_time": "2021-03-09T14:02:16Z",
    "max_time": "2021-03-16T14:02:16Z",
    "bucket": "day"
  },
  "data": [
    {
      "total": 163097.17250743,
      "timestamp": "2021-03-15T14:02:16.000000Z",
      "sum": 16309717250743,
      "stddev": 1979.00681618,
      "min": 3472.21917515,
      "median": 4016.203702235,
      "max": 12284.71884406,
      "avg": 4796.975661983235
    },
    {
      "total": 168002.27841848,
      "timestamp": "2021-03-14T14:02:16.000000Z",
      "sum": 16800227841848,
      "stddev": 2309.16069573,
      "min": 3472.21841404,
      "median": 4016.20370501,
      "max": 12611.11000226,
      "avg": 5090.9781338933335
    },
    {
      "total": 133361.07596175,
      "timestamp": "2021-03-13T14:02:16.000000Z",
      "sum": 13336107596175,
      "stddev": 2798.46444455,
      "min": 3472.21962795,
      "median": 4124.99999633,
      "max": 14787.03221898,
      "avg": 5129.272152375
    },
    {
      "total": 163106.43648989,
      "timestamp": "2021-03-12T14:02:16.000000Z",
      "sum": 16310643648989,
      "stddev": 2546.58274217,
      "min": 3472.2198613,
      "median": 3907.40369327,
      "max": 13590.27500482,
      "avg": 4942.619287572425
    },
    {
      "total": 172761.52602361,
      "timestamp": "2021-03-11T14:02:16.000000Z",
      "sum": 17276152602361,
      "stddev": 1987.78361329,
      "min": 3472.22221761,
      "median": 4016.20370451,
      "max": 10108.79357198,
      "avg": 4798.931278433611
    },
    {
      "total": 174583.28615868,
      "timestamp": "2021-03-10T14:02:16.000000Z",
      "sum": 17458328615868,
      "stddev": 1803.57075522,
      "min": 3472.22221792,
      "median": 3798.61111202,
      "max": 12502.31093528,
      "avg": 4476.494516889231
    },
    {
      "total": 171546.22586829,
      "timestamp": "2021-03-09T14:02:16.000000Z",
      "sum": 17154622586829,
      "stddev": 1240.37282909,
      "min": 3472.21796038,
      "median": 4070.598475985,
      "max": 9129.62498664,
      "avg": 4514.374364955
    }
  ]
}

---