Supported Chains
Available on Ethereum, Binance and Polygon
Available Endpoints:
Click on the endpoint to jump to the section with full details
GET
- Get the Stader staking APR.
GET
- Get the initial staked amount and current staked value by a specified user address.
GET
-Get the stake amount for a particular address.
GET
- Retrieves all withdrawal requests made by a specified address.
GET
- Get the status of a withdrawal request made by a specified address.
GET
- Get the approved allowance amount set by the owner for the spender.
POST
- Initiate a transaction to stake on Stader protocol.
POST
- Initiate a withdrawal request on Stader.
POST
- Initiate a transaction to approve the withdrawal request from a specified address.
POST
- Initiate a transaction to claim staked ETH after a withdrawal request.
POST
- Initiate a transaction to decrease the allowance of staked token on the spender’s account.
POST
- Initiate a transaction to increase the allowance of staked token on the spender’s account.
Liquid Staking IDs
Many endpoints have a parameter where you can provide a Liquid Staking ID.
Below is a list of Liquid Staking IDs related to Stader. Please see the Liquid Staking ID page for a complete Liquid Staking ID list and more information.
Liquid Staking Name
Chain
Liquid Staking ID
Endpoint Details
/getapr
Get the Stader staking APR.
GET
https://api.expand.network/liquidstaking/getapr
Query Parameters
Remote procedural call URL.
Sample Request Sample Response
Copy https://api.expand.network/liquidstaking/getapr?liquidStakingId=2
Copy {
"status": 200,
"msg": "success",
"data": {
"timeUnix": "1722397871",
"apr": "3.04",
"blockNumber": "20423959"
}
}
/getrewards
Get the initial staked amount and current staked value by a specified user address.
GET
https://api.expand.network/liquidstaking/getrewards
Query Parameters
Remote procedural call URL.
Public address of the user.
Sample Request Sample Response
Copy https://api.expand.network/liquidstaking/getrewards?address=0x40B38765696e3d5d8d9d834D8AaD4bB6e418E489&liquidStakingId=2
Copy {
"status": 200,
"msg": "success",
"data": {
"stakedAmount": "0",
"stakeValue": "0"
}
}
/getstake
Get the stake amount for a particular address.
GET
https://api.expand.network/liquidstaking/getstake
Query Parameters
Remote procedural call URL.
Public address of the user.
Sample Request Sample Response
Copy https://api.expand.network/liquidstaking/getstake?address=0xAB06ef1d486721a83C94B30B58ab9E28c5a1049D&liquidStakingId=2
Copy {
"status": 200,
"msg": "success",
"data": {
"ETHx": "2878342440"
}
}
/getwithdrawalrequests
Get all the withdrawal requests(NFT ids) made by a specified address.
GET
https://api.expand.network/liquidstaking/getwithdrawalrequests
Query Parameters
Remote procedural call URL.
Public address of the user.
Sample Request Sample Response
Copy https://api.expand.network/liquidstaking/getwithdrawalrequests?liquidStakingId=2&address=0x2Dce7632866E1C795e5644d30173d18b1DfAa71a
Copy {
"status": 200,
"msg": "success",
"data": [
"2130"
]
}
/getwithdrawalstatus
Get the status of a withdrawal request made by a specified address.
GET
https://api.expand.network/liquidstaking/getwithdrawalstatus
Query Parameters
Remote procedural call URL.
The token id of NFT , which is minted upon request, to claim the rewards.
Sample Request Sample Response
Copy https://api.expand.network/liquidstaking/getwithdrawalstatus?liquidStakingId=2&requestId=1973&address=0xAB06ef1d486721a83C94B30B58ab9E28c5a1049D
Copy {
"status": 200,
"msg": "success",
"data": {
"amountOfETH": "91233891673519371",
"isFinalized": "91233891673519371"
}
}
/getallowance
Get the approved allowance amount set by the owner for the spender.
GET
https://api.expand.network/liquidstaking/getallowance
Query Parameters
Remote procedural call URL.
Public address of the owner of token.
Public address of the spender of token.
Sample Request Sample Response
Copy https://api.expand.network/liquidstaking/getallowance?owner=0x49eb67E250513FAb9506190ed023F12A214D1a74&liquidStakingId=2&tokenAddress=0xA35b1B31Ce002FBF2058D22F30f95D405200A15b&spender=0x9f0491b32dbce587c50c4c43ab303b06478193a7
Copy {
"status": 200,
"msg": "success",
"data": {
"allowance": "53880000000000000"
}
}
/stake
Initiate a transaction to stake on Stader.
POST
https://api.expand.network/liquidstaking/stake
Request Body
Remote procedural call URL.
Public address of the owner of this request.
Amount of token to stake.
Maximum gas limit provided by the sender, for the transaction.
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 Sample Response
Copy {
"amount": "1000000000000000000",
"liquidStakingId": "2",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "40000"
}
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"to": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
"data": "0xf340fa010000000000000000000000009f0ff6ecef671200447604c19d72228a170bc21c",
"value": "1000000000000000000",
"gas": "40000",
"referenceId": "b588227ce2694337a48dad29a463bb8e"
}
}
Sample Request Sample Response
With gasPriority:
Copy {
"amount": "1000000000000000000",
"liquidStakingId": "2",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "40000",
"gasPriority": "low"
}
With gasPriority:
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"to": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
"data": "0xf340fa010000000000000000000000009f0ff6ecef671200447604c19d72228a170bc21c",
"value": "1000000000000000000",
"gas": "40000",
"gasPrice": "1879217982",
"referenceId": "b588227ce2694337a48dad29a463bb8e"
}
}
Sample Request Sampe Response
With ofacCheck:
Copy {
"amount": "1000000000000000000",
"liquidStakingId": "2",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "40000",
"ofacCheck": true
}
With ofacCheck:
Copy {
"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 staked token on the spender’s account.
POST
https://api.expand.network/liquidstaking/increaseallowance
Request Body
Remote procedural call URL.
Public address of the owner of this request.
Amount of tokens to increase allowance.
Maximum gas limit provided by the sender, for the transaction.
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 Sample Response
Copy {
"liquidStakingId": "2",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "400000",
"addedAmount": "100000",
"spender": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
"tokenAddress": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
"gasPriority":"low"
}
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
"data": "0x39509351000000000000000000000000cf5ea1b38380f6af39068375516daf40ed70d29900000000000000000000000000000000000000000000000000000000000186a0",
"value": "0",
"gas": "400000",
"referenceId": "81fe2de697a84044b5c12a50981a2a80"
}
}
Sample Request Sample Response
With gasPriority:
Copy {
"liquidStakingId": "2",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "400000",
"addedAmount": "100000",
"spender": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
"tokenAddress": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
"gasPriority":"low"
}
With gasPriority:
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
"data": "0x39509351000000000000000000000000cf5ea1b38380f6af39068375516daf40ed70d29900000000000000000000000000000000000000000000000000000000000186a0",
"value": "0",
"gas": "400000",
"gasPrice": "1799425943",
"referenceId": "81fe2de697a84044b5c12a50981a2a80"
}
}
Sample Request Sampe Response
With ofacCheck:
Copy {
"liquidStakingId": "2",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "400000",
"addedAmount": "100000",
"spender": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
"tokenAddress": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
"gasPriority":"low",
"ofacCheck": true
}
With ofacCheck:
Copy {
"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 staked token on the spender’s account.
POST
https://api.expand.network/liquidstaking/decreaseallowance
Request Body
Remote procedural call URL.
Public address of the owner of this request.
Amount of tokens to decrease allowance.
Maximum gas limit provided by the sender, for the transaction.
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 Sample Response
Copy {
"liquidStakingId": "2",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "400000",
"subtractedAmount": "100000",
"spender": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
"tokenAddress": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b"
}
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
"data": "0xa457c2d7000000000000000000000000cf5ea1b38380f6af39068375516daf40ed70d29900000000000000000000000000000000000000000000000000000000000186a0",
"value": "0",
"gas": "400000",
"referenceId": "c86772e57a054784b95f30660b804e51"
}
}
Sample Request Sample Response
With gasPriority:
Copy {
"liquidStakingId": "2",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "400000",
"subtractedAmount": "100000",
"spender": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
"tokenAddress": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
"gasPriority":"low"
}
With gasPriority:
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
"data": "0xa457c2d7000000000000000000000000cf5ea1b38380f6af39068375516daf40ed70d29900000000000000000000000000000000000000000000000000000000000186a0",
"value": "0",
"gas": "400000",
"gasPrice": "1874993877",
"referenceId": "ab5b367e23984257a823b1b9d77fef59"
}
}
Sample Request Sampe Response
With ofacCheck:
Copy {
"liquidStakingId": "2",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "400000",
"subtractedAmount": "100000",
"spender": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
"tokenAddress": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
"gasPriority":"low",
"ofacCheck": true
}
With ofacCheck:
Copy {
"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
Remote procedural call URL.
Public address of the owner of this request.
Amount of tokens to approve withdrawal.
Maximum gas limit provided by the sender, for the transaction.
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 Sample Response
Copy {
"liquidStakingId": "2",
"amount": "10000",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"gas": "400000"
}
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
"data": "0x095ea7b30000000000000000000000009f0491b32dbce587c50c4c43ab303b06478193a70000000000000000000000000000000000000000000000000000000000002710",
"gas": "400000",
"value": "0",
"referenceId": "4584e740c5c54f0ca0e670057f097751"
}
}
Sample Request Sample Response
With gasPriority:
Copy {
"liquidStakingId": "2",
"amount": "10000",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"gas": "400000",
"gasPriority": "low"
}
With gasPriority:
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
"data": "0x095ea7b30000000000000000000000009f0491b32dbce587c50c4c43ab303b06478193a70000000000000000000000000000000000000000000000000000000000002710",
"gas": "400000",
"value": "0",
"gasPrice": "1720241828",
"referenceId": "c12126c7d7a14ea580938d2400825f10"
}
}
Sample Request Sampe Response
With ofacCheck:
Copy {
"liquidStakingId": "2",
"amount": "10000",
"from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
"gas": "400000",
"gasPriority": "low",
"ofacCheck": true
}
With ofacCheck:
Copy {
"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 Stader.
POST
https://api.expand.network/liquidstaking/requestwithdrawal
Request Body
Remote procedural call URL.
Public address of the owner of this request.
Amount of tokens to request withdrawal.
Public address of the owner.
Maximum gas limit provided by the sender, for the transaction.
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 Sample Response
Copy {
"liquidStakingId": "2",
"amount": "1000000000000000000",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "400000"
}
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"to": "0x9F0491B32DBce587c50c4C43AB303b06478193A7",
"data": "0xccc143b80000000000000000000000000000000000000000000000000de0b6b3a76400000000000000000000000000009f0ff6ecef671200447604c19d72228a170bc21c",
"gas": "400000",
"value": "0",
"referenceId": "8ff73d871d134fec8fb8bcdd1ae5394e"
}
}
Sample Request Sample Response
With gasPriority:
Copy {
"liquidStakingId": "2",
"amount": "1000000000000000000",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "400000",
"gasPriority": "low"
}
With gasPriority:
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"to": "0x9F0491B32DBce587c50c4C43AB303b06478193A7",
"data": "0xccc143b80000000000000000000000000000000000000000000000000de0b6b3a76400000000000000000000000000009f0ff6ecef671200447604c19d72228a170bc21c",
"gas": "400000",
"value": "0",
"gasPrice": "2122766567",
"referenceId": "8ff73d871d134fec8fb8bcdd1ae5394e"
}
}
Sample Request Sampe Response
With ofacCheck:
Copy {
"liquidStakingId": "2",
"amount": "1000000000000000000",
"from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
"gas": "400000",
"gasPriority": "low",
"ofacCheck": true
}
With ofacCheck:
Copy {
"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
Remote procedural call URL.
Public address of the owner of this request.
The token id of NFT , which is minted upon request, to claim the rewards.
Maximum gas limit provided by the sender, for the transaction.
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 Sample Response
Copy {
"liquidStakingId": "2",
"requestId": "2130",
"from": "0x2Dce7632866E1C795e5644d30173d18b1DfAa71a",
"gas": "400000"
}
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x2Dce7632866E1C795e5644d30173d18b1DfAa71a",
"to": "0x9F0491B32DBce587c50c4C43AB303b06478193A7",
"data": "0x379607f50000000000000000000000000000000000000000000000000000000000000852",
"gas": "400000",
"value": "0",
"referenceId": "c4d68ead57b444fba7c855f6643e8a73"
}
}
Sample Request Sample Response
With gasPriority:
Copy {
"liquidStakingId": "2",
"requestId": "2130",
"from": "0x2Dce7632866E1C795e5644d30173d18b1DfAa71a",
"gasPriority": "low",
"gas": "400000"
}
With gasPriority:
Copy {
"status": 200,
"msg": "success",
"data": {
"chainId": "1",
"from": "0x2Dce7632866E1C795e5644d30173d18b1DfAa71a",
"to": "0x9F0491B32DBce587c50c4C43AB303b06478193A7",
"data": "0x379607f50000000000000000000000000000000000000000000000000000000000000852",
"gas": "400000",
"value": "0",
"gasPrice": "2072451432",
"referenceId": "c4d68ead57b444fba7c855f6643e8a73"
}
}
Sample Request Sampe Response
With ofacCheck:
Copy {
"liquidStakingId": "2",
"requestId": "2130",
"from": "0x2Dce7632866E1C795e5644d30173d18b1DfAa71a",
"gasPriority": "low",
"gas": "400000",
"ofacCheck": true
}
With ofacCheck:
Copy {
"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"
}
}
Error Handling Details
Indicates the request is invalid or missing the required parameters. The msg field will contain details about the error.
Indicates the request lacks valid authentication credentials (API key). Ensure that you provide a valid API key in the request headers.
Indicates that the specified endpoint or resource does not exist.
Indicates an internal server error.