# add

**POST /add**

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

```json
{
    "instrument": "BTC-USD",
    "clientOrderId": 123456789,
    "price": 999900000000,
    "size": 10000000,
    "side": "bid",
    "type": "limitIOC",
    "cod": false
}
```

{% endtab %}

{% tab title="200 OK" %}

```json
{
    "id": 1245,
    "remainingSize": 8000000,
    "clientOrderId": 123456789,
    "cancelReason": 2,
    "deals": [
        {
            "counterpartyId": 42,
            "id": 23,
            "price": 999900000000,
            "size": 2000000,
            "volume": 19998000000,
            "delta": 0
        }
    ]
}
```

{% endtab %}

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

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

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Market Makers can place a maximum of 30 orders on a single side of the order book.
{% endhint %}

{% hint style="info" %}
There are several execution options for Takers: 

* For **Firm execution** only:

  `qsEnabled` should be =  `false` . `firmBookEnabled` = `true` must be set. 
* For **QS execution** with a specific LP:

  Set `qsEnabled` = `true` and specify `makers` = `[LP's ID]` . `firmBookEnabled` should be = `false` 
* For **automatic selection of the most competitive QS LPs** by FM:

  Set `qsEnabled` = `true` and specify `makers = [Array of LPs' IDs]` . `firmBookEnabled` should be = `false` 
* For **automatic selection of the best price between all available QS and aggregated Firm**:

  Set both `qsEnabled` = `true`  and `firmBookEnabled` = `true` 
  {% endhint %}

**Request parameters**

<table><thead><tr><th>Field name</th><th width="156.66666666666666">Type</th><th>Description</th></tr></thead><tbody><tr><td>instrument</td><td>string</td><td>Instrument name</td></tr><tr><td>clientOrderId</td><td>Efx::ClientOrderId</td><td>User data attached to the order</td></tr><tr><td>price</td><td>Efx::Price</td><td>Order limit price (for postOnly and limit orders)</td></tr><tr><td>size</td><td>Efx::Size</td><td>Order size. If specified - <code>volume</code> shouldn't be used</td></tr><tr><td>volume</td><td>Efx::Size</td><td>Order volume to be filled. Can be used by takers only. If specified - <code>size</code> shouldn't be used. By volume orders may be executed only in the Firm Book. Enabling QS will result into rejected order.</td></tr><tr><td>side</td><td>string</td><td>Order side, use <code>"bid"</code> to buy and <code>"ask"</code> to sell</td></tr><tr><td>type</td><td>string</td><td>Order types <code>"limitIOC"</code>, <code>"limitFOK"</code>, <code>"marketIOC"</code>, <code>"marketFOK"</code> can only be used by market takers. <code>"postOnly"</code> and <code>"limit"</code> can only be used by market makers.</td></tr><tr><td>cod</td><td>boolean</td><td>Cancel On Disconnect flag (will be used only within Web Socket authenticated connection)</td></tr><tr><td>qsEnabled</td><td>boolean</td><td>If true, adds QS as potential sources of liquidity for the order execution. If false or omitted, only Firm Book is considered. Can only be used by takers.<br>Defaults to true when omitted for orders by size and false for orders by volume.</td></tr><tr><td>firmBookEnabled</td><td>boolean</td><td>If true adds Firm Book as a potential source of liquidity for the order execution. If false, only QS are considered. Can only be used by takers.<br>Defaults to true when omitted.</td></tr><tr><td>makers</td><td>Array of Efx::ClientId</td><td>List of LPs to consider QS from. If empty or omitted, all available LPs considered. Taken into account <em><strong>only</strong></em> if qsEnabled == true and does not affect the Firm Book execution. Can only be used by takers.</td></tr></tbody></table>

**Response description**

| Filed name               | Type                 | Description                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| id                       | Efx::OrderId         | New Order Id                                                                                                                                                                                                                                                                                                                                                                               |
| clientOrderId            | Efx::ClientOrderId   | Optional user data attached to the order                                                                                                                                                                                                                                                                                                                                                   |
| remainingSize            | Efx::Size            | Remaining Order size after aggressive deals (if order was placed by size)                                                                                                                                                                                                                                                                                                                  |
| remainingVolume          | Efx::Size            | Remaining Order size after aggressive deals (if order was placed by volume)                                                                                                                                                                                                                                                                                                                |
| cancelReason             | unsigned int16       | <p>Cancel Reason:</p><p>0 - the order is filled <em>(for Takers)</em></p><p>1 - by client <em>(for Market Makers)</em></p><p>2 - the order has been partially filled <em>(for Takers)</em></p><p>3 - by self-trade prevention (not in use)</p><p>4- on disconnect <em>(for Market Makers)</em><br>If "cancelReason" field is missing in response, it means that its value equals to 0.</p> |
| deals                    | array of objects     | Initial (taker) deals                                                                                                                                                                                                                                                                                                                                                                      |
| **Deal**                 |                      |                                                                                                                                                                                                                                                                                                                                                                                            |
| id                       | Efx::DealId          | Deal Id                                                                                                                                                                                                                                                                                                                                                                                    |
| price                    | Efx::Price           | Deal price                                                                                                                                                                                                                                                                                                                                                                                 |
| size                     | Efx::Size            | Deal size                                                                                                                                                                                                                                                                                                                                                                                  |
| volume                   | Efx::Size            | Deal volume                                                                                                                                                                                                                                                                                                                                                                                |
| delta                    | Efx::Size            | Deal delta in quote (balance) currency                                                                                                                                                                                                                                                                                                                                                     |
| counterpartyId           | unsigned int64       | Counterparty id                                                                                                                                                                                                                                                                                                                                                                            |
| counterpartySubaccountId | Efx::ClientId        | Сounterparty Subaccount Id                                                                                                                                                                                                                                                                                                                                                                 |
| liquiditySource          | Efx::LiquiditySource | Liquidity source for the deal (optional). Defaults to the firm book if absent.                                                                                                                                                                                                                                                                                                             |


---

# 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://faq.finerymarkets.com/api-reference/rest-api/trading/adding-orders/add.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.