Skip to main content
POST
/
api
/
v2
/
ethereum
/
validators
/
performance-list
Performance
curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/validators/performance-list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "validator": {
    "validator_identifiers": [
      1
    ]
  },
  "epoch": 1,
  "chain": "mainnet",
  "cursor": "",
  "page_size": 10
}
'
{
  "data": [
    {
      "validator": {
        "index": 1,
        "public_key": "<string>"
      },
      "beaconscore": {
        "total": 0.5,
        "attestation": 0.5,
        "proposal": 0.5,
        "sync_committee": 0.5
      },
      "duties": {
        "attestation": {
          "included": 123,
          "assigned": 123,
          "correct_head": 123,
          "correct_source": 123,
          "correct_target": 123,
          "valuable_correct_head": 123,
          "valuable_correct_source": 123,
          "valuable_correct_target": 123,
          "avg_inclusion_delay": 1.2,
          "avg_inclusion_delay_excluding_missed_slots": 1.2,
          "missed": 123
        },
        "sync_committee": {
          "successful": 1,
          "assigned": 1,
          "missed": 1
        },
        "proposal": {
          "successful": 123,
          "assigned": 123,
          "missed": 123,
          "included_slashings": 123
        }
      },
      "finality": "not_finalized"
    }
  ],
  "range": {
    "slot": {
      "start": 1,
      "end": 1
    },
    "epoch": {
      "start": 1,
      "end": 1
    },
    "timestamp": {
      "start": 1,
      "end": 1
    }
  },
  "paging": {
    "next_cursor": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Authorization header with value: Bearer YOUR_TOKEN. Refer to the API Keys section to create your API key.

Body

application/json
validator
Indexes/Public Keys · object
required

Free selectors available to all users:

  • validator_identifiers: One or more validator indices or public keys to filter by.
  • dashboard_id: Your beaconcha.in dashboard ID (requires a free account).

Premium selectors for Scale & Enterprise plans (https://beaconcha.in/pricing):

  • withdrawal: The validator's withdrawal credential or the Ethereum wallet address used for withdrawals.
  • deposit_address: The Ethereum wallet address used for the validator's deposit.
epoch
integer
required
Required range: x >= 0
chain
enum<string>
default:mainnet

The Ethereum chain to query.

Available options:
mainnet,
hoodi
cursor
string
default:""

Cursor value for pagination. See our pagination guide for more details.

page_size
integer
default:10

The number of items to return per page.

Required range: 1 <= x <= 10

Response

Successful response.

Response containing detailed performance information of the validators.

data
object[]
required
range
object
required

The range of data covered by the results, specified in slots, epochs, and Unix timestamps.

paging
object