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": "1716812675",
        "apr": "3.103",
        "blockNumber": "19961193"
    }
}

/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.
address*	String	Public address of the user.

Sample Request

https://api.expand.network/liquidstaking/getwithdrawalrequests?address=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

Request Body

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 token to stake.
gas*	String	Maximum gas limit provided by the sender, for the transaction.
gasPriority	String	low, medium, or high.
ofacCheck	Boolean	if true,provides insights of the contract and tokens involved in the transaction. By Default, false Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet

Sample Request

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

Sample Response

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

Sample Request

With gasPriority:

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

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
        "to": "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84",
        "data": "0xa1903eab000000000000000000000000558d7be6092ca91da26521ac25b982d883218e2d",
        "value": "1000000",
        "gas": "40000000",
        "gasPrice": "7144947666",
        "referenceId": "8c857e977f454437852cd07f776bd8f1"
    }
}

Sample Request

With ofacCheck:

{
    "amount": "1000000",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "gasPriority": "medium",
    "ofacCheck": true
}

Sampe Response

With ofacCheck:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07",
        "to": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
        "value": "0",
        "gas": "40000",
        "data": "0xede4edd00000000000000000000000005d3a536e4d6dbd6114cc1ead35777bab948e3643",
        "gasPrice": "499498318",
        "estimationCheck": true,
        "insights": {
            "asset": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            },
            "to": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            }
        },
        "referenceId": "e9bfe6229a844227a92a2f6669aa1da0"
    }
}

/wrap

Initiate a transaction to wrap stETH to wstETH.

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

Request Body

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.
ofacCheck	Boolean	if true,provides insights of the contract and tokens involved in the transaction. By Default, false Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet

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",
        "referenceId": "03d97934beaa4f7faafbf31f85f2cea4"
    }
}

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": "7195206119",
        "referenceId": "32adf74c3dcf43a480c591ff8f58453a"
    }
}

Sample Request

With ofacCheck:

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

Sampe Response

With ofacCheck:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07",
        "to": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
        "value": "0",
        "gas": "40000",
        "data": "0xede4edd00000000000000000000000005d3a536e4d6dbd6114cc1ead35777bab948e3643",
        "gasPrice": "499498318",
        "estimationCheck": true,
        "insights": {
            "asset": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            },
            "to": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            }
        },
        "referenceId": "e9bfe6229a844227a92a2f6669aa1da0"
    }
}

/unwrap

Initiate a transaction to unwrap wstETH to stETH.

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

Request Body

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.
ofacCheck	Boolean	if true,provides insights of the contract and tokens involved in the transaction. By Default, false Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet

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",
        "referenceId": "a868769848d44f3fb862c1b476ae45a8"
    }
}

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": "8350896741",
        "referenceId": "70dfa4fababe465da77b16121aeb99b0"
    }
}

Sample Request

With ofacCheck:

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

Sampe Response

With ofacCheck:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07",
        "to": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
        "value": "0",
        "gas": "40000",
        "data": "0xede4edd00000000000000000000000005d3a536e4d6dbd6114cc1ead35777bab948e3643",
        "gasPrice": "499498318",
        "estimationCheck": true,
        "insights": {
            "asset": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            },
            "to": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            }
        },
        "referenceId": "e9bfe6229a844227a92a2f6669aa1da0"
    }
}

/increaseallowance

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

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

Request Body

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.
addedAmount*	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.
ofacCheck	Boolean	if true,provides insights of the contract and tokens involved in the transaction. By Default, false Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet

Sample Request

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

Sample Response

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

Sample Request

With gasPriority:

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "addedAmount": "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": "8327301426",
        "referenceId": "413943076da94d65afa716cec441b14e"
    }
}

Sample Request

With ofacCheck:

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

Sampe Response

With ofacCheck:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07",
        "to": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
        "value": "0",
        "gas": "40000",
        "data": "0xede4edd00000000000000000000000005d3a536e4d6dbd6114cc1ead35777bab948e3643",
        "gasPrice": "499498318",
        "estimationCheck": true,
        "insights": {
            "asset": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            },
            "to": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            }
        },
        "referenceId": "e9bfe6229a844227a92a2f6669aa1da0"
    }
}

/decreaseallowance

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

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

Request Body

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.
subtractedAmount*	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.
ofacCheck	Boolean	if true,provides insights of the contract and tokens involved in the transaction. By Default, false Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet

Sample Request

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

Sample Response

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

Sample Request

With gasPriority:

{
    "liquidStakingId": "1",
    "from": "0x747b11E5AaCeF79cd78C78a8436946b00dE30b97",
    "gas": "40000000",
    "subtractedAmount": "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": "5468261957",
        "referenceId": "68e91de79a0f4493b7eb8c0cb0de1c99"
    }
}

Sample Request

With ofacCheck:

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

Sampe Response

With ofacCheck:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07",
        "to": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
        "value": "0",
        "gas": "40000",
        "data": "0xede4edd00000000000000000000000005d3a536e4d6dbd6114cc1ead35777bab948e3643",
        "gasPrice": "499498318",
        "estimationCheck": true,
        "insights": {
            "asset": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            },
            "to": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            }
        },
        "referenceId": "e9bfe6229a844227a92a2f6669aa1da0"
    }
}

/approvewithdrawal

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

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

Request Body

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.
ofacCheck	Boolean	if true,provides insights of the contract and tokens involved in the transaction. By Default, false Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet

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",
        "referenceId": "150082533644414dba28249a26f30082"
    }
}

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": "8180907297",
        "referenceId": "59bcdc674df540778575a933cacb2175"
    }
}

Sample Request

With ofacCheck:

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

Sampe Response

With ofacCheck:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07",
        "to": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
        "value": "0",
        "gas": "40000",
        "data": "0xede4edd00000000000000000000000005d3a536e4d6dbd6114cc1ead35777bab948e3643",
        "gasPrice": "499498318",
        "estimationCheck": true,
        "insights": {
            "asset": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            },
            "to": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            }
        },
        "referenceId": "e9bfe6229a844227a92a2f6669aa1da0"
    }
}

/requestwithdrawal

Initiate a transaction to request a withdrawal on Lido.

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

Request Body

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.
ofacCheck	Boolean	if true,provides insights of the contract and tokens involved in the transaction. By Default, false Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet

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",
        "referenceId": "d3a79bcfd6ce4cdea13dfed88975ced7"
    }
}

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": "5362720113",
        "referenceId": "8aa2c8ed9d204f0d888fb0c5dab3a75c"
    }
}

Sample Request

With ofacCheck:

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

Sampe Response

With ofacCheck:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07",
        "to": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
        "value": "0",
        "gas": "40000",
        "data": "0xede4edd00000000000000000000000005d3a536e4d6dbd6114cc1ead35777bab948e3643",
        "gasPrice": "499498318",
        "estimationCheck": true,
        "insights": {
            "asset": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            },
            "to": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            }
        },
        "referenceId": "e9bfe6229a844227a92a2f6669aa1da0"
    }
}

/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

Request Body

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.
ofacCheck	Boolean	if true,provides insights of the contract and tokens involved in the transaction. By Default, false Available on Ethereum, Polygon, BSC, Avalanche, Arbitrum and Optimism Mainnet

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",
        "referenceId": "e7f0f8da54594cc98e5c8229e2543903"
    }
}

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": "7829348729",
        "referenceId": "219dd43d95de4831a50668d0fab8f125"
    }
}

Sample Request

With ofacCheck:

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

Sampe Response

With ofacCheck:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xfAE7D9854995E28BEB1B1da864ee2A1E2EC17f07",
        "to": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
        "value": "0",
        "gas": "40000",
        "data": "0xede4edd00000000000000000000000005d3a536e4d6dbd6114cc1ead35777bab948e3643",
        "gasPrice": "499498318",
        "estimationCheck": true,
        "insights": {
            "asset": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            },
            "to": {
                "issues": [],
                "verdict": {
                    "code": 0,
                    "label": "NO_ISSUES"
                }
            }
        },
        "referenceId": "e9bfe6229a844227a92a2f6669aa1da0"
    }
}