> 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/qs-stream-management/qs-addstream.md).

# qs/addStream

**POST api/qs/addStream**

Creates a new quote stream, which is required to start quoting. There are two options: specify the taker IDs to receive the stream, or leave it unspecified, making the stream available to all connected counterparties (CPs).

### Request

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

```json
{
  "streamId": <UUID>,
  "instrument": <string>,
  "takers": <array[Efx::ClientId]>
}
```

{% endtab %}

{% tab title="Example" %}

```json
{
  "streamId": "49e6ded7-a402-4169-b766-05fd430601cf",
  "instrument": "BTC-EUR",
  "takers": [2]
}
```

{% endtab %}
{% endtabs %}

#### Request Fields

| Field      | Type                  | Description                                           |
| ---------- | --------------------- | ----------------------------------------------------- |
| streamId   | UUID                  | Stream ID, optional (generated by FM if not provided) |
| instrument | string                | Instrument name, required                             |
| takers     | array\[Efx::ClientId] | Takers allowed to receive this stream, optional       |

### Response

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

```json
{
  "streamId": <UUID>,
  "error": <int>
}
```

{% endtab %}

{% tab title="Example" %}

```json
{
  "streamId": "49e6ded7-a402-4169-b766-05fd430601cf"
}
```

{% endtab %}
{% endtabs %}

#### Response Fields

| Field    | Type | Description                                      |
| -------- | ---- | ------------------------------------------------ |
| streamId | UUID | ID of the created stream, required if successful |
| error    | int  | Error code, required if the request failed       |