ETH Staking API
The ETH Staking API offers a comprehensive set of endpoints for managing Ethereum (ETH) validators and staking activities. These calls are used for validator management, data retrieval, transaction generation, and performance reporting.
Here is a summary of the ETH staking API endpoints, with all links based on the provided base URL:
1. Stake Creation and Management
These endpoints are used for creating new validator stakes, managing their status, and handling the deposit process.
| API Call | Method | Description |
|---|---|---|
| Create Pectra-era (0x02) validator(s) | POST | Creates a new Pectra-era validator stake. |
| Create Capella-era (0x01) validator(s) | POST | Creates a new Capella-era validator stake (V2). |
| Abandon Stake | PUT | Abandons a stake before it is fully deposited. |
| Generate initial validator deposit transaction | POST | Crafts a transaction payload for an initial 32 ETH deposit. |
| Generate batch initial validator deposit transaction | POST | Crafts a transaction payload for a batch of initial deposits. |
| Generate validator top-up transaction | POST | Crafts a transaction payload to top up an existing validator. |
| Generate batch validator top-up transaction | POST | Crafts a transaction payload for a batch of validator top-ups. |
| Generate arbitrary amount deposit data | POST | Generates deposit data for a non-standard amount. |
2. Validator Exits and Withdrawals
These endpoints manage the process of voluntarily exiting the validator set and withdrawing staked ETH.
| API Call | Method | Description |
|---|---|---|
| Generate exit message(s) | POST | Generates a presigned exit message for validators. |
| Broadcast exit message(s) | POST | Broadcasts the signed exit message to initiate validator exit. |
| Bulk withdraw Validators | POST | Initiates bulk withdrawal for multiple exited validators. |
| Generate validator withdrawal transaction | POST | Crafts a transaction payload to withdraw funds from a validator. |
| Generate validator consolidation transaction | POST | Crafts a transaction payload for consolidating validator funds. |
| Estimate validator exit times | POST | Provides an estimation for validator exit and withdrawal times. |
3. Data Retrieval and Status
These endpoints are used for fetching current information about stakes, validators, and the network.
| API Call | Method | Description |
|---|---|---|
| Get Stakes | GET | Retrieves a list of all your current stakes. |
| Get Stake details by stakeId | GET | Retrieves detailed information for a specific stake. |
| Get Validators | GET | Retrieves a list of ordered validators. |
| Get Stakes with validator counts by status | GET | Retrieves stakes grouped by the count of validators in various statuses. |
| Get deposit data for Stake | GET | Retrieves the deposit data required for a validator stake. |
| Get Validator queue | GET | Retrieves statistics on the Ethereum validator activation queue. |
| Get Validator beacon chain info | GET | Retrieves the latest beacon chain information for a validator. |
4. Reporting and Performance
These endpoints provide metrics, historical data, and dashboard summaries.
| API Call | Method | Description |
|---|---|---|
| Get Staking dashboard summary | GET | Retrieves a high-level summary for the staking dashboard. |
| Get Staking accounts summary | GET | Retrieves a summary of all staking accounts. |
| Get Validator daily rewards | GET | Retrieves the daily accrued rewards for a validator. |
| Get Validator daily performance | GET | Retrieves the daily performance metrics for a validator. |
| Get staking rewards chart data | GET | Retrieves data formatted for charting staking rewards history. |
| Get Validator income history | GET | Retrieves the historical income records for a validator. |