Endpoints
API Usage
Once you already have access to the Staking API with a validated user and existing apikeys you can start using this service.
API Reference docs
You can check the Staking API Reference here:
- Rendered doc page.
- Staking OpenApi
Authentication
In order to use staking api related endpoints you need to include your API KEY
Heads up! To obtain a valid API key required for authentication, please refer to the Authentication > Auth section of the documentation.
Header:
| Name | Description | Example value | Required |
|---|---|---|---|
X-API-KEY | Your api key value | <API_KEY_VALUE> | ✅ |
X-NETWORK | Blockchain network/chain identifier | 1 | ⚪ |
X-NETWORK header
Set the X-NETWORK header to the Stakewise chain you want to target.
Supported values: 1 (Ethereum Mainnet) and 560048 (Ethereum Hoodi).
When omitted the API falls back to the default Stakewise network configured for your account.
List available networks
Use this helper endpoint to discover which Stakewise networks are currently enabled for your API key.
- Endpoint:
/api/v1/ethereum/stakewise/networks
Response payload fields:
| Field | Description |
|---|---|
name | Internal blockchain entry name |
type | Blockchain type string (always ETHEREUM) |
chain_id | Chain identifier such as 1 or 560048 |
is_default | true when the network is used as fallback |
Stake into stakewise vault
Craft a stake transaction:
- Endpoint:
/api/v1/ethereum/stakewise/action/stake
Description
This endpoint will craft a stake transaction ready to be signed.
Request body parameters
Returned
StakewiseStakingActionResponseDto
Unstake action
Craft a unstake transaction
Description
This endpoint will build an "enter exit queue" unstake transaction ready to be signed. The exited assets needs to mature for a given period before there are claimable
Request param
Returned
StakewiseStakingActionResponseDto
Withdraw action
Craft a withdraw transaction
Description
Once the assets in queue are ready to be claimable you can claim them. This action will craft a withdraw transaction of the withdrawable assets.
Returned
StakewiseStakingActionResponseDto
Prepare action
Gathers signature and unsigned tx:
Description
Prepare a signed transaction by gathering the provided signatures with the unsigned transaction hex string:
Request body parameters
Returned
Broadcast action
Broadcast a signed transaction
Description
Broadcast a signed transaction. Usually you will brodcast the signed transaction returned in prepare previous step:
Request body parameters
Returned
Historic
Get stakewise actions history for the given address
Description
Get stakewise actions history for the given address. It will return all historic actions of different kind of actions.
Request parameters
At url param you will need to pass the address you want to retrieve actions from
Returned
Array of StakewiseGetActionResponseDto
Stake balance
Get stakewise stake balance for the given address
Description
Get stakewise stake balance for the given address.
Request parameters
At url param you will need to pass the address you want to retrieve actions from
Returned
Array of StakewiseGetStakeBalanceResponseDto
Exited balance
Get stakewise exited balance for the given address
Description
Get stakewise exited balance for the given address.
Request parameters
At url param you will need to pass the address you want to retrieve actions from
Returned
Array of StakewiseGetExitedBalanceResponseDto
Vault info
Get stakewise vault info such as APY and balance for the current time
- Endpoint:
/api/v1/ethereum/stakewise/vault
Description
Get vault details, as current APY
Returned
Array of StakewiseGetVaultResponseDto
User Stats
Get user stats for stakewise vault for N days
Description
Get vault details, as current APY
Returned
Array of StakewiseGetUserStatsResponseDto