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

# Developers FAQ

> Frequently asked questions in and around the Rated API.

## How do I access the Rated API?

To access the Rated API you will need to head to [console.rated.network](https://console.rated.network/) and create an account.

## How is the Rated API structured?

The RatedAPI is adopted for rewards tracking, performance monitoring and benchmarking. Full details can be found under [API reference](/rated-api/api-reference).

## How can I use the Rated API for monitoring validator performance on Grafana?

Check out our Rated CLI on [github](https://github.com/rated-network/rated-cli) to bring all the information that the Rated API supports, in your local monitoriong suite.

<Note>
  Please remember to contribute back to the main branch if you come up with extensions, bug fixes, new modules etc.
</Note>

## What is the definition of "effectiveness" in the API?

The effectiveness rating (RAVER) is a methodology Rated has proposed for evaluating validator performance in a concise way. The methodology has been through a number of iterations with the community and is widespread by now. For more information on the specifics, please refer to our documentation.

## Can I query the API up to a specific granular time (i.e. epoch, slot)?

The API doesn't allow you to specify epoch. Data is pre-aggregated into 225 epoch intervals, so the minimum current granularity is 1 day. The API does offer `startEpoch` and `endEpoch` in the response, so that you have visibility of which epochs have been aggregated.

## Can I get the current balance of the validator node from the API?

This information is not currently available. We are working on withdrawals and as part of this we are planning a few features related to balances and partial/full withdrawals that will be updated in real-time!

## I am trying to use /v0/eth/validators/effectiveness endpoint with granularity set to month, but I get error: "Can't use granularity when grouping by validator." Any suggestions?

The API can aggregate in two ways. Depending on what you are trying to achieve the query params available are different.

1. `timeWindow` - Validator data is aggregated in time buckets

* Data for validator 1,2 and 3 get aggregated and one row is returned for every day/week/month. [Link to example](https://api.rated.network/v0/eth/validators/effectiveness?indices=10\&indices=11\&indices=13\&groupBy=timeWindow\&granularity=day)

2. `validator` - Daily validator data is aggregated by pubkey/index

* Data for validators 1,2,3 get aggregated in one row per validator. The time period to aggregate can be arbitrary. [Link to example](https://api.rated.network/v0/eth/validators/effectiveness?indices=10\&indices=11\&indices=13\&groupBy=validator\&from=2023-01-30\&to=2023-01-01\&filterType=datetime)

## My use case requires a higher bandwidth of use than the current rated limit allows. Wat do?

shoot us a note at [hello@rated.network](mailto:hello@rated.network).