Lido V2

/getapr

Get the Lido staking APR on Ethereum.

GET https://api.expand.network/liquidstaking/getapr

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.

Sample Request

https://api.expand.network/liquidstaking/getapr?liquidStakingId=1

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "timeUnix": 1712751839,
        "apr": 3.36,
        "blockNumber": 19625206
    }
}

/getrewards

Get the stETH interactions by a specified user address along with the daily stETH rewards.

GET https://api.expand.network/liquidstaking/getrewards

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
address*	String	Public address of the user.
page	String	The page number that the user wants to fetch. By default, 1.

Sample Request

https://api.expand.network/liquidstaking/getrewards?address=0xf51F9dbB95B03f0DC60C79BC7dFEB958cb1C8962&page=1

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "events": [
            {
                "apr": "3.937496701524082809229480683079713",
                "block": "18634427",
                "blockTime": "1700742443",
                "id": "0x03f3622b45a9edbfe95325ff82295f5607bad59b0ad2c685b9466a9095ac61da",
                "logIndex": "10",
                "totalPooledEtherAfter": "9157899107759077846808314",
                "totalPooledEtherBefore": "9166748915742419188288274",
                "totalSharesAfter": "7979812024150962005298647",
                "totalSharesBefore": "7988385045435518208987747",
                "type": "reward",
                "reportShares": "18867868971733625201",
                "balance": "21653397335501660877",
                "rewards": "2335643397182351",
                "change": "2335643397182351",
                "currencyChange": "4.826179060422565701819216607798",
                "epochDays": "19684.519016203703703704",
                "epochFullDays": "19684"
            },
            {
                "apr": "4.055508196694252655350449732776334",
                "block": "18627274",
                "blockTime": "1700656079",
                "id": "0xd675c60b908931ab56b5fdabe6ef9e2c087c98d35d90fc1469bfa66767488628",
                "logIndex": "10",
                "totalPooledEtherAfter": "9102161623476534577713402",
                "totalPooledEtherBefore": "9107756642154064122216622",
                "totalSharesAfter": "7932100296676238065535304",
                "totalSharesBefore": "7937857964883158472876527",
                "type": "reward",
                "reportShares": "18867868971733625201",
                "balance": "21651061692104478526",
                "rewards": "2405378167906481",
                "change": "2405378167906481",
                "currencyChange": "4.6676294187476755809931606548492",
                "epochDays": "19683.51943287037037037",
                "epochFullDays": "19683"
            }
        ],
        "totals": {
            "ethRewards": "653197335501660878",
            "currencyRewards": "1173.1516994959593645694978037777253"
        },
        "averageApr": "4.30030827194990587",
        "ethToStEthRatio": 1.000684768587144,
        "stETHCurrencyPrice": {
            "eth": 0.9993157,
            "usd": 3084.04
        },
        "totalItems": 260
}

/getstake

Get the amount of stETH and wstETH staked on Lido by a specified address.

GET https://api.expand.network/liquidstaking/getstake

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
address*	String	Public address of the user.

Sample Request

https://api.expand.network/liquidstaking/getstake?address=0x1d33ab0aF40ee6e5f59C7D1362cb56D35b7A0909

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "stETH": "1",
        "wstETH": "0"
    }
}

/getwithdrawalrequests

Get all the withdrawal requests(NFT ids) made by a specified address.

GET https://api.expand.network/liquidstaking/getwithdrawalrequests

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
ownerAddress*	String	Public address of the user.

Sample Request

https://api.expand.network/liquidstaking/getwithdrawalrequests?ownerAddress=0x0AAEf336811136c176100092E24cEe3794389B19

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": [
        "7"
    ]
}

/getwithdrawalstatus

Get the status of a withdrawal request made by a specified address.

GET https://api.expand.network/liquidstaking/getwithdrawalstatus

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
requestId*	String	The token id of NFT , which is minted upon request, to claim the rewards.

Sample Request

https://api.expand.network/liquidstaking/getwithdrawalstatus?requestId=7

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "amountOfStETH": "10000000000000",
        "amountOfShares": "8895462062243",
        "owner": "0x0AAEf336811136c176100092E24cEe3794389B19",
        "timestamp": "1684163999",
        "isFinalized": true,
        "isClaimed": false
    }
}

/getprotocolapr

Get the Lido staking APR on Ethereum, for the past 7 days.

GET https://api.expand.network/liquidstaking/getprotocolapr

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.

Sample Request

https://api.expand.network/liquidstaking/getprotocolapr?liquidStakingId=1

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "aprs": [
            {
                "timeUnix": 1712492591,
                "apr": 3.041,
                "blockNumber": 19603793
            },
            {
                "timeUnix": 1712579075,
                "apr": 3.148,
                "blockNumber": 19610931
            },
            {
                "timeUnix": 1712665379,
                "apr": 3.22,
                "blockNumber": 19618058
            },
            {
                "timeUnix": 1712751839,
                "apr": 3.36,
                "blockNumber": 19625206
            },
            {
                "timeUnix": 1712838191,
                "apr": 3.45,
                "blockNumber": 19632355
            },
            {
                "timeUnix": 1712924531,
                "apr": 3.146,
                "blockNumber": 19639495
            },
            {
                "timeUnix": 1713011063,
                "apr": 4.31,
                "blockNumber": 19646630
            },
            {
                "timeUnix": 1713097271,
                "apr": 4.436,
                "blockNumber": 19653737
            }
        ],
        "smaApr": 3.513875
    }
}

/getallowance

Get the approved allowance amount set by the owner for the spender.

GET https://api.expand.network/liquidstaking/getallowance

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
owner*	String	Public address of the owner of token.
tokenAddress*	String	Token contract address.
spender*	String	Public address of the spender of token.

Sample Request

https://api.expand.network/liquidstaking/getallowance?owner=0x6427B4b028c4A1db5fb5dAf80C22e81115457230&liquidStakingId=1&tokenAddress=0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84&spender=0x6427B4b028c4A1db5fb5dAf80C22e81115457230

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "allowance": "999000000000000000000"
    }
}

/stake

Initiate a transaction to stake on Lido.

POST https://api.expand.network/liquidstaking/stake

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
referrer*	String	Referral address.
from*	String	Public address of the owner of this request.
value*	String	Amount of token to stake.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
gasPriority	String	low, medium, or high.

Sample Request

{
    "value": "1000000",
    "referrer": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84",
        "data": "0xa1903eab000000000000000000000000747b11e5aacef79cd78c78a8436946b00de30b97",
        "value": "1000000",
        "gas": "40000000"
    }
}

Sample Request

With gasPriority:

{
    "value": "1000000",
    "referrer": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "gasPriority": "medium"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84",
        "data": "0xa1903eab000000000000000000000000747b11e5aacef79cd78c78a8436946b00de30b97",
        "value": "1000000",
        "gas": "40000000",
        "gasPrice": "16257885700"
    }
}

/wrap

Initiate a transaction to wrap stETH to wstETH.

POST https://api.expand.network/liquidstaking/wrap

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
from*	String	Public address of the owner of token.
amount*	String	Number of tokens to wrap.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
gasPriority	String	low, medium, or high.

Sample Request

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "amount": "100000"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
        "data": "0xea598cb000000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "40000000"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "amount": "100000",
    "gasPriority": "medium"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
        "data": "0xea598cb000000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "40000000",
        "gasPrice": "12993920831"
    }
}

/unwrap

Initiate a transaction to unwrap wstETH to stETH.

POST https://api.expand.network/liquidstaking/unwrap

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
from*	String	Public address of the owner of token.
amount*	String	Number of tokens to unwrap.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
gasPriority	String	low, medium, or high.

Sample Request

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "amount": "100000"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
        "data": "0xde0e9a3e00000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "40000000"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "amount": "100000",
    "gasPriority": "high"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
        "data": "0xde0e9a3e00000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "40000000",
        "gasPrice": "20626619243"
    }
}

/increaseallowance

Initiate a transaction to increase the allowance of stETH or wstETH on the spender’s account.

POST https://api.expand.network/liquidstaking/increaseallowance

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
from*	String	Public address of the owner of this request.
tokenAddress*	String	Token contract address.
spender*	String	Address of spender.
addedValue*	String	Amount of tokens to increase allowance.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
gasPriority	String	low, medium, or high.

Sample Request

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "addedValue": "100000",
    "spender": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
    "tokenAddress": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
        "data": "0x395093510000000000000000000000007f39c581f595b53c5cb19bd0b3f8da6c935e2ca000000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "40000000"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "addedValue": "100000",
    "spender": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
    "tokenAddress": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
    "gasPriority": "high"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
        "data": "0x395093510000000000000000000000007f39c581f595b53c5cb19bd0b3f8da6c935e2ca000000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "40000000",
        "gasPrice": "20998483388"
    }
}

/decreaseallowance

Initiate a transaction to decrease the allowance of stETH or wstETH on the spender’s account.

POST https://api.expand.network/liquidstaking/decreaseallowance

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
from*	String	Public address of the owner of this request.
tokenAddress*	String	Token contract address.
spender*	String	Address of spender.
subtractedValue*	String	Amount of tokens to decrease allowance.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
gasPriority	String	low, medium, or high.

Sample Request

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "subtractedValue": "100000",
    "spender": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
    "tokenAddress": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
        "data": "0xa457c2d70000000000000000000000007f39c581f595b53c5cb19bd0b3f8da6c935e2ca000000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "40000000"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "subtractedValue": "100000",
    "spender": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
    "tokenAddress": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
    "gasPriority": "low"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x7f39C581F595B53c5cb19bD0b3f8dA6c935E2Ca0",
        "data": "0xa457c2d70000000000000000000000007f39c581f595b53c5cb19bd0b3f8da6c935e2ca000000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "40000000",
        "gasPrice": "14280979987"
    }
}

/approvewithdrawal

Initiate a transaction to approve the withdrawal request from a specified address.

POST https://api.expand.network/liquidstaking/approvewithdrawal

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
from*	String	Public address of the owner of this request.
amount*	String	Amount of tokens to approve withdrawal.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
gasPriority	String	low, medium, or high.

Sample Request

{
    "liquidStakingId": "1",
    "amount": "1000000",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84",
        "data": "0x095ea7b3000000000000000000000000889edc2edab5f40e902b864ad4d7ade8e412f9b100000000000000000000000000000000000000000000000000000000000f4240",
        "gas": "40000000",
        "value": "0"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "1",
    "amount": "1000000",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "gasPriority": "high"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84",
        "data": "0x095ea7b3000000000000000000000000889edc2edab5f40e902b864ad4d7ade8e412f9b100000000000000000000000000000000000000000000000000000000000f4240",
        "gas": "40000000",
        "value": "0",
        "gasPrice": "22981387448"
    }
}

/requestwithdrawal

Initiate a transaction to request a withdrawal on Lido.

POST https://api.expand.network/liquidstaking/requestwithdrawal

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
from*	String	Public address of the owner of this request.
amount*	String	Amount of tokens to request withdrawal.
ownerAddress*	String	Public address of the owner.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
gasPriority	String	low, medium, or high.

Sample Request

{
    "liquidStakingId": "1",
    "amount": "1000000",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "ownerAddress": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x889edC2eDab5f40e902b864aD4d7AdE8E412F9B1",
        "data": "0xd66810420000000000000000000000000000000000000000000000000000000000000040000000000000000000000000747b11e5aacef79cd78c78a8436946b00de30b97000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000f4240",
        "gas": "40000000",
        "value": "0"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "1",
    "amount": "1000000",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "ownerAddress": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "gasPriority": "low"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x889edC2eDab5f40e902b864aD4d7AdE8E412F9B1",
        "data": "0xd66810420000000000000000000000000000000000000000000000000000000000000040000000000000000000000000747b11e5aacef79cd78c78a8436946b00de30b97000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000f4240",
        "gas": "40000000",
        "value": "0",
        "gasPrice": "12312495875"
    }
}

/claim

Initiate a transaction to burn the NFT, which is minted upon request, and to claim the rewards.

POST https://api.expand.network/liquidstaking/claim

Query Parameters

Name	Type	Description
rpc	String	Remote procedural call URL.
liquidStakingId	String	Refer to the Liquid Staking Id page for details.
from*	String	Public address of the owner of this request.
requestId*	String	The token id of NFT , which is minted upon request, to claim the rewards.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
gasPriority	String	low, medium, or high.

Sample Request

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "requestId": "7"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x889edC2eDab5f40e902b864aD4d7AdE8E412F9B1",
        "data": "0xf84444360000000000000000000000000000000000000000000000000000000000000007",
        "gas": "40000000",
        "value": "0"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "requestId": "7",
    "gasPriority": "high"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0x889edC2eDab5f40e902b864aD4d7AdE8E412F9B1",
        "data": "0xf84444360000000000000000000000000000000000000000000000000000000000000007",
        "gas": "40000000",
        "value": "0",
        "gasPrice": "22170891345"
    }
}