BLS-to-execution credential changes

curl --request GET \
  --url 'https://beaconcha.in/api/v1/validator/{indexOrPubkey}/blsChange?apikey='

{
  "status": "OK",
  "data": [
    {
      "epoch": 200820,
      "slot": 6426248,
      "blockroot": "0x387e15e80bfce46c2217cd149ec0a03a5f82ce393de12936ca243e076517148b",
      "validatorindex": 20,
      "bls_pubkey": "0x8b84918f955498cd0f6f44537cd0745d29ceffe16a37a353da746ad6879ec1c5992520708aad13b2333ce562faef083c",
      "bls_signature": "0xb735398d821c5eb6356c71e35d59dd29ee56429d03dd443746d3de1bffb9049ed1bd45ab115de42ee3c6d0b69017d9b11413e1c7a0640553c14f8d2076369d51301720f3861c9b824a8a486d116c9bfe38c53747b33d3f1e664ce5ead157ec16",
      "address": "0x23a64e36ae03d85a6121e55e48f6b8eb63d72f76",
      "withdrawalcredentials_0x00": "0x009081da37d4f11d87592b89734db953de64fcb381436b235551b209f3fac343",
      "withdrawalcredentials_0x01": "0x01000000000000000000000023a64e36ae03d85a6121e55e48f6b8eb63d72f76"
    }
  ]
}

Validators

BLS-to-execution credential changes

Retrieve on-chain BLS-to-execution credential change messages (EIP-4881 style) for one or more validators. Each item includes the slot and epoch of inclusion, the canonical block root, the validator’s BLS pubkey and signature over the change message, the original 0x00 withdrawal credentials, and the resulting 0x01 credentials (derived from the execution address). Provide validator identifiers as a comma-separated list in the path. The service accepts validator indices and 0x-prefixed BLS pubkeys (up to the server-enforced limit; default 100). If a provided pubkey does not resolve to a known validator index, the request fails with HTTP 400.

GET

api

validator

{indexOrPubkey}

blsChange

BLS-to-execution credential changes

curl --request GET \
  --url 'https://beaconcha.in/api/v1/validator/{indexOrPubkey}/blsChange?apikey='

{
  "status": "OK",
  "data": [
    {
      "epoch": 200820,
      "slot": 6426248,
      "blockroot": "0x387e15e80bfce46c2217cd149ec0a03a5f82ce393de12936ca243e076517148b",
      "validatorindex": 20,
      "bls_pubkey": "0x8b84918f955498cd0f6f44537cd0745d29ceffe16a37a353da746ad6879ec1c5992520708aad13b2333ce562faef083c",
      "bls_signature": "0xb735398d821c5eb6356c71e35d59dd29ee56429d03dd443746d3de1bffb9049ed1bd45ab115de42ee3c6d0b69017d9b11413e1c7a0640553c14f8d2076369d51301720f3861c9b824a8a486d116c9bfe38c53747b33d3f1e664ce5ead157ec16",
      "address": "0x23a64e36ae03d85a6121e55e48f6b8eb63d72f76",
      "withdrawalcredentials_0x00": "0x009081da37d4f11d87592b89734db953de64fcb381436b235551b209f3fac343",
      "withdrawalcredentials_0x01": "0x01000000000000000000000023a64e36ae03d85a6121e55e48f6b8eb63d72f76"
    }
  ]
}

Authorizations

apikey

string

query

required

Path Parameters

indexOrPubkey

string

required

Comma-separated validator indices and/or public keys (maximum 100 items by default). Comma-separated list (no spaces) of validator identifiers. Each identifier must be either:

A validator index as a base-10 integer (for example, 652648)
A BLS public key as a 96-hex-character string with or without the 0x prefix (case-insensitive)

Resolution and limits:

The server resolves public keys to validator indices before querying data.
The total number of identifiers must not exceed the server-enforced limit (default 100).
Identifiers that cannot be parsed or resolved result in HTTP 400.

Example:

"1,2,3"

Response

Matching BLS credential changes were retrieved successfully. The data array contains one entry per observed change event.

Standard success envelope used by all API endpoints.

status

enum<string>

HTTP-independent status of the API operation. For successful responses this is always "OK".

Available options:

OK

data

object[]

Response payload specific to the endpoint.

Show child attributes

data.epoch

integer

Epoch containing the block that included the credential change (>= 0).

Required range: x >= 0

Example:

200820

data.slot

integer

Slot number of the beacon block that included the credential change (>= 0).

Required range: x >= 0

Example:

6426248

data.blockroot

string

0x-prefixed 32-byte root of the including beacon block.

Example:

"0x387e15e80bfce46c2217cd149ec0a03a5f82ce393de12936ca243e076517148b"

data.validatorindex

integer

Index of the validator that submitted the credential change (>= 0).

Required range: x >= 0

Example:

20

data.bls_pubkey

string

BLS12-381 validator public key (48 bytes; 0x-prefixed hex with 96 hex characters).

Example:

"0x8b84918f955498cd0f6f44537cd0745d29ceffe16a37a353da746ad6879ec1c5992520708aad13b2333ce562faef083c"

data.bls_signature

string

BLS signature over the change message (96 bytes; 0x-prefixed hex with 192 hex characters).

Example:

"0xb735398d821c5eb6356c71e35d59dd29ee56429d03dd443746d3de1bffb9049ed1bd45ab115de42ee3c6d0b69017d9b11413e1c7a0640553c14f8d2076369d51301720f3861c9b824a8a486d116c9bfe38c53747b33d3f1e664ce5ead157ec16"

data.address

string

Execution-layer address encoded in the new 0x01 withdrawal credentials (0x-prefixed, 20-byte hex).

Example:

"0x23a64e36ae03d85a6121e55e48f6b8eb63d72f76"

data.withdrawalcredentials_0x00

string

Original withdrawal credentials prior to the change (32 bytes; 0x-prefixed hex, starts with 0x00).

Example:

"0x009081da37d4f11d87592b89734db953de64fcb381436b235551b209f3fac343"

data.withdrawalcredentials_0x01

string

New withdrawal credentials after the change (32 bytes; 0x-prefixed hex, starts with 0x01 = 0x01 || 0x00..00 || address).

Example:

"0x01000000000000000000000023a64e36ae03d85a6121e55e48f6b8eb63d72f76"

Validator balance history

Validator deposits (execution layer)

Introduction

API Docs

BLS-to-execution credential changes

Authorizations

Path Parameters

Response