# 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](https://docs.expand.network/integrations/liquid-staking/broken-reference) 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](https://docs.expand.network/integrations/liquid-staking/broken-reference) 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="broken-reference">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="broken-reference">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="broken-reference">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="broken-reference">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="broken-reference">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="broken-reference">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="broken-reference">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="broken-reference">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="broken-reference">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="broken-reference">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="broken-reference">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)