# 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](broken://pages/8x8qwIu19Aq8uFsjOXvI) 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](broken://pages/8x8qwIu19Aq8uFsjOXvI) 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](broken://pages/8x8qwIu19Aq8uFsjOXvI) 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](broken://pages/8x8qwIu19Aq8uFsjOXvI) 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](broken://pages/8x8qwIu19Aq8uFsjOXvI) 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](broken://pages/8x8qwIu19Aq8uFsjOXvI) 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](broken://pages/8x8qwIu19Aq8uFsjOXvI) 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](broken://pages/8x8qwIu19Aq8uFsjOXvI) 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)


---

# 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/dex-and-dex-aggregators/raydium.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.
