> For the complete documentation index, see [llms.txt](https://3commas.gitbook.io/3commas-official-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://3commas.gitbook.io/3commas-official-api-docs/dca-bot/add-pairs-to-the-blacklist.md).

# Add pairs to the blacklist

<br>

**Description:** Adds specified pair(s) to the blacklist, preventing all DCA bots from opening deals with these pairs<br>

**Permission:** BOTS\_WRITE\
**Security** SIGNED\ <br>

> <mark style="color:green;">**`POST`**</mark>
>
> `ver1/bots/update_pairs_black_list`

<br>

## Body parameter<br>

**pairs**     `string`     <mark style="color:orange;">required</mark>\
Trading pair(s) in 3Commas format

<br>

{% hint style="info" %}
The trading pair code is used in the 3Commas format. Use the endpoint [All Market Pairs](https://github.com/3commas-io/3commas-official-api-docs/blob/gitbook/docs/DCA%20Bot/Market%20data/2.All%20market%20pairs.md) to get the value for parameter pair in 3Commas format.
{% endhint %}

<br>

## Response Parameter<br>

**pairs**     `array`\
The list of pairs that was added to the blacklist

<br>

## Example Request<br>

```json
POST /ver1/bots/update_pairs_black_list?pairs=1INCH_1INCH-USD-SWAP
```

<br>

## Example Response and errors<br>

<details>

<summary>Status: 201 Created</summary>

<br>

```json
{
    "pairs": [
        "1INCH_1INCH-USD-SWAP"
    ]
}
```

</details>
