Report Validators

curl -v -X 'POST' \
  'https://api.rated.network/v0/selfReports/validators' \
  -H 'Content-Type: application/json' \
  -H 'X-Rated-Network: mainnet' \
  -H 'Authorization: Bearer <YOUR-TOKEN-HERE>'
  -d '{"validators": ["0x01...", "0x02..."], "poolTag": "Lido"}'

import requests

from typing import Dict, List

YOUR_TOKEN: str = "ey..."
PUBKEYS: List[str] = ["0x001...", "0x002...", ]
HEADERS: Dict[str, str] = {
    "Authorization": f"Bearer {YOUR_TOKEN}",
    "X-Rated-Network": "mainnet",
}

try:
    response = requests.post(
        "https://api.rated.network/v0/selfReports/validators",
        # important! use the json parameter not data
        json={"validators": PUBKEYS, "poolTag": "Lido"},
        headers=HEADERS,
    )
    response.raise_for_status()
except requests.exceptions.HTTPError:
    print(response.headers["x-request-id"])
    print(response.json())

{
  "operatorName": "<string>",
  "validators": [
    "<string>"
  ],
  "poolTag": "<string>"
}

{
  "detail": [
    {
      "msg": "<string>",
      "type": "<string>",
      "loc": [
        "<string>"
      ]
    }
  ]
}

POST

selfReports

validators

curl -v -X 'POST' \
  'https://api.rated.network/v0/selfReports/validators' \
  -H 'Content-Type: application/json' \
  -H 'X-Rated-Network: mainnet' \
  -H 'Authorization: Bearer <YOUR-TOKEN-HERE>'
  -d '{"validators": ["0x01...", "0x02..."], "poolTag": "Lido"}'

import requests

from typing import Dict, List

YOUR_TOKEN: str = "ey..."
PUBKEYS: List[str] = ["0x001...", "0x002...", ]
HEADERS: Dict[str, str] = {
    "Authorization": f"Bearer {YOUR_TOKEN}",
    "X-Rated-Network": "mainnet",
}

try:
    response = requests.post(
        "https://api.rated.network/v0/selfReports/validators",
        # important! use the json parameter not data
        json={"validators": PUBKEYS, "poolTag": "Lido"},
        headers=HEADERS,
    )
    response.raise_for_status()
except requests.exceptions.HTTPError:
    print(response.headers["x-request-id"])
    print(response.json())

{
  "operatorName": "<string>",
  "validators": [
    "<string>"
  ],
  "poolTag": "<string>"
}

{
  "detail": [
    {
      "msg": "<string>",
      "type": "<string>",
      "loc": [
        "<string>"
      ]
    }
  ]
}

Here’s how to interpret the inputs required to operate it:

Parameter	Context
`validators`	Array of validator pubkeys associated with the node operator
`poolTag`	String for pool name, must match exactly to the pool name listed on the Explorer.

And here’s how to you might go about implementing it:

curl -v -X 'POST' \
  'https://api.rated.network/v0/selfReports/validators' \
  -H 'Content-Type: application/json' \
  -H 'X-Rated-Network: mainnet' \
  -H 'Authorization: Bearer <YOUR-TOKEN-HERE>'
  -d '{"validators": ["0x01...", "0x02..."], "poolTag": "Lido"}'

import requests

from typing import Dict, List

YOUR_TOKEN: str = "ey..."
PUBKEYS: List[str] = ["0x001...", "0x002...", ]
HEADERS: Dict[str, str] = {
    "Authorization": f"Bearer {YOUR_TOKEN}",
    "X-Rated-Network": "mainnet",
}

try:
    response = requests.post(
        "https://api.rated.network/v0/selfReports/validators",
        # important! use the json parameter not data
        json={"validators": PUBKEYS, "poolTag": "Lido"},
        headers=HEADERS,
    )
    response.raise_for_status()
except requests.exceptions.HTTPError:
    print(response.headers["x-request-id"])
    print(response.json())

Please note the following:

You can self report on Ethereum Mainnet and Hoodi.
Do not pass your operator name as pool name. If you’re not getting delegations via a pool or pool share, please leave the “poolTag” empty.
Each request has a strict limit of 1,000 validator public keys. Please submit multiple requests if you need to report more than 1,000 validators.
We cannot assign a key to your entity if it has already been reported by another operator. In case of false attribution, please contact us at [email protected], and we will address the issue.
As this API is self-reported, it relies on the honest behaviour of all participants reporting their validators. Any instances of misconduct may lead to the exclusion of the entity from our platform.
It typically takes about 24 hours for the reported keys to appear on rated.network/explorer. Please note that your keys need to be activated (ie not in the activation queue) for them to show up on the Explorer.
If your activated keys have not shown up after the 24h period, please contact us at [email protected], and we will investigate the issue.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Rated-Network

enum<string>

default:mainnet

Available options:

mainnet,

hoodi,

holesky

Body

application/json

validators

string[]

required

Required array length: 1 - 1000 elements

poolTag

string | null

Response

Successful Response

operatorName

string

required

validators

string[]

required

network

enum<string>

required

Available options:

mainnet,

hoodi,

holesky

poolTag

string | null

Summary Summary

⌘I

Getting started

Rated API

Endpoints

Glossary

Guides

Tools

Please note the following:

Authorizations

Headers

Body

Response

​Please note the following:

Authorizations

Headers

Body

Response

Please note the following: