---
updatedAt: 2026-05-20T06:39:23.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.

# Get the Historical Stake and Rewards for Multiple Delegators

Returns the historical stake and rewards allocated to multiple staking delegators.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "version": "1.0.0",
    "title": "Staking Reporting API",
    "description": "### Protocols \nThe following protocols are currently supported:\n* Cardano\n* Cosmos\n* Ethereum\n* NEAR\n* Polkadot\n* Polygon \n* Solana \n",
    "contact": {
      "name": "Blockdaemon",
      "email": "support@blockdaemon.com",
      "url": "https://blockdaemon.com"
    },
    "x-logo": {
      "url": "logo.png"
    }
  },
  "servers": [
    {
      "url": "https://svc.blockdaemon.com/reporting/staking",
      "description": "Production server"
    }
  ],
  "security": [
    {
      "apiKeyAuthHeader": []
    },
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/v1/cardano/mainnet/delegator/history": {
      "post": {
        "tags": [
          "Cardano Staking Reporting"
        ],
        "summary": "Get the Historical Stake and Rewards for Multiple Delegators",
        "description": "Returns the historical stake and rewards allocated to multiple staking delegators.",
        "operationId": "Get Historical Stake and Rewards for multiple Delegators",
        "parameters": [
          {
            "name": "aggregate",
            "in": "query",
            "description": "Set to true for the rewards to be aggregated across addresses.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MultiDelegatorHistoricRewardsQuery"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Rewards"
                },
                "example": {
                  "rewards": [
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "56.148764",
                      "startingBalance": "27761.420614",
                      "timeAggregation": "monthly",
                      "timeEnd": "2023-05-31T23:59:59Z",
                      "timeStart": "2023-05-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "72.972703",
                      "startingBalance": "22474.808699",
                      "timeAggregation": "monthly",
                      "timeEnd": "2023-04-30T23:59:59Z",
                      "timeStart": "2023-04-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "78.148158",
                      "startingBalance": "22395.826448",
                      "timeAggregation": "monthly",
                      "timeEnd": "2023-03-31T23:59:59Z",
                      "timeStart": "2023-03-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "56.987177",
                      "startingBalance": "22344.996632",
                      "timeAggregation": "monthly",
                      "timeEnd": "2023-02-28T23:59:59Z",
                      "timeStart": "2023-02-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "58.981383",
                      "startingBalance": "22281.649658",
                      "timeAggregation": "monthly",
                      "timeEnd": "2023-01-31T23:59:59Z",
                      "timeStart": "2023-01-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "81.592729",
                      "startingBalance": "22202.422476",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-12-31T23:59:59Z",
                      "timeStart": "2022-12-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "65.361381",
                      "startingBalance": "22138.276649",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-11-30T23:59:59Z",
                      "timeStart": "2022-11-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "399.198058",
                      "startingBalance": "295391.872886",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-10-31T23:59:59Z",
                      "timeStart": "2022-10-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "901.621736",
                      "startingBalance": "294552.735998",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-09-30T23:59:59Z",
                      "timeStart": "2022-09-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "882.996146",
                      "startingBalance": "293649.006910",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-08-31T23:59:59Z",
                      "timeStart": "2022-08-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "927.451592",
                      "startingBalance": "292667.068999",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-07-31T23:59:59Z",
                      "timeStart": "2022-07-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "1019.301148",
                      "startingBalance": "278990.972429",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-06-30T23:59:59Z",
                      "timeStart": "2022-06-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "854.937728",
                      "startingBalance": "278034.761182",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-05-31T23:59:59Z",
                      "timeStart": "2022-05-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "835.299823",
                      "startingBalance": "277314.634954",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-04-30T23:59:59Z",
                      "timeStart": "2022-04-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "1030.839638",
                      "startingBalance": "276213.860646",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-03-31T23:59:59Z",
                      "timeStart": "2022-03-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "754.698463",
                      "startingBalance": "275496.275827",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-02-28T23:59:59Z",
                      "timeStart": "2022-02-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "891.121983",
                      "startingBalance": "274571.459950",
                      "timeAggregation": "monthly",
                      "timeEnd": "2022-01-31T23:59:59Z",
                      "timeStart": "2022-01-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "1651.859400",
                      "startingBalance": "22611.441114",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-12-31T23:59:59Z",
                      "timeStart": "2021-12-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "3523.769067",
                      "startingBalance": "1385375.911107",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-11-30T23:59:59Z",
                      "timeStart": "2021-11-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "6572.065984",
                      "startingBalance": "1715359.500888",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-10-31T23:59:59Z",
                      "timeStart": "2021-10-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "6370.037435",
                      "startingBalance": "1808972.651363",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-09-30T23:59:59Z",
                      "timeStart": "2021-09-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "6489.460463",
                      "startingBalance": "1802084.516328",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-08-31T23:59:59Z",
                      "timeStart": "2021-08-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "6478.693817",
                      "startingBalance": "1796965.244613",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-07-31T23:59:59Z",
                      "timeStart": "2021-07-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "3858.082451",
                      "startingBalance": "1875834.948102",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-06-30T23:59:59Z",
                      "timeStart": "2021-06-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "9307.709931",
                      "startingBalance": "2001168.830524",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-05-31T23:59:59Z",
                      "timeStart": "2021-05-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "12988.588658",
                      "startingBalance": "1841524.117636",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-04-30T23:59:59Z",
                      "timeStart": "2021-04-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "16399.536086",
                      "startingBalance": "2042978.639272",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-03-31T23:59:59Z",
                      "timeStart": "2021-03-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "13436.345150",
                      "startingBalance": "2028496.915900",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-02-28T23:59:59Z",
                      "timeStart": "2021-02-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "19131.319892",
                      "startingBalance": "2213586.272660",
                      "timeAggregation": "monthly",
                      "timeEnd": "2021-01-31T23:59:59Z",
                      "timeStart": "2021-01-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "23179.555534",
                      "startingBalance": "2207094.256559",
                      "timeAggregation": "monthly",
                      "timeEnd": "2020-12-31T23:59:59Z",
                      "timeStart": "2020-12-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "13457.550657",
                      "startingBalance": "2196985.731537",
                      "timeAggregation": "monthly",
                      "timeEnd": "2020-11-30T23:59:59Z",
                      "timeStart": "2020-11-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "10151.938775",
                      "startingBalance": "2185986.613700",
                      "timeAggregation": "monthly",
                      "timeEnd": "2020-10-31T23:59:59Z",
                      "timeStart": "2020-10-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "8761.884164",
                      "startingBalance": "1929816.611184",
                      "timeAggregation": "monthly",
                      "timeEnd": "2020-09-30T23:59:59Z",
                      "timeStart": "2020-09-01T00:00:00Z"
                    },
                    {
                      "address": "multi",
                      "currency": "ADA",
                      "metadata": {
                        "epoch": 0
                      },
                      "return": "3918.024712",
                      "startingBalance": "1928603.929764",
                      "timeAggregation": "monthly",
                      "timeEnd": "2020-08-31T23:59:59Z",
                      "timeStart": "2020-08-01T00:00:00Z"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/error1"
                },
                "example": {
                  "code": 400,
                  "title": "request body has an error: doesn't match schema #/components/schemas/MultiDelegatorHistoricRewardsQuery: Error at '/addresses/0': string doesn't match the regular expression '^stake[a-z0-9]+$'"
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/error1"
                },
                "example": {
                  "code": 404,
                  "title": "delegators not found"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "apiKeyAuthHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key",
        "description": "Unlock higher TPS - Create your own API key in the [Blockdaemon App](https://app.blockdaemon.com).\n",
        "x-default": "2go1YqUcuAr4WZ2-3WgSD3c7qpatZqQuNWhTVBldKZnTSUtw"
      },
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "Opaque",
        "description": "[Legacy Auth] Unlock higher TPS - Create your own API key in the [Blockdaemon App](https://app.blockdaemon.com).\n",
        "x-default": "2go1YqUcuAr4WZ2-3WgSD3c7qpatZqQuNWhTVBldKZnTSUtw"
      }
    },
    "schemas": {
      "MultiDelegatorHistoricRewardsQuery": {
        "required": [
          "fromTime",
          "toTime",
          "timeUnit",
          "addresses"
        ],
        "type": "object",
        "properties": {
          "fromTime": {
            "type": "integer",
            "format": "int64",
            "description": "The Unix timestamp in seconds from which you wish to retrieve rewards.",
            "example": 1577836800,
            "default": 1577836800
          },
          "toTime": {
            "type": "integer",
            "format": "int64",
            "description": "The Unix timestamp in seconds until which rewards are retrieved.",
            "example": 1685491200,
            "default": 1685491200
          },
          "timeUnit": {
            "$ref": "#/components/schemas/TimeUnit1"
          },
          "addresses": {
            "type": "array",
            "description": "List of addresses to retrieve rewards for.",
            "default": [
              "stake1u8003gtvhcunzzmy85nfnk6kafd8lks2mykfzf0n4hq4qzg9f029u",
              "stake1u80058a9nztq6d5sudzynepf63pedvpyr3kzhlxacrcefwqf3ez2y"
            ],
            "items": {
              "type": "string",
              "pattern": "^stake[a-z0-9]+$"
            }
          }
        }
      },
      "TimeUnit1": {
        "type": "string",
        "description": "Represents how the rewards are aggregated. Must be one of `epoch`, `daily`, `weekly`, or `monthly`.",
        "enum": [
          "epoch",
          "daily",
          "weekly",
          "monthly"
        ]
      },
      "Rewards": {
        "type": "object",
        "required": [
          "rewards"
        ],
        "properties": {
          "rewards": {
            "type": "array",
            "description": "A list of rewards.",
            "items": {
              "$ref": "#/components/schemas/Reward"
            }
          }
        }
      },
      "Reward": {
        "required": [
          "address",
          "currency",
          "metadata",
          "return",
          "startingBalance",
          "timeAggregation",
          "timeEnd",
          "timeStart"
        ],
        "type": "object",
        "properties": {
          "address": {
            "type": "string",
            "description": "The user-defined address."
          },
          "currency": {
            "type": "string",
            "description": "The cryptocurrency protocol the request relates to.",
            "example": "ADA"
          },
          "metadata": {
            "$ref": "#/components/schemas/Metadata2"
          },
          "return": {
            "type": "string",
            "description": "The sum of the rewards for the previous UTC day.",
            "example": "500.000000"
          },
          "startingBalance": {
            "type": "string",
            "description": "The staked amount at the beginning of the previous UTC day (at the timeStart).",
            "example": "5004.058667"
          },
          "timeAggregation": {
            "type": "string",
            "example": "weekly",
            "description": "The agregation period. Either one of `epoch`, `daily`, `weekly`, or `monthly`."
          },
          "timeEnd": {
            "type": "string",
            "description": "The timestamp, in UTC, that marks the end of the period covered.",
            "example": "2022-07-31T23:59:59.000Z"
          },
          "timeStart": {
            "type": "string",
            "description": "The timestamp, in UTC, that marks the start of the period covered.",
            "example": "2022-07-01T00:00:00.000Z"
          }
        }
      },
      "Metadata2": {
        "required": [
          "epoch"
        ],
        "type": "object",
        "description": "The protocol specific data.",
        "properties": {
          "commission": {
            "type": "number",
            "format": "double",
            "description": "The commission rate.",
            "example": 0.01
          },
          "epoch": {
            "type": "integer",
            "format": "int",
            "description": "The epoch number the rewards were earned in.",
            "example": 348
          }
        }
      },
      "error1": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "The numeric error code.",
            "example": 16384
          },
          "title": {
            "type": "string",
            "description": "The error description.",
            "example": "Invalid Address"
          }
        }
      }
    }
  },
  "x-readme": {
    "samples-languages": [
      "curl",
      "go",
      "javascript",
      "python",
      "node"
    ],
    "explorer-enabled": false
  }
}
```