Skip to main content
GET
/
api
/
v1
/
validator
/
{indexOrPubkey}
/
withdrawals
Validator withdrawal history
curl --request GET \
  --url 'https://beaconcha.in/api/v1/validator/{indexOrPubkey}/withdrawals?apikey='
{
  "status": "OK",
  "data": [
    {
      "epoch": 399379,
      "slot": 12780154,
      "blockroot": "0xf5068b6240d2ca8d77b6924a4397263fda4647b09c7d767865637643a7be421d",
      "withdrawalindex": 104312607,
      "validatorindex": 1440116,
      "address": "0x4c66c2055f6a7a01e102bde8d8d71d1d36667e21",
      "amount": 18402466
    }
  ]
}

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"

Query Parameters

​
epoch
integer

Upper bound (inclusive) for the 100-epoch window used to fetch withdrawals. Defaults to the latest processed epoch when omitted. Must be a non-negative integer.

Required range: x >= 0
Example:

399359

Response

Matching withdrawals were retrieved successfully. The data array contains one item per withdrawal observed for any of the specified validators within the requested epoch window. If no withdrawals are found, the array is empty.

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.