> For the complete documentation index, see [llms.txt](https://faq.finerymarkets.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://faq.finerymarkets.com/api-reference/rest-api/risk-management/setinstrumentswhitelist.md).

# setInstrumentsWhitelist

{% hint style="info" %}
Instruments whitelist must be enabled before. See [api/enableInstrumentsWhitelist](/api-reference/rest-api/risk-management/enableinstrumentswhitelist.md)
{% endhint %}

{% hint style="info" %}
When a Master adds an instrument whitelist, it automatically applies to sub-accounts as well
{% endhint %}

**POST api/setInstrumentsWhitelist**

{% tabs %}
{% tab title="Payload" %}

```json
{ 
 "instruments": ["BTC-USD", "ETH-USD"] // array of allowed instruments
}
```

{% endtab %}

{% tab title="200 OK" %}

```json
{
    "error": 0
}
```

{% endtab %}

{% tab title="400 Bad request" %}

```json
{
    "error": 2
}
```

{% endtab %}
{% endtabs %}

**Request parameters**

| Field name  | Type           | Description                   |
| ----------- | -------------- | ----------------------------- |
| instruments | Array\<string> | Array of allowed instruments. |
