> For the complete documentation index, see [llms.txt](https://dmitrii-vasiliev.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dmitrii-vasiliev.gitbook.io/docs/untitled/rewards.md).

# Rewards

## Reward Totals <a href="#id-9c45e6db-d284-4936-b3e4-b4fe1a2eab74" id="id-9c45e6db-d284-4936-b3e4-b4fe1a2eab74"></a>

Returns the total rewards for the whole network in a given timeframe.

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).

#### Query Parameters

| Name                                                                                                                                                                                                                                                                                | Tags     | Description                        | Example              | Type                                                                         |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ---------------------------------- | -------------------- | ---------------------------------------------------------------------------- |
| [min\_time](https://app.gitbook.com/s/-MW450HQkKqYSR06lFVV/untitled/Helium%20Blockchain%20API%201c514dd3dbc842179276d67376d5b1de/Rewards%20317764f3255c4dee89e09dfd62c9d59b/Query%20Parameters%20305bd2ae55c444e6a8d4a7afb74f781d/min_time%20498d786cdf6d4347aba43fef6c3ac492.html) | required | First time to include rewards for. | 2020-08-27T00:00:00Z | [ISO8601 timestamp](https://en.wikipedia.org/wiki/ISO_8601) or relative time |
| [max\_time](https://app.gitbook.com/s/-MW450HQkKqYSR06lFVV/untitled/Helium%20Blockchain%20API%201c514dd3dbc842179276d67376d5b1de/Rewards%20317764f3255c4dee89e09dfd62c9d59b/Query%20Parameters%20305bd2ae55c444e6a8d4a7afb74f781d/max_time%20d2e1a9818bc74aa7a144e12d3dcdda4d.html) | required | Last time to include rewards for.  | -1 week              | [ISO8601 timestamp](https://en.wikipedia.org/wiki/ISO_8601) or relative time |
| [bucket](https://app.gitbook.com/s/-MW450HQkKqYSR06lFVV/untitled/Helium%20Blockchain%20API%201c514dd3dbc842179276d67376d5b1de/Rewards%20317764f3255c4dee89e09dfd62c9d59b/Query%20Parameters%20305bd2ae55c444e6a8d4a7afb74f781d/bucket%20dd02c10593c746849ed93f8c703d7635.html)      | optional | Bucket specifier.                  | day                  | enum                                                                         |

### Response <a href="#id-2702db9b-a7f1-4abf-a54a-10cffaa80739" id="id-2702db9b-a7f1-4abf-a54a-10cffaa80739"></a>

```
{
    "meta": {
        "min_time": "2021-05-25T01:14:06Z",
        "max_time": "2021-05-26T01:14:06Z"
    },
    "data": {
        "total": 138754.62740928,
        "sum": 13875462740928,
        "stddev": 1002.93808104,
        "min": 3581.01850809,
        "median": 4233.79629017,
        "max": 8585.64812366,
        "avg": 4475.95572288
    }
}
```