> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rated.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Rewards

> A series of endpoints that drill down on rewards related metrics for stake pools (validators) and the network.

export const Endpoint = ({type, path, url}) => {
  const methodColors = {
    post: 'bg-blue-400/20 text-blue-700 dark:bg-blue-400/20 dark:text-blue-400',
    get: 'bg-green-400/20 text-green-700 dark:bg-green-400/20 dark:text-green-400',
    put: 'bg-yellow-400/20 text-yellow-700 dark:bg-yellow-400/20 dark:text-yellow-400',
    delete: 'bg-red-400/20 text-red-700 dark:bg-red-400/20 dark:text-red-400',
    patch: 'bg-orange-400/20 text-orange-700 dark:bg-orange-400/20 dark:text-orange-400'
  };
  const pathParts = path.startsWith('/') ? path.substring(1).split('/') : path.split('/');
  return <a href={url} className="relative flex-1 flex gap-2 min-w-0 rounded-xl items-center cursor-pointer p-1.5 border-standard">
        <div className={`rounded-lg font-bold px-1.5 py-0.5 text-sm leading-5 ${methodColors[type.toLowerCase()]}`}>
          {type}
        </div>
        <div className="flex items-center space-x-2 overflow-x-auto flex-1 no-scrollbar">
          <div className="group flex items-center flex-1 gap-0.5 font-mono">
            {url && <div className="absolute right-0 p-2 rounded-lg hidden group-hover:block">
                <Icon icon="arrow-right" />
              </div>}
            {pathParts.map((part, i) => {
    const isParam = part.includes('{');
    return <>
                  <div className="text-sm text-gray-400">/</div>
                  {isParam ? <div className="text-sm font-mono font-medium rounded-md px-1 border-2 min-w-max text-[#2AB673] bg-[#2AB673]/10 border-[#2AB673]/30">
                      {part}
                    </div> : <div className="text-sm font-medium text-gray-800 dark:text-white min-w-max">
                      {part}
                    </div>}
                </>;
  })}
          </div>
        </div>
      </a>;
};

<Note>
  Historical rewards are available from November 1, 2024.
</Note>

## Validator Rewards

### Rewarded Duties

In Cardano, validators are referred to as stake pools. Stake pools are server nodes that combine the stake of various stakeholders into a single entity (i.e. a single stake pool). These stake pools have the responsibility of validating and producing blocks, and processing transactions. As such, the rewards that these stake pools receive are based on these duties.

### Calculation and Timing

The rewards are calculated and distributed on a per epoch basis, with each epoch being 5 days. Once the rewards are calculated, they are held by the Cardano treasury at the end of the epoch when they are earned. After the treasury takes a 20% cut, the rewards are then locked up for 2 epochs before they are distributed to stake pools.

### Commission and Distribution

With the rewards being distributed to the stake pools, the leader (i.e. stake pool owner/validator operator) first takes a "fixed fee" (`poolFlatFee`) from the rewards which is usually a static amount, then takes their "margin fee" which is a percentage commission (`poolFee`). The remaining rewards are then split proportionally between the leader and the members (i.e. delegators) depending on how much they have staked in the stake pool.

<Endpoint type="GET" path="/v1/cardano/validators/{pool_id}/rewards" url="/rated-api/api-reference/v1/cardano/rewards/get-validator-rewards-metrics" />

## Network Rewards

This network rewards endpoint gives you a breakdown of all rewards earned and realized/received by stake pools over a specified period of time.

<Endpoint type="GET" path="/v1/cardano/network/rewards" url="/rated-api/api-reference/v1/cardano/rewards/get-network-rewards-metrics" />