Stader

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.

• /getwithdrawalrequests GET - Retrieves all withdrawal requests made by a specified address.

• /getwithdrawalstatusGET - Get the status of a withdrawal request made by a specified address.

• /getallowanceGET - Get the approved allowance amount set by the owner for the spender.

• /Stake POST - Initiate a transaction to stake on Stader protocol.

• /requestwithdrawal POST - Initiate a withdrawal request on Stader.

• /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
Stader	Ethereum	2
Stader	Binance	56
Stader	Polygon	137
Stader	Binance Testnet	97

Endpoint Details

/getapr

Get the Stader staking APR.

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=2

Sample Response

{
    "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

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/getrewards?address=0x40B38765696e3d5d8d9d834D8AaD4bB6e418E489&liquidStakingId=2

Sample Response

{
    "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

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=0xAB06ef1d486721a83C94B30B58ab9E28c5a1049D&liquidStakingId=2

Sample Response

{
    "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

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?liquidStakingId=2&address=0x2Dce7632866E1C795e5644d30173d18b1DfAa71a

Sample Response

{
    "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

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

Sample Request

https://api.expand.network/liquidstaking/getwithdrawalstatus?liquidStakingId=2&requestId=1973&address=0xAB06ef1d486721a83C94B30B58ab9E28c5a1049D

Sample Response

{
    "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

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=0x49eb67E250513FAb9506190ed023F12A214D1a74&liquidStakingId=2&tokenAddress=0xA35b1B31Ce002FBF2058D22F30f95D405200A15b&spender=0x9f0491b32dbce587c50c4c43ab303b06478193a7

Sample Response

{
    "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

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.

Sample Request

{
    "amount": "1000000000000000000",
    "liquidStakingId": "2",
    "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
    "gas": "40000"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
        "to": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
        "data": "0xf340fa010000000000000000000000009f0ff6ecef671200447604c19d72228a170bc21c",
        "value": "1000000000000000000",
        "gas": "40000",
        "referenceId": "b588227ce2694337a48dad29a463bb8e"
    }
}

Sample Request

With gasPriority:

{
    "amount": "1000000000000000000",
    "liquidStakingId": "2",
    "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
    "gas": "40000",
    "gasPriority": "low"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
        "to": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
        "data": "0xf340fa010000000000000000000000009f0ff6ecef671200447604c19d72228a170bc21c",
        "value": "1000000000000000000",
        "gas": "40000",
        "gasPrice": "1879217982",
        "referenceId": "b588227ce2694337a48dad29a463bb8e"
    }
}

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

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.

Sample Request

{
    "liquidStakingId": "2",
    "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
    "gas": "400000",
    "addedAmount": "100000",
    "spender": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
    "tokenAddress": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
    "gasPriority":"low"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
        "to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
        "data": "0x39509351000000000000000000000000cf5ea1b38380f6af39068375516daf40ed70d29900000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "400000",
        "referenceId": "81fe2de697a84044b5c12a50981a2a80"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "2",
    "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
    "gas": "400000",
    "addedAmount": "100000",
    "spender": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
    "tokenAddress": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
    "gasPriority":"low"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
        "to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
        "data": "0x39509351000000000000000000000000cf5ea1b38380f6af39068375516daf40ed70d29900000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "400000",
        "gasPrice": "1799425943",
        "referenceId": "81fe2de697a84044b5c12a50981a2a80"
    }
}

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

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.

Sample Request

{
    "liquidStakingId": "2",
    "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
    "gas": "400000",
    "subtractedAmount": "100000",
    "spender": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
    "tokenAddress": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
        "to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
        "data": "0xa457c2d7000000000000000000000000cf5ea1b38380f6af39068375516daf40ed70d29900000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "400000",
        "referenceId": "c86772e57a054784b95f30660b804e51"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "2",
    "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
    "gas": "400000",
    "subtractedAmount": "100000",
    "spender": "0xcf5EA1b38380f6aF39068375516Daf40Ed70D299",
    "tokenAddress": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
    "gasPriority":"low"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
        "to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
        "data": "0xa457c2d7000000000000000000000000cf5ea1b38380f6af39068375516daf40ed70d29900000000000000000000000000000000000000000000000000000000000186a0",
        "value": "0",
        "gas": "400000",
        "gasPrice": "1874993877",
        "referenceId": "ab5b367e23984257a823b1b9d77fef59"
    }
}

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

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": "2",
    "amount": "10000",
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "gas": "400000"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
        "to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
        "data": "0x095ea7b30000000000000000000000009f0491b32dbce587c50c4c43ab303b06478193a70000000000000000000000000000000000000000000000000000000000002710",
        "gas": "400000",
        "value": "0",
        "referenceId": "4584e740c5c54f0ca0e670057f097751"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "2",
    "amount": "10000",
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "gas": "400000",
    "gasPriority": "low"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
        "to": "0xA35b1B31Ce002FBF2058D22F30f95D405200A15b",
        "data": "0x095ea7b30000000000000000000000009f0491b32dbce587c50c4c43ab303b06478193a70000000000000000000000000000000000000000000000000000000000002710",
        "gas": "400000",
        "value": "0",
        "gasPrice": "1720241828",
        "referenceId": "c12126c7d7a14ea580938d2400825f10"
    }
}

back to top

/requestwithdrawal

Initiate a transaction to request a withdrawal on Stader.

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.

Sample Request

{
    "liquidStakingId": "2",
    "amount": "1000000000000000000",
    "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
    "gas": "400000"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
        "to": "0x9F0491B32DBce587c50c4C43AB303b06478193A7",
        "data": "0xccc143b80000000000000000000000000000000000000000000000000de0b6b3a76400000000000000000000000000009f0ff6ecef671200447604c19d72228a170bc21c",
        "gas": "400000",
        "value": "0",
        "referenceId": "8ff73d871d134fec8fb8bcdd1ae5394e"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "2",
    "amount": "1000000000000000000",
    "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
    "gas": "400000",
    "gasPriority": "low"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x9f0ff6eCef671200447604c19D72228a170BC21c",
        "to": "0x9F0491B32DBce587c50c4C43AB303b06478193A7",
        "data": "0xccc143b80000000000000000000000000000000000000000000000000de0b6b3a76400000000000000000000000000009f0ff6ecef671200447604c19d72228a170bc21c",
        "gas": "400000",
        "value": "0",
        "gasPrice": "2122766567",
        "referenceId": "8ff73d871d134fec8fb8bcdd1ae5394e"
    }
}

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

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": "2",
    "requestId": "2130",
    "from": "0x2Dce7632866E1C795e5644d30173d18b1DfAa71a",
    "gas": "400000"
}

Sample Response

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x2Dce7632866E1C795e5644d30173d18b1DfAa71a",
        "to": "0x9F0491B32DBce587c50c4C43AB303b06478193A7",
        "data": "0x379607f50000000000000000000000000000000000000000000000000000000000000852",
        "gas": "400000",
        "value": "0",
        "referenceId": "c4d68ead57b444fba7c855f6643e8a73"
    }
}

Sample Request

With gasPriority:

{
    "liquidStakingId": "2",
    "requestId": "2130",
    "from": "0x2Dce7632866E1C795e5644d30173d18b1DfAa71a",
    "gasPriority": "low",
    "gas": "400000"
}

Sample Response

With gasPriority:

{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "1",
        "from": "0x2Dce7632866E1C795e5644d30173d18b1DfAa71a",
        "to": "0x9F0491B32DBce587c50c4C43AB303b06478193A7",
        "data": "0x379607f50000000000000000000000000000000000000000000000000000000000000852",
        "gas": "400000",
        "value": "0",
        "gasPrice": "2072451432",
        "referenceId": "c4d68ead57b444fba7c855f6643e8a73"
    }
}

back to top

Error Handling Details

Error	Description
400 (Bad Request)	Indicates the request is invalid or missing the required parameters. The msg field will contain details about the error.
401 (Unauthorised)	Indicates the request lacks valid authentication credentials (API key). Ensure that you provide a valid API key in the request headers.
404 (Not Found)	Indicates that the specified endpoint or resource does not exist.
500 (Server Error)	Indicates an internal server error.

back to top