---
updatedAt: 2026-05-20T05:41:02.000Z
---

Fetch the complete documentation index at: https://docs.blockdaemon.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Polkadot Reporting API Overview

## 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
}
```

## 👋 Need Help?

Contact us through [email](mailto:support@blockdaemon.com) or our [support page](https://www.blockdaemon.com/support) for any issues, bugs, or assistance you may need.