## Overview

The Polkadot Staking Reporting API enables users to access staking data for validators and nominators. The API provides information on staking rewards, status, and staking activity.

🌐 **Supported network:** Mainnet

---

## ➡️ Stake & Rewards

The Stake and Rewards endpoints return the current or historical rewards data for both nominators and validators.

### Endpoints

**Nominators**

| Endpoint |
| --- |
| [Get the Stake & Rewards of a Nominator](https://docs.blockdaemon.com/reference/getstakeandrewardsnominator) \- `GET /nominator/rewards/{address}` |
| [Get a List of Stake & Rewards for Multiple Nominators](https://docs.blockdaemon.com/reference/getstakeandrewardsnominators) \- `POST /nominator/rewards` |
| [Get the Historical Stake & Rewards of a Nominator](https://docs.blockdaemon.com/reference/gethistoricalstakeandrewardsnominator) \- `POST /nominator/history/{address}` |
| [Get a List of Historical Stake & Rewards for Multiple Nominators](https://docs.blockdaemon.com/reference/gethistoricalstakeandrewardsnominators) \- `POST /nominator/history` |

**Validators**

| Endpoint |
| --- |
| [Get the Stake & Rewards of a Validator](https://docs.blockdaemon.com/reference/getstakeandrewardsvalidator2) \- `GET /validator/rewards/{address}` |
| [Get a List of Stake & Rewards for Multiple Validators](https://docs.blockdaemon.com/reference/getstakeandrewardsvalidators2) \- `POST /validator/rewards` |
| [Get the Historical Stake & Rewards of a Validator](https://docs.blockdaemon.com/reference/gethistoricalstakeandrewardsvalidator1) \- `POST /validator/history/{address}` |
| [Get a List of Historical Stake & Rewards for Multiple Validators](https://docs.blockdaemon.com/reference/gethistoricalstakeandrewardsvalidators2) \- `POST /validator/history` |

### Sample Object

The example object returned by the `Historical Stake & Rewards of a Validator` endpoint is shown below.

```json
[
  {
    "address": "11VR4pF6c7kfBhfmuwwjWY3FodeYBKWx7ix2rsRCU2q6hqJ",
    "currency": "DOT",
    "return": 783.089894122252,
    "timeStart": "2023-03-06T00:00:00Z",
    "timeEnd": "2023-03-12T23:59:59Z",
    "timeAggregation": "weekly",
    "startingBalance": 2058184.9337034964,
    "metadata": {
      "commission": 0.008,
      "validatorRewards": 776.8748949625516,
      "commissionRewards": 6.214999159700413
    }
  }
]
```

## ➡️ Status

This endpoint returns the current status of nominators and validators. Possible statuses include:

- `UNKNOWN`
- `ACTIVE`
- `INACTIVE`

### Endpoints

**Nominators**

| Endpoint |
| --- |
| [Get the Status of a Nominator](https://docs.blockdaemon.com/reference/get-status-nominator-polkadot) \- `GET /nominator/status/{address}` |
| [Get a List of Statuses for Multiple Nominators](https://docs.blockdaemon.com/reference/get-status-nominators-polkadot) \- `POST /nominator/status` |

**Validators**

| Endpoint |
| --- |
| [Get the Status of a Validator](https://docs.blockdaemon.com/reference/get-status-validator-polkadot) \- `GET /validator/status/{address}` |
| [Get the Status of Multiple Validators](https://docs.blockdaemon.com/reference/get-status-validators-polkadot) \- `POST /validator/status` |

### Sample Object

The example object returned by the `Status of Multiple Validators` endpoint is shown below.

```json
[
  {
    "address": "11VR4pF6c7kfBhfmuwwjWY3FodeYBKWx7ix2rsRCU2q6hqJ",
    "status": "active",
    "commission": 1,
    "activationDate": "2022-10-02"
  },
  {
    "address": "123VugBRFMqUEFviSYrG3ewdZ46ZmqxjmRaGY6BvakfdPVaG",
    "status": "active",
    "commission": 1,
    "activationDate": "2022-09-23"
  }
]
```

## ➡️ Staking Activity

This endpoint verifies the staking activity of nominators and validators. It helps track whether a participant is actively involved in staking.

### Endpoints

**Nominators**

| Endpoint |
| --- |
| [Verify the Staking Activity of a Nominator](https://docs.blockdaemon.com/reference/verify-staking-activity-nominator-polkadot) \- `GET /nominator/active/{address}` |
| [Verify the Staking Activity of Multiple Nominators](https://docs.blockdaemon.com/reference/verify-staking-activity-nominators-polkadot) \- `POST /nominator/active` |

**Validators**

| Endpoint |
| --- |
| [Verify the Staking Activity of a Validator](https://docs.blockdaemon.com/reference/verify-staking-activity-validator-polkadot) \- `GET /validator/active/{address}` |
| [Verify the Staking Activity of Multiple Validators](https://docs.blockdaemon.com/reference/verify-staking-activity-validators-polkadot) \- `POST /validator/active` |

### Sample Object

The example object returned by the `Staking Activity of a Nominator` endpoint is shown below.

```json
{
  "11VR4pF6c7kfBhfmuwwjWY3FodeYBKWx7ix2rsRCU2q6hqJ": false
}
```