Benqi

Supported Chains

Available on Avalanche

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.

• claim POST - Initiate a transaction to claim staked ETH after a withdrawal request.

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
Benqi	Avalanche	43114

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

Sample Response

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?liquidStakingId=43114&address=0x10137E2EC5907ceA3151FB00C3Ecd9B48E22B82B

Sample Response

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=0x10137E2EC5907ceA3151FB00C3Ecd9B48E22B82B&liquidStakingId=43114

Sample Response

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=43114&address=0xc1d423aE49fba66AA713610811d13e0BECf213c6

Sample Response

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=43114&requestId=0&address=0xc1d423aE49fba66AA713610811d13e0BECf213c6

Sample Response

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?liquidStakingId=43114&owner=0x6427B4b028c4A1db5fb5dAf80C22e81115457230&tokenAddress=0x2b2C81e08f1Af8835a78Bb2A90AE924ACE0eA4bE&spender=0x6427B4b028c4A1db5fb5dAf80C22e81115457230

Sample Response

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": "43114",
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "gas": "40000"
}

Sample Response

Sample Request

With gasPriority:

{
    "amount": "1000000000000000000",
    "liquidStakingId": "43114",
    "from": "0xefdc8FC1145ea88e3f5698eE7b7b432F083B4246",
    "gas": "40000",
    "gasPriority": "low"
}

Sample Response

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

{
    "amount": "100000",
    "liquidStakingId": "43114",
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "gas": "40000"
}

Sample Response

Sample Request

With gasPriority:

{
    "amount": "100000",
    "liquidStakingId": "43114",
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "gas": "40000",
    "gasPriority": "low"
}

Sample Response

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": "43114",
    "requestId": "0",
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "gas": "400000"
}

Sample Response

Sample Request

With gasPriority:

{
    "liquidStakingId": "43114",
    "requestId": "0",
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "gasPriority": "medium",
    "gas": "400000"
}

Sample Response

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