> ## 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.

# Ethereum Overview

> A series of endpoint that provide a high level overview of all the different pools, operators, withdrawal/deposit addresses and validator indexes that form the infrastructure layer of Ethereum

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>;
};

## Entity Summaries

The Rated API enables users to query into key metrics of pre-materialized entities. This works pretty much as hinted by the Rated Explorer, but with a much higher degree of flexibility in terms of time-frames, and granularity in terms of metrics.

### What do you mean by "pre-materialized entities"?

The shortest way to put it, in an Ethereum context, is "groups of validators bound together by agency". This could be:

1. a pool (e.g. [Lido](https://www.rated.network/o/Lido?network=mainnet\&timeWindow=1d\&viewBy=operator\&page=1))
2. a node operator (e.g. [Allnodes](https://www.rated.network/o/Allnodes?network=mainnet\&timeWindow=1d\&viewBy=aggregate))
3. a fraction of a node operator's fleet that maps under a specific pool (e.g. [Stakefish under Lido](https://www.rated.network/o/Stakefish%20-%20Lido?network=mainnet\&timeWindow=1d))
4. a group of validator indices mapped to a specific deposit address (e.g. [0xdd192...](https://www.rated.network/o/0xdd19274b614b5ecacf493bc43c380ef6b8dfb56c?network=mainnet\&timeWindow=1d))
5. a group of validator indices mapped to a specific withdrawal address (e.g. [0xdd192...](https://www.rated.network/o/0xdd19274b614b5ecacf493bc43c380ef6b8dfb56c?network=mainnet\&timeWindow=1d))

<Note>
  If you want to get your entity tracked on Rated, head to [https://bit.ly/RatedPoolOnboarding](https://bit.ly/RatedPoolOnboarding) to onboard as a pool or head to [Self Report](/rated-api/api-reference/v0/ethereum/self-report/self-report) to onboard as a node operator.
</Note>

### Get summary stats on Pools, Operators and Addresses

<Endpoint type="GET" path="/v1/eth/entities/summaries" url="/rated-api/api-reference/v1/ethereum/overview/get-summary-stats-on-pools-operators-and-addresses" />

### Get summary stats on individual Pools, Operators and Addresses

<Endpoint type="GET" path="/v1/eth/entities/{entity_id}/summaries" url="/rated-api/api-reference/v1/ethereum/overview/get-summary-stats-on-individual-pools-operators-and-addresses" />

## Validator Summaries

The validators class is the lowest order of aggregation that the Rated API supports.

### What is a "validator"?

A validator is a virtual entity that lives on Ethereum and participates in the consensus of the Ethereum protocol. Validators are represented by a balance, public key, and other properties.

### Get a list of validators

<Endpoint type="GET" path="v1/eth/validators" url="/rated-api/api-reference/v1/ethereum/overview/get-a-list-of-validators" />

### Get a validator summary

<Endpoint type="GET" path="v1/eth/validators/{validator_index_or_pubkey}" url="/rated-api/api-reference/v1/ethereum/overview/get-validator" />