Rewards

Deprecation Incoming

With the Solana Migration, these API endpoints may no longer be available.

Please refer to Oracles and Oracle Data documentation for more information on accessing data.

Available on the Oracles API

Reward Totals

Available on the Oracles API

The data provided by endpoint is available using the Oracles API and requires parsing S3 data. More information will be made available in the future.

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
    }
  ]
}

---