Supported Chains
Available on Ethereum, Binance and Polygon
Available Endpoints:
Click on the endpoint to jump to the section with full details
/ getapr GET
- Get the Stader staking APR.
/getrewards GET
- Get the initial staked amount and current staked value by a specified user address.
/getstake GET
-Get the stake amount for a particular address.
/ getallowance GET
- Get the approved allowance amount set by the owner for the spender.
/Stake POST
- Initiate a transaction to stake on Stader protocol.
/ approvewithdrawal POST
- Initiate a transaction to approve the withdrawal request from a specified address.
/claim POST
- Initiate a transaction to claim staked ETH after a withdrawal request.
/ decreaseallowance POST
- Initiate a transaction to decrease the allowance of staked token on the spender’s account.
/ increaseallowance POST
- Initiate a transaction to increase the allowance of staked token on the spender’s account.
Also see Error Handling Details
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"
}
}
back to top
/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"
}
}
back to top
/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"
}
}
back to top
/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"
]
}
back to top
/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"
}
}
back to top
/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"
}
}
back to top
/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"
}
}
back to top
/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"
}
}
back to top
/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"
}
}
back to top
/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"
}
}
back to top
/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"
}
}
back to top
/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"
}
}
back to top
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.
back to top