:::info Lido APIs are strictly for read-only access :::
Here you can find various Lido APIs which you can integrate in your app or website:
API provides Ethereum and Lido staking APR, which include:
This APR value is based on Simple Moving Average of APR values over a period of 7 days.
https://eth-api.lido.fi/v1/protocol/steth/apr/sma
Response schema and examples are available in the Swagger API documentation
https://eth-api-holesky.testnet.fi/v1/protocol/steth/apr/sma
The latest staking APR value. For Lido V1, we collected APR values by periodically fetching oracle report events. For the V2 version, the value is calculated based on rebase events.
V2 APR calculation:
// Emits when token rebased (total supply and/or total shares were changed)
event TokenRebased(
uint256 indexed reportTimestamp,
uint256 timeElapsed,
uint256 preTotalShares,
uint256 preTotalEther, /* preTotalPooledEther */
uint256 postTotalShares,
uint256 postTotalEther, /* postTotalPooledEther */
uint256 sharesMintedAsFees /* fee part included in `postTotalShares` */
);
preShareRate = preTotalEther * 1e27 / preTotalShares
postShareRate = postTotalEther * 1e27 / postTotalShares
userAPR =
secondsInYear * (
(postShareRate - preShareRate) / preShareRate
) / timeElapsed
https://eth-api.lido.fi/v1/protocol/steth/apr/last
Response schema and examples are available in the Swagger API documentation
https://eth-api-holesky.testnet.fi/v1/protocol/steth/apr/last
Reward History Backend provides an API which returns all stETH interactions by an address and calculates its daily stETH rewards.
Currently, there's just one endpoint (/
):
https://reward-history-backend.lido.fi/?address=0x12345
Response schema and examples are available in the Swagger API documentation
The only required query parameter is address
.
Optional Parameters:
currency
: USD/EUR/GBP - Fiat currency in which to display stETH denominated in fiat. USD by default.archiveRate
: true/false - Use an exchange rate close to the transaction time when calculating currency values instead of the current one. true by default.onlyRewards
: true/false - Include only rewards without transfers or stakings. false by default.sort
: asc/desc - Sort of transactions by blockTime. desc by default.skip
: number - Amount of data items to skip.limit
: number - Maximum amount of data items to respond with.
skip
and limit
params are used for pagination, e.g.:
skip: 0, limit: 100 = 1 page
skip: 100, limit: 100 = 2 page
skip: 200, limit: 100 = 3 page
Reward History Backend is also available on Holešky:
http://reward-history-backend-holesky.testnet.fi/?address=0x12345
Response schema and examples are available in the Swagger API documentation
The Withdrawals API service offers an utility for estimating the waiting time for withdrawals within the Lido on Ethereum protocol. The service is helpful for stakers, providing insights from the moment of withdrawal request placement to its finalization when the request becomes claimable.
See the detailed explanation.
- Estimation before request: users can estimate the waiting time before placing a withdrawal request.
- Tracking the existing request: users can track the estimated waiting time for the already placed request.
https://wq-api.lido.fi/v2/request-time?ids=1&ids=2
Response schema and examples are available in the Swagger API documentation
https://wq-api.lido.fi/v2/request-time/calculate
https://wq-api.lido.fi/v2/request-time/calculate?amount=32
Response schema and examples are available in the Swagger API documentation
https://wq-api-holesky.testnet.fi/v2/request-time?ids=1&ids=2
Response schema and examples are available in the Swagger API documentation