# Raydium

### Supported Chains

Available on **Solana**

### Available Endpoints:

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

* [**/getprice**](#getprice) <mark style="color:blue;">`GET`</mark> - Returns the swap quotation for a given token pair on Raydium AMM
* [**/getuserliquidity**](#getuserliquidity) <mark style="color:blue;">`GET`</mark> - Returns the balance of a particular token pair of an account.&#x20;
* [**/getpoolliquidity**](#getpoolliquidity) <mark style="color:blue;">`GET`</mark> - Returns the total liquidity for a specified pool.
* [**/gettokenliquidity**](#gettokenliquidity) <mark style="color:blue;">`GET`</mark> - Returns the individual token liquidity within the specified liquidity pool.
* [**/swap**](#swap) <mark style="color:green;">`POST`</mark> - Initiate a swap transaction on a specified DEX.&#x20;
* [**/addliquidity**](#addliquidity) <mark style="color:green;">`POST`</mark> - Add liquidity to a specified pool in a specified DEX.&#x20;
* [**/removeliquidity**](#removeliquidity) <mark style="color:green;">`POST`</mark> - Remove liquidity from a specified pool in a specified DEX.&#x20;

*Also see* [Error Handling Details](#error-handling-details)

### DEX IDs

Please use DEX ID <mark style="color:orange;">**2700**</mark> for Raydium.\
\
See the [DEX ID page](https://docs.expand.network/integrations/dex-and-dex-aggregators/broken-reference) for a complete list of DEX IDs.

## Endpoint Details

### /getprice

Returns the swap quotation for the given token pair.

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

#### Query Parameters

| Name                                       | Type   | Description                                                                                                                |
| ------------------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------- |
| rpc                                        | String | Remote procedural call URL.                                                                                                |
| dexId<mark style="color:red;">\*</mark>    | String | Refer to the [DEX ID](https://docs.expand.network/integrations/dex-and-dex-aggregators/broken-reference) page for details. |
| path<mark style="color:red;">\*</mark>     | String | Comma separated values of token addresses whose price is to be fetched.                                                    |
| amountIn<mark style="color:red;">\*</mark> | String | Token amount for which the swap quotation is to be fetched.                                                                |

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

```
https://api.expand.network/dex/getprice?dexId=2700&path=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amountIn=1000000000000000
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "amountIn": "10000000000",
        "path": [
            "So11111111111111111111111111111111111111112",
            "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
        ],
        "amountsOut": [
            "10000000000",
            "1261071113"
        ]
    }
}
```

{% endtab %}
{% endtabs %}

[back to top](#endpoints-available)

### /getuserliquidity

Returns the balance of a particular token pair of an account.

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

#### Query Parameters

| Name                                          | Type   | Description                                                                                                            |
| --------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------- |
| rpc                                           | String | Remote procedural call URL.                                                                                            |
| dexId<mark style="color:red;">\*</mark>       | String | Refer to [DEX ID](https://docs.expand.network/integrations/dex-and-dex-aggregators/broken-reference) page for details. |
| poolAddress<mark style="color:red;">\*</mark> | String | Pool address whose liquidity is to be fetched.                                                                         |
| address<mark style="color:red;">\*</mark>     | String | Public address of liquidity provider.                                                                                  |

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

```
https://api.expand.network/dex/getuserliquidity?dexId=2700&poolAddress=58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2&address=DgbCWnbXg43nmeiAveMCkUUPEpAr3rZo3iop3TyP6S63
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "pairAddress": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
        "liquidity": "34665717201069",
        "tokenA": "18456761489485",
        "tokenB": "2508924971865"
    }
}
```

{% endtab %}
{% endtabs %}

[back to top](#endpoints-available)

### /getpoolliquidity

Returns the total liquidity for a specified pool.

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

#### Query Parameters

| Name                                          | Type   | Description                                                                                                            |
| --------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------- |
| rpc                                           | String | Remote procedural call URL.                                                                                            |
| poolAddress<mark style="color:red;">\*</mark> | String | Pool address whose liquidity is to be fetched.                                                                         |
| dexId<mark style="color:red;">\*</mark>       | String | Refer to [DEX ID](https://docs.expand.network/integrations/dex-and-dex-aggregators/broken-reference) page for details. |

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

```
https://api.expand.network/dex/getpoolliquidity?dexId=2700&poolAddress=58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "totalLiquidity": "45961012710"
    }
}
```

{% endtab %}
{% endtabs %}

[back to top](#endpoints-available)

### /gettokenliquidity

Returns the individual token liquidity within the specified liquidity pool.

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

#### Query Parameters

| Name                                          | Type   | Description                                                                                                            |
| --------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------- |
| rpc                                           | String | Remote procedural call URL.                                                                                            |
| dexId<mark style="color:red;">\*</mark>       | String | Refer to [DEX ID](https://docs.expand.network/integrations/dex-and-dex-aggregators/broken-reference) page for details. |
| poolAddress<mark style="color:red;">\*</mark> | String | Pool address whose token liquidity is to be fetched.                                                                   |

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

```
https://api.expand.network/dex/gettokenliquidity?dexId=2700&poolAddress=58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "WSOL": "733843263201",
        "USDC": "294556177599"
    }
}
```

{% endtab %}
{% endtabs %}

[back to top](#endpoints-available)

### /swap

Initiate a swap transaction on a specified DEX.

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

#### Request Body

| Name                                       | Type   | Description                                                                                                                |
| ------------------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------- |
| rpc                                        | String | Remote procedural call URL.                                                                                                |
| dexId<mark style="color:red;">\*</mark>    | String | Refer to the [DEX ID](https://docs.expand.network/integrations/dex-and-dex-aggregators/broken-reference) page for details. |
| path<mark style="color:red;">\*</mark>     | Array  | Comma-separated values of token addresses, inside an array, which needs to be swap.                                        |
| amountIn<mark style="color:red;">\*</mark> | String | Amount of token to be swapped.                                                                                             |
| from<mark style="color:red;">\*</mark>     | String | Address of the sender of the token.                                                                                        |
| slippage                                   | String | <p>Percentage of total swap value. <br>By default, 1.</p><p>0 <= slippage  value <= 100</p>                                |

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

```json
{
    "dexId": "2700",
    "from": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
    "amountIn": "1000000000",
    "path": [
        "So11111111111111111111111111111111111111112",
        "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
    ]
}
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "900",
        "from": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
        "to": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
        "data": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAQAHFUjAG1BZAFRV2dywxrzs3LT7Wy6rwamoK1c5K6qkDwTmcmHVW2tZXZTG37F2awg7OCJoV1XfJE6cAN6yYjy35kw9bkcuZ6RuprS9C6ud/TXitMcvHW1Zwuq5XJQlc60i8fkvOQ/5YJ6K1De7jkwfGqQ6wF0kMIzKd96FEsVQkpLTq+Q8fB4h6qb5fIvTVeIb0SeWdHVsHI4QbG5xK6EW2XC4cOEt03mJFWHS6fqPJkMYNOtzby8k/CoqTf8f1dyk3/LLubdg7dsYVwYwMGOtM9e1cpbqAtTgM14xzq+kzELdasTDzvqfGb9UyNwPXk0c7uUyfSZIKynSsTy6pDRHIY1GUnlJ4KemWfiq3Ia8U8x8QkaaF3Zam61isbBbyGi17sm+ubFtGKgnOXbvibf96Ersm6rKDbFz24/aSuDeR4o0axAyMcl1BQzsjabeQDV8m8pg756PMxZaJVZlZSqCUzuoS7ZGYkZ4HXqa2rhYi6hrKszlE1jIRPVETkBkCHX9WkydmX0uxDvcDSNiac+w0IORr9ED/Y+9Y0U/9YtuI6kg3sTeRGTwuXxew5/kivghLMd/7RlS2oFJdI1UTmJL6wADBkZv5SEXMv/srbpyw5vnvIzlu8X3EmssQ5s6QAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABt324ddloZPZy+FGzut5rBy0he1fWzeROoz1hX7/AKkGm4hX/quBhPtof2NGGMA12sQ53BrrO1WYoPAAAAAAAUvZScQ2AsM/IHeQ7RajUkyhuZdc8SGiqQz/7H34torNQVewWA8xxfzkSmJYLbz5147nWUOghKOTs1A2jSKJkwiqWjHLAguwAphcqSmQgXGUD+Y1y3bpnOT7iAVCi7glSrCA6a7N2uCcmhY5fiGxleqH8LpAl9H6RuPGImQPWpSfBg4ACQMA4fUFAAAAAA4ABQLAJwkADwIAAXwDAAAASMAbUFkAVFXZ3LDGvOzctPtbLqvBqagrVzkrqqQPBOYgAAAAAAAAADhOYVVMNjNzOUxuVTZqcEVUVTU3cmIycUhGRXRvb0Rq8Oe5OwAAAAClAAAAAAAAAAbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCpEAQBEQAVAQESEhACEwMEBQYWBwgJCgsMFAENABEJAMqaOwAAAAB7CVMIAAAAABADAQAAAQkBGY8fTDpFImPUE7LNF+vLwaDliHNk5iYaEqgXkuoWWj4AAgUL",
        "referenceId": "7f3a8c65a33c4109ab175b7d8b6d1c15"
    }
}
```

{% endtab %}
{% endtabs %}

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

```json
{
    "dexId": "2700",
    "from": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
    "amountIn": "1000000000",
    "path": [
        "So11111111111111111111111111111111111111112",
        "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
    ],
    "slippage": "10"
}
```

{% endtab %}

{% tab title="Sample Response" %}
With Slippage:

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "900",
        "from": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
        "to": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
        "data": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAQAHFUjAG1BZAFRV2dywxrzs3LT7Wy6rwamoK1c5K6qkDwTm/bKkuSbxgb6e6y0kykszqK4sgB2125CxqMqOVfgmQgE9bkcuZ6RuprS9C6ud/TXitMcvHW1Zwuq5XJQlc60i8fkvOQ/5YJ6K1De7jkwfGqQ6wF0kMIzKd96FEsVQkpLTq+Q8fB4h6qb5fIvTVeIb0SeWdHVsHI4QbG5xK6EW2XC4cOEt03mJFWHS6fqPJkMYNOtzby8k/CoqTf8f1dyk3/LLubdg7dsYVwYwMGOtM9e1cpbqAtTgM14xzq+kzELdasTDzvqfGb9UyNwPXk0c7uUyfSZIKynSsTy6pDRHIY1GUnlJ4KemWfiq3Ia8U8x8QkaaF3Zam61isbBbyGi17sm+ubFtGKgnOXbvibf96Ersm6rKDbFz24/aSuDeR4o0axAyMcl1BQzsjabeQDV8m8pg756PMxZaJVZlZSqCUzuoS7ZGYkZ4HXqa2rhYi6hrKszlE1jIRPVETkBkCHX9WkydmX0uxDvcDSNiac+w0IORr9ED/Y+9Y0U/9YtuI6kg3sTeRGTwuXxew5/kivghLMd/7RlS2oFJdI1UTmJL6wADBkZv5SEXMv/srbpyw5vnvIzlu8X3EmssQ5s6QAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABt324ddloZPZy+FGzut5rBy0he1fWzeROoz1hX7/AKkGm4hX/quBhPtof2NGGMA12sQ53BrrO1WYoPAAAAAAAUvZScQ2AsM/IHeQ7RajUkyhuZdc8SGiqQz/7H34torNQVewWA8xxfzkSmJYLbz5147nWUOghKOTs1A2jSKJkwiqWjHLAguwAphcqSmQgXGUD+Y1y3bpnOT7iAVCi7glSkX6ZkOoLM2xLL0WaXoO4tYiUaKoYYA1gJFt7ZnCdIpcBg4ACQMA4fUFAAAAAA4ABQLAJwkADwIAAXwDAAAASMAbUFkAVFXZ3LDGvOzctPtbLqvBqagrVzkrqqQPBOYgAAAAAAAAADhaNUJZREs4djFiVlJ0QVdncnVNZG12c2czTmR2c05m8Oe5OwAAAAClAAAAAAAAAAbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCpEAQBEQAVAQESEhACEwMEBQYWBwgJCgsMFAENABEJAMqaOwAAAACl3lIIAAAAABADAQAAAQkBGY8fTDpFImPUE7LNF+vLwaDliHNk5iYaEqgXkuoWWj4AAgUL",
        "referenceId": "a3e868e4f5334ae38883584ffa44d798"
    }
}
```

{% endtab %}
{% endtabs %}

[back to top](#endpoints-available)

### /addliquidity

Add liquidity to a specified pool in a specified DEX.

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

#### Request Body

| Name                                       | Type   | Description                                                                                                                |
| ------------------------------------------ | ------ | -------------------------------------------------------------------------------------------------------------------------- |
| rpc                                        | String | Remote procedural call URL.                                                                                                |
| dexId<mark style="color:red;">\*</mark>    | String | Refer to the [DEX ID](https://docs.expand.network/integrations/dex-and-dex-aggregators/broken-reference) page for details. |
| path<mark style="color:red;">\*</mark>     | Array  | Comma-separated values of token addresses, inside an array, which needs to be added to the pool.                           |
| amountIn<mark style="color:red;">\*</mark> | Array  | Comma-separated values of tokens amount, inside an array, which needs to be added to the pool.                             |
| from<mark style="color:red;">\*</mark>     | String | Address of the sender of the token.                                                                                        |
| slippage                                   | String | <p>Percentage of total swap value. <br>By default, 1.</p><p>0 <= slippage  value <= 100</p>                                |

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

```json
{
    "amountIn": [
        "100000000",
        "1000000"
    ],
    "from": "3CpV6SbiX65BmZ8g3Bx7X1uMcWBueHxrpYbVrL1E5y8J",
    "path": [
        "7BgBvyjrZX1YKz4oh9mjb8ZScatkkwb8DzFx7LoiVkM3",
        "So11111111111111111111111111111111111111112"
    ],
    "dexId": "2700"
}
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "900",
        "from": "3CpV6SbiX65BmZ8g3Bx7X1uMcWBueHxrpYbVrL1E5y8J",
        "to": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
        "data": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAoTIL50GRZwGAaYW2Ao2FL43oJs0DlBxBj1Xme/4qVIATdD3P/t/DO1pzBrpS1xaaRywxcQdnuxSLl5MSIJSjU1AFDGXbEdOCsVyMfYSqKnNDywUM5i/EVEalaBU8b5grmMZm+2K/rD9/2xMclVb8Zt49BXP5W7D0uksP0M/cC4iy55LX6CCXZG8PqIMbiPxAkbA4R7w8nT6e6K0MZkNXzXII/HjJfNHnzvp/+optMcHs5MT2x2zZSH1R/JCX2iowFJ6Cx4E0HBtuxRtPKIX/F2wY1mGhDFnGq1tMprzBotlvfqd9VDlQaPc+tsni54IZf8WjJ8Rp3GVEDMlYIHuBVlqeqYDBUH0Q2ehyn8j7XvMJPvhdyScu14ooXvNGFBLzKrAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABBV7BYDzHF/ORKYlgtvPnXjudZQ6CEo5OzUDaNIomTCEvZScQ2AsM/IHeQ7RajUkyhuZdc8SGiqQz/7H34torNWFsbWV7tFM88jou9VJPCjTaxuXC2wV2EzoN09RDjoA99ThHpEJdZ0Ip9+Dv+3xLYI5YIL2KD6Tj3kfeX/5WANAMGRm/lIRcy/+ytunLDm+e8jOW7xfcSayxDmzpAAAAA1rGv5a09TO8jPWu0n0e1SFuTVywy5mjetL7AzfLVTMoGm4hX/quBhPtof2NGGMA12sQ53BrrO1WYoPAAAAAAAQan1RcZLFxRIYzJTD1K8X9Y2u4Im6H9ROPb2YoAAAAABt324ddloZPZy+FGzut5rBy0he1fWzeROoz1hX7/AKlFlVA+AqmYQjqsF8ikOiqSc4HU0az7Q+328AdG53KC0QYOAAkDAOH1BQAAAAAOAAUCwCcJAAkCAAh8AwAAACC+dBkWcBgGmFtgKNhS+N6CbNA5QcQY9V5nv+KlSAE3IAAAAAAAAABIQ1NDR0t1R013NFoxUHZnRlBlM2g5TmhQTjFwN05TWaMmIQAAAAAApQAAAAAAAAAG3fbh12Whk9nL4UbO63msHLSF7V9bN5E6jPWFfv8AqRIECBAAEQEBCw4SBQoPBgIEAQwHCAMADRkDAOH1BQAAAACzCAIAAAAAAAAAAAAAAAAAEgMIAAABCQ==",
        "referenceId": "34c563a373284101871473a7c58509c8"
    }
}
```

{% endtab %}
{% endtabs %}

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

```json
{
    "amountIn": [
        "100000000",
        "1000000"
    ],
    "from": "3CpV6SbiX65BmZ8g3Bx7X1uMcWBueHxrpYbVrL1E5y8J",
    "path": [
        "7BgBvyjrZX1YKz4oh9mjb8ZScatkkwb8DzFx7LoiVkM3",
        "So11111111111111111111111111111111111111112"
    ],
    "slippage": "10",
    "dexId": "2700"
}
```

{% endtab %}

{% tab title="Sample Response" %}
With Slippage:

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "900",
        "from": "3CpV6SbiX65BmZ8g3Bx7X1uMcWBueHxrpYbVrL1E5y8J",
        "to": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
        "data": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAoTIL50GRZwGAaYW2Ao2FL43oJs0DlBxBj1Xme/4qVIATdD3P/t/DO1pzBrpS1xaaRywxcQdnuxSLl5MSIJSjU1AFDGXbEdOCsVyMfYSqKnNDywUM5i/EVEalaBU8b5grmMZm+2K/rD9/2xMclVb8Zt49BXP5W7D0uksP0M/cC4iy55LX6CCXZG8PqIMbiPxAkbA4R7w8nT6e6K0MZkNXzXII/HjJfNHnzvp/+optMcHs5MT2x2zZSH1R/JCX2iowFJ6Cx4E0HBtuxRtPKIX/F2wY1mGhDFnGq1tMprzBotlvfqd9VDlQaPc+tsni54IZf8WjJ8Rp3GVEDMlYIHuBVlqeqYDBUH0Q2ehyn8j7XvMJPvhdyScu14ooXvNGFBLzKrAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABBV7BYDzHF/ORKYlgtvPnXjudZQ6CEo5OzUDaNIomTCEvZScQ2AsM/IHeQ7RajUkyhuZdc8SGiqQz/7H34torNWFsbWV7tFM88jou9VJPCjTaxuXC2wV2EzoN09RDjoA99ThHpEJdZ0Ip9+Dv+3xLYI5YIL2KD6Tj3kfeX/5WANAMGRm/lIRcy/+ytunLDm+e8jOW7xfcSayxDmzpAAAAA1rGv5a09TO8jPWu0n0e1SFuTVywy5mjetL7AzfLVTMoGm4hX/quBhPtof2NGGMA12sQ53BrrO1WYoPAAAAAAAQan1RcZLFxRIYzJTD1K8X9Y2u4Im6H9ROPb2YoAAAAABt324ddloZPZy+FGzut5rBy0he1fWzeROoz1hX7/AKlFlVA+AqmYQjqsF8ikOiqSc4HU0az7Q+328AdG53KC0QYOAAkDAOH1BQAAAAAOAAUCwCcJAAkCAAh8AwAAACC+dBkWcBgGmFtgKNhS+N6CbNA5QcQY9V5nv+KlSAE3IAAAAAAAAABIQ1NDR0t1R013NFoxUHZnRlBlM2g5TmhQTjFwN05TWaMmIQAAAAAApQAAAAAAAAAG3fbh12Whk9nL4UbO63msHLSF7V9bN5E6jPWFfv8AqRIECBAAEQEBCw4SBQoPBgIEAQwHCAMADRkDAOH1BQAAAACzCAIAAAAAAAAAAAAAAAAAEgMIAAABCQ==",
        "referenceId": "34c563a373284101871473a7c58509c8"
    }
}
```

{% endtab %}
{% endtabs %}

[back to top](#endpoints-available)

### /removeliquidity

Remove liquidity from a specified pool for a specified DEX.

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

#### Request Body

| Name                                          | Type   | Description                                                                                                                |
| --------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------- |
| rpc                                           | String |                                                                                                                            |
| dexId<mark style="color:red;">\*</mark>       | String | Refer to the [DEX ID](https://docs.expand.network/integrations/dex-and-dex-aggregators/broken-reference) page for details. |
| path<mark style="color:red;">\*</mark>        | Array  | Comma-separated values of token addresses, inside an array, which needs to be added to the pool.                           |
| from<mark style="color:red;">\*</mark>        | String | Address of the sender of the token.                                                                                        |
| liquidity<mark style="color:red;">\*</mark>   | String | Total amount of liquidity to be removed from the given pool.                                                               |
| poolAddress<mark style="color:red;">\*</mark> | String | The address of the pool.                                                                                                   |
| Slippage                                      | String | Percentage of total value. By default, 1. 0 <= slippage value <= 10                                                        |

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

```json
{
    "dexId": "2700",
    "from": "HXjWEL3bYucHDpLi81NwCewYKaqJMPdCfxkaSZTu6K2s",
    "liquidity": "10000",
    "path": [
        "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "So11111111111111111111111111111111111111112"
    ],
    "poolAddress": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2"
}
```

{% endtab %}

{% tab title="Sample Response" %}

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "900",
        "from": "HXjWEL3bYucHDpLi81NwCewYKaqJMPdCfxkaSZTu6K2s",
        "to": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
        "data": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAQAHF/WaeXdTJ27Q/+deDFn6U7t40VnlvJwN5rXCtN67t/K8kaHYvpE8dlTOOztSa+a8k3mpfe7787cfTSa5IlRHtHA9bkcuZ6RuprS9C6ud/TXitMcvHW1Zwuq5XJQlc60i8fkvOQ/5YJ6K1De7jkwfGqQ6wF0kMIzKd96FEsVQkpLTq+Q8fB4h6qb5fIvTVeIb0SeWdHVsHI4QbG5xK6EW2XBsT5PYWOiP+v6gjENnRJfo5qkywMgxSCYqGuPMx4Kexrhw4S3TeYkVYdLp+o8mQxg063NvLyT8KipN/x/V3KTf8su5t2Dt2xhXBjAwY60z17VyluoC1OAzXjHOr6TMQt1qxMPO+p8Zv1TI3A9eTRzu5TJ9JkgrKdKxPLqkNEchjahLtkZiRngdeprauFiLqGsqzOUTWMhE9UROQGQIdf1aTJ2ZfS7EO9wNI2Jpz7DQg5Gv0QP9j71jRT/1i24jqSCs22+N/lu1YxJsx9m7BZadnIJ77Rrsw6dkMYzBAbJIcDgP8n9tpRklKZQIlRLblVwnq9QqGMmt3PPesAqVFBQyaxAyMcl1BQzsjabeQDV8m8pg756PMxZaJVZlZSqCUztGUnlJ4KemWfiq3Ia8U8x8QkaaF3Zam61isbBbyGi17sm+ubFtGKgnOXbvibf96Ersm6rKDbFz24/aSuDeR4o0AwZGb+UhFzL/7K26csOb57yM5bvF9xJrLEObOkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCpBpuIV/6rgYT7aH9jRhjANdrEOdwa6ztVmKDwAAAAAAFL2UnENgLDPyB3kO0Wo1JMobmXXPEhoqkM/+x9+LaKzUFXsFgPMcX85EpiWC28+deO51lDoISjk7NQNo0iiZMIqloxywILsAKYXKkpkIFxlA/mNct26Zzk+4gFQou4JUr8kjAZlFtn2+0wnP2gKcVDku1xPghLNRo5eog7ef07gwYQAAkDAOH1BQAAAAAQAAUCwCcJABECAAF8AwAAAPWaeXdTJ27Q/+deDFn6U7t40VnlvJwN5rXCtN67t/K8IAAAAAAAAABCRllIdmF6VnJReXE3WDhSU3FLQUN1aGRDc2dBd0pOcfAdHwAAAAAApQAAAAAAAAAG3fbh12Whk9nL4UbO63msHLSF7V9bN5E6jPWFfv8AqRIEARMAFwEBFBYSAhUDBAUGBwICGAgJChYLAQwADQ4PCQQQJwAAAAAAABIDAQAAAQkBGY8fTDpFImPUE7LNF+vLwaDliHNk5iYaEqgXkuoWWj4AAgUL",
        "referenceId": "636907790d65493eb9c77dcd9463a537"
    }
}
```

{% endtab %}
{% endtabs %}

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

```json
{
    "dexId": "2700",
    "from": "HXjWEL3bYucHDpLi81NwCewYKaqJMPdCfxkaSZTu6K2s",
    "liquidity": "10000",
    "path": [
        "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "So11111111111111111111111111111111111111112"
    ],
    "poolAddress": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
    "slippage": "10"
}
```

{% endtab %}

{% tab title="Sample Response" %}
With Slippage:

```json
{
    "status": 200,
    "msg": "success",
    "data": {
        "chainId": "900",
        "from": "HXjWEL3bYucHDpLi81NwCewYKaqJMPdCfxkaSZTu6K2s",
        "to": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
        "data": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAQAHF/WaeXdTJ27Q/+deDFn6U7t40VnlvJwN5rXCtN67t/K8kaHYvpE8dlTOOztSa+a8k3mpfe7787cfTSa5IlRHtHA9bkcuZ6RuprS9C6ud/TXitMcvHW1Zwuq5XJQlc60i8fkvOQ/5YJ6K1De7jkwfGqQ6wF0kMIzKd96FEsVQkpLTq+Q8fB4h6qb5fIvTVeIb0SeWdHVsHI4QbG5xK6EW2XBsT5PYWOiP+v6gjENnRJfo5qkywMgxSCYqGuPMx4Kexrhw4S3TeYkVYdLp+o8mQxg063NvLyT8KipN/x/V3KTf8su5t2Dt2xhXBjAwY60z17VyluoC1OAzXjHOr6TMQt1qxMPO+p8Zv1TI3A9eTRzu5TJ9JkgrKdKxPLqkNEchjahLtkZiRngdeprauFiLqGsqzOUTWMhE9UROQGQIdf1aTJ2ZfS7EO9wNI2Jpz7DQg5Gv0QP9j71jRT/1i24jqSCs22+N/lu1YxJsx9m7BZadnIJ77Rrsw6dkMYzBAbJIcDgP8n9tpRklKZQIlRLblVwnq9QqGMmt3PPesAqVFBQyaxAyMcl1BQzsjabeQDV8m8pg756PMxZaJVZlZSqCUztGUnlJ4KemWfiq3Ia8U8x8QkaaF3Zam61isbBbyGi17sm+ubFtGKgnOXbvibf96Ersm6rKDbFz24/aSuDeR4o0AwZGb+UhFzL/7K26csOb57yM5bvF9xJrLEObOkAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCpBpuIV/6rgYT7aH9jRhjANdrEOdwa6ztVmKDwAAAAAAFL2UnENgLDPyB3kO0Wo1JMobmXXPEhoqkM/+x9+LaKzUFXsFgPMcX85EpiWC28+deO51lDoISjk7NQNo0iiZMIqloxywILsAKYXKkpkIFxlA/mNct26Zzk+4gFQou4JUr8kjAZlFtn2+0wnP2gKcVDku1xPghLNRo5eog7ef07gwYQAAkDAOH1BQAAAAAQAAUCwCcJABECAAF8AwAAAPWaeXdTJ27Q/+deDFn6U7t40VnlvJwN5rXCtN67t/K8IAAAAAAAAABCRllIdmF6VnJReXE3WDhSU3FLQUN1aGRDc2dBd0pOcfAdHwAAAAAApQAAAAAAAAAG3fbh12Whk9nL4UbO63msHLSF7V9bN5E6jPWFfv8AqRIEARMAFwEBFBYSAhUDBAUGBwICGAgJChYLAQwADQ4PCQQQJwAAAAAAABIDAQAAAQkBGY8fTDpFImPUE7LNF+vLwaDliHNk5iYaEqgXkuoWWj4AAgUL",
        "referenceId": "636907790d65493eb9c77dcd9463a537"
    }
}
```

{% endtab %}
{% endtabs %}

[back to top](#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>

[back to top](#endpoints-available)