# Stader

### Supported Chains

Available on **Ethereum, Binance and Polygon**

### Available Endpoints:

*Click on the endpoint to jump to the section with full details*

* [<mark style="color:blue;">/</mark>](#getmakerorders)[**getapr**](#getapr) <mark style="color:blue;">`GET`</mark> - Get the Stader staking APR.
* [**/getrewards** ](#getrewards)<mark style="color:blue;">`GET`</mark> - Get the initial staked amount and current staked value by a specified user address.
* [**/getstake**](#getstake) <mark style="color:blue;">`GET`</mark> -Get the stake amount for a particular address.
* [**/**](#getwithdrawalrewards)[<mark style="color:blue;">**getwithdrawalrequests**</mark>](#getwithdrawalrequests)[ ](#getwithdrawalrewards)<mark style="color:blue;">`GET`</mark> - Retrieves all withdrawal requests made by a specified address.
* [**/**](#getwithdrawalrewards)[<mark style="color:blue;">**getwithdrawalstatus**</mark>](#getwithdrawalstatus)<mark style="color:blue;">`GET`</mark> - Get the status of a withdrawal request made by a specified address.
* [**/**](#getwithdrawalrewards)[<mark style="color:blue;">**getallowance**</mark>](#getallowance)<mark style="color:blue;">`GET`</mark> - Get the approved allowance amount set by the owner for the spender.
* [**/Stake**](#stake) <mark style="color:green;">`POST`</mark> - Initiate a transaction to stake on Stader protocol.
* [**/requestwithdrawal** ](#requestwithdrawal)<mark style="color:green;">`POST`</mark> - Initiate a withdrawal request on Stader.
* [**/**](#requestwithdrawal)[<mark style="color:blue;">**approvewithdrawal**</mark>](#approvewithdrawal)[ ](#requestwithdrawal)<mark style="color:green;">`POST`</mark> - Initiate a transaction to approve the withdrawal request from a specified address.
* [**/claim**](#claim) <mark style="color:green;">`POST`</mark> - Initiate a transaction to claim staked ETH after a withdrawal request.
* [**/**](#mint)[<mark style="color:blue;">**decreaseallowance**</mark>](#decreaseallowance) <mark style="color:green;">`POST`</mark> - Initiate a transaction to decrease the allowance of staked token on the spender’s account.
* [**/**](#burn)[<mark style="color:blue;">**increaseallowance**</mark>](#increaseallowance) <mark style="color:green;">`POST`</mark> - Initiate a transaction to increase the allowance of staked token on the spender’s account.

*Also see* [<mark style="color:blue;">Error Handling Details</mark>](#error-handling-details)

## Liquid Staking IDs

Many endpoints have a parameter where you can provide a Liquid Staking ID.&#x20;

Below is a list of Liquid Staking IDs related to Stader. Please see the [Liquid Staking ID page](broken://pages/OavKmZGl56Z189e4PXVx) for a complete Liquid Staking ID list and more information.

<table><thead><tr><th width="275">Liquid Staking Name</th><th>Chain</th><th>Liquid Staking ID</th></tr></thead><tbody><tr><td>Stader</td><td>Ethereum</td><td>2</td></tr><tr><td>Stader</td><td>Binance</td><td>56</td></tr><tr><td>Stader</td><td>Polygon</td><td>137</td></tr><tr><td>Stader</td><td>Binance Testnet</td><td>97</td></tr></tbody></table>

## Endpoint Details

### /getapr

Get the Stader staking APR.

<mark style="color:blue;">`GET`</mark> `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](broken://pages/OavKmZGl56Z189e4PXVx) page for details. |

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/liquidstaking/getapr?liquidStakingId=2
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "timeUnix": "1722397871",
        "apr": "3.04",
        "blockNumber": "20423959"
    }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /getrewards

Get the initial staked amount and current staked value by a specified user address.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/liquidstaking/getrewards`

#### Query Parameters

<table><thead><tr><th width="182">Name</th><th width="159">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>liquidStakingId</td><td>String</td><td>Refer to the <a href="/pages/OavKmZGl56Z189e4PXVx">Liquid Staking Id</a> page for details.</td></tr><tr><td>address<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the user.</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/liquidstaking/getrewards?address=0x40B38765696e3d5d8d9d834D8AaD4bB6e418E489&liquidStakingId=2
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "stakedAmount": "0",
        "stakeValue": "0"
    }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /getstake

Get the stake amount for a particular address.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/liquidstaking/getstake`

#### Query Parameters

<table><thead><tr><th width="190">Name</th><th width="167">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>liquidStakingId</td><td>String</td><td>Refer to the <a href="/pages/OavKmZGl56Z189e4PXVx">Liquid Staking Id</a> page for details.</td></tr><tr><td>address<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the user.</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/liquidstaking/getstake?address=0xAB06ef1d486721a83C94B30B58ab9E28c5a1049D&liquidStakingId=2
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "ETHx": "2878342440"
    }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /getwithdrawalrequests

Get all the withdrawal requests(NFT ids) made by a specified address.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/liquidstaking/getwithdrawalrequests`

#### Query Parameters

<table><thead><tr><th width="193">Name</th><th width="167">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>liquidStakingId</td><td>String</td><td>Refer to the <a href="/pages/OavKmZGl56Z189e4PXVx">Liquid Staking Id</a> page for details.</td></tr><tr><td>address<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the user.</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/liquidstaking/getwithdrawalrequests?liquidStakingId=2&address=0x2Dce7632866E1C795e5644d30173d18b1DfAa71a
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": [
        "2130"
    ]
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /getwithdrawalstatus

Get the status of a withdrawal request made by a specified address.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/liquidstaking/getwithdrawalstatus`

#### Query Parameters

<table><thead><tr><th width="178">Name</th><th width="183">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>liquidStakingId</td><td>String</td><td>Refer to the <a href="/pages/OavKmZGl56Z189e4PXVx">Liquid Staking Id</a> page for details.</td></tr><tr><td>address<mark style="color:red;">*</mark></td><td>String</td><td>The address of user</td></tr><tr><td>requestId<mark style="color:red;">*</mark></td><td>String</td><td>The token id of NFT , which is minted upon request, to claim the rewards.</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

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

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "amountOfETH": "91233891673519371",
        "isFinalized": "91233891673519371"
    }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /getallowance

Get the approved allowance amount set by the owner for the spender.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/liquidstaking/getallowance`

#### Query Parameters

<table><thead><tr><th width="212">Name</th><th width="157">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>liquidStakingId</td><td>String</td><td>Refer to the <a href="/pages/OavKmZGl56Z189e4PXVx">Liquid Staking Id</a> page for details.</td></tr><tr><td>owner<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the owner of token.</td></tr><tr><td>tokenAddress<mark style="color:red;">*</mark></td><td>String</td><td>Token contract address.</td></tr><tr><td>spender<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the spender of token.</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

```url
https://api.expand.network/liquidstaking/getallowance?owner=0x49eb67E250513FAb9506190ed023F12A214D1a74&liquidStakingId=2&tokenAddress=0xA35b1B31Ce002FBF2058D22F30f95D405200A15b&spender=0x9f0491b32dbce587c50c4c43ab303b06478193a7
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "allowance": "53880000000000000"
    }
}
```

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /stake

Initiate a transaction to stake on Stader.

<mark style="color:green;">`POST`</mark> `https://api.expand.network/liquidstaking/stake`

#### Request Body

<table><thead><tr><th width="214">Name</th><th width="141">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>liquidStakingId</td><td>String</td><td>Refer to the <a href="/pages/OavKmZGl56Z189e4PXVx">Liquid Staking Id</a> page for details.</td></tr><tr><td>from<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the owner of this request.</td></tr><tr><td>amount<mark style="color:red;">*</mark></td><td>String</td><td>Amount of token to stake.</td></tr><tr><td>gas<mark style="color:red;">*</mark></td><td>String</td><td>Maximum gas limit provided by the sender, for the transaction.</td></tr><tr><td>gasPriority</td><td>String</td><td>low, medium, or high.</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

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

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Sample Request" %}
**With gasPriority:**

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

{% endtab %}

{% tab title="Sample Response" %}
**With gasPriority:**

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

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /increaseallowance

Initiate a transaction to increase the allowance of staked token on the spender’s account.

<mark style="color:green;">`POST`</mark> `https://api.expand.network/liquidstaking/increaseallowance`

#### Request Body

<table><thead><tr><th width="193">Name</th><th width="139">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>liquidStakingId</td><td>String</td><td>Refer to the <a href="/pages/OavKmZGl56Z189e4PXVx">Liquid Staking Id</a> page for details.</td></tr><tr><td>from<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the owner of this request.</td></tr><tr><td>tokenAddress<mark style="color:red;">*</mark></td><td>String</td><td>Token contract address.</td></tr><tr><td>spender<mark style="color:red;">*</mark></td><td>String</td><td>Address of spender.</td></tr><tr><td>addedAmount<mark style="color:red;">*</mark></td><td>String</td><td>Amount of tokens to increase allowance.</td></tr><tr><td>gas<mark style="color:red;">*</mark></td><td>String</td><td>Maximum gas limit provided by the sender, for the transaction.</td></tr><tr><td>gasPriority</td><td>String</td><td>low, medium, or high.</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

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

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Sample Request" %}
**With gasPriority:**

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

{% endtab %}

{% tab title="Sample Response" %}
**With gasPriority:**

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

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /decreaseallowance

Initiate a transaction to decrease the allowance of staked token on the spender’s account.

<mark style="color:green;">`POST`</mark> `https://api.expand.network/liquidstaking/decreaseallowance`

#### Request Body

<table><thead><tr><th width="204">Name</th><th width="150">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>liquidStakingId</td><td>String</td><td>Refer to the <a href="/pages/OavKmZGl56Z189e4PXVx">Liquid Staking Id</a> page for details.</td></tr><tr><td>from<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the owner of this request.</td></tr><tr><td>tokenAddress<mark style="color:red;">*</mark></td><td>String</td><td>Token contract address.</td></tr><tr><td>spender<mark style="color:red;">*</mark></td><td>String</td><td>Address of spender.</td></tr><tr><td>subtractedAmount<mark style="color:red;">*</mark></td><td>String</td><td>Amount of tokens to decrease allowance.</td></tr><tr><td>gas</td><td>String</td><td>Maximum gas limit provided by the sender, for the transaction.</td></tr><tr><td>gasPriority</td><td>String</td><td>low, medium, or high.</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

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

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Sample Request" %}
**With gasPriority:**&#x20;

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

{% endtab %}

{% tab title="Sample Response" %}
**With gasPriority:**&#x20;

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

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /approvewithdrawal

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

<mark style="color:green;">`POST`</mark> `https://api.expand.network/liquidstaking/approvewithdrawal`

#### Request Body

<table><thead><tr><th width="192">Name</th><th width="136">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>liquidStakingId</td><td>String</td><td>Refer to the <a href="/pages/OavKmZGl56Z189e4PXVx">Liquid Staking Id</a> page for details.</td></tr><tr><td>from<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the owner of this request.</td></tr><tr><td>amount<mark style="color:red;">*</mark></td><td>String</td><td>Amount of tokens to approve withdrawal.</td></tr><tr><td>gas</td><td>String</td><td>Maximum gas limit provided by the sender, for the transaction.</td></tr><tr><td>gasPriority</td><td>String</td><td>low, medium, or high.</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

```json
{
    "liquidStakingId": "2",
    "amount": "10000",
    "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
    "gas": "400000"
}
```

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Sample Request" %}
**With gasPriority:**&#x20;

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

{% endtab %}

{% tab title="Sample Response" %}
**With gasPriority:**&#x20;

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

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /requestwithdrawal

Initiate a transaction to request a withdrawal on Stader.

<mark style="color:green;">`POST`</mark> `https://api.expand.network/liquidstaking/requestwithdrawal`

#### Request Body

<table><thead><tr><th width="182">Name</th><th width="143">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>liquidStakingId</td><td>String</td><td>Refer to the <a href="/pages/OavKmZGl56Z189e4PXVx">Liquid Staking Id</a> page for details.</td></tr><tr><td>from<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the owner of this request.</td></tr><tr><td>amount<mark style="color:red;">*</mark></td><td>String</td><td>Amount of tokens to request withdrawal.</td></tr><tr><td>ownerAddress<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the owner.</td></tr><tr><td>gas</td><td>String</td><td>Maximum gas limit provided by the sender, for the transaction.</td></tr><tr><td>gasPriority</td><td>String</td><td>low, medium, or high.</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

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

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Sample Request" %}
**With gasPriority:**&#x20;

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

{% endtab %}

{% tab title="Sample Response" %}
**With gasPriority:**

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

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### /claim

Initiate a transaction to burn the NFT, which is minted upon request, and to claim the rewards.

<mark style="color:green;">`POST`</mark> `https://api.expand.network/liquidstaking/claim`

#### Request Body

<table><thead><tr><th width="184">Name</th><th width="108">Type</th><th>Description</th></tr></thead><tbody><tr><td>rpc</td><td>String</td><td>Remote procedural call URL.</td></tr><tr><td>liquidStakingId</td><td>String</td><td>Refer to the <a href="/pages/OavKmZGl56Z189e4PXVx">Liquid Staking Id</a> page for details.</td></tr><tr><td>from<mark style="color:red;">*</mark></td><td>String</td><td>Public address of the owner of this request.</td></tr><tr><td>requestId<mark style="color:red;">*</mark></td><td>String</td><td>The token id of NFT , which is minted upon request, to claim the rewards.</td></tr><tr><td>gas</td><td>String</td><td>Maximum gas limit provided by the sender, for the transaction.</td></tr><tr><td>gasPriority</td><td>String</td><td>low, medium, or high.</td></tr></tbody></table>

{% tabs %}
{% tab title="Sample Request" %}

```json
{
    "liquidStakingId": "2",
    "requestId": "2130",
    "from": "0x2Dce7632866E1C795e5644d30173d18b1DfAa71a",
    "gas": "400000"
}
```

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Sample Request" %}
**With gasPriority:**

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

{% endtab %}

{% tab title="Sample Response" %}
**With gasPriority:**

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

{% endtab %}
{% endtabs %}

[<mark style="color:blue;">back to top</mark>](#endpoints-available)

### Error Handling Details

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

[<mark style="color:blue;">back to top</mark>](#endpoints-available)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.expand.network/integrations/liquid-staking/stader.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.