---
title: "Get the Historical Stake and Rewards for Multiple Pools"
method: POST
path: "/v1/cardano/mainnet/pool/history"
tags: ["Cardano Staking Reporting"]
---

# Get the Historical Stake and Rewards for Multiple Pools

`POST /v1/cardano/mainnet/pool/history`

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

## Query parameters

- `aggregate` boolean

## Request body

- MultiPoolHistoricRewardsQuery
  - `fromTime` integer, required — The Unix timestamp in seconds from which you wish to retrieve rewards.
  - `toTime` integer, required — The Unix timestamp in seconds until which rewards are retrieved.
  - `timeUnit` 'epoch' | 'daily' | 'weekly' | 'monthly', required — Represents how the rewards are aggregated. Must be one of `epoch`, `daily`, `weekly`, or `monthly`.
  - `addresses` string[], required — List of addresses to retrieve rewards for.

## Response `200`

- Rewards
  - `rewards` Reward[], required — A list of rewards.
    - `address` string, required — The user-defined address.
    - `currency` string, required — The cryptocurrency protocol the request relates to.
    - `metadata` Metadata2, required — The protocol specific data.
      - `commission` number, double — The commission rate.
      - `epoch` integer, required — The epoch number the rewards were earned in.
    - `return` string, required — The sum of the rewards for the previous UTC day.
    - `startingBalance` string, required — The staked amount at the beginning of the previous UTC day (at the timeStart).
    - `timeAggregation` string, required — The agregation period. Either one of `epoch`, `daily`, `weekly`, or `monthly`.
    - `timeEnd` string, required — The timestamp, in UTC, that marks the end of the period covered.
    - `timeStart` string, required — The timestamp, in UTC, that marks the start of the period covered.

## Other responses

- `400` — Invalid request
- `404` — Resource not found

---

[API](https://skmtc.dev/blockdaemon/apis/staking-api.md) · [All operations](https://skmtc.dev/blockdaemon/apis/staking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blockdaemon/staking-api/revisions/f94e296a08a3/schema)