> 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/pricing-and-instruments/addinstrumentmarkups.md).

# addInstrumentMarkups

**POST api/addInstrumentMarkups**

The markup is applied to your raw prices and widens the spread. Set the markup in % multiplied by 1e4. The permitted range is from -100000 to 100000 (from 10% to -10%).<br>

Instrument markup must be set for both sides. If the markup is not set for the instrument, the default counterparty markup will be used. To set the default markup, set `"instrument": null` or omit the `"instrument"` parameter.

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

```json
{
    "counterpartyId": 5,
    "instrument": "BTC-USD",
    "bidMarkup": 1000,
    "askMarkup": 2000,
    "flowDirection": "incoming"
}
```

{% 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                                                                                                        |
| -------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------ |
| counterpartyId | Efx::ClientID     | Counteraprty id                                                                                                    |
| instrument     | optional\<string> | Instrument name or *null* for default markup.                                                                      |
| bidMarkup      | int               | Bid markup value will be applied to bid orders of outgoing flow.                                                   |
| askMarkup      | int               | Ask markup value will be applied to ask orders of outgoing flow.                                                   |
| flowDirection  | string            | *Optional*. Flow direction is required for master-master connection only. Possible values: "incoming", "outgoing". |