> For the complete documentation index, see [llms.txt](https://api-documentation.autoshares.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-documentation.autoshares.dev/rest-api/trading-api/watchlists/add-security-to-watchlist-by-ticker/syntax.md).

# Syntax

## Syntax

### Add security.

```
PUT /v{version}/users/{userId}/watchlists/{watchlistId}/securities
```

#### Description

Adds security to watchlist by security symbol and exchange.

#### Parameters

| Type       | Name                           | Description                  | Schema                                                                      | Default |
| ---------- | ------------------------------ | ---------------------------- | --------------------------------------------------------------------------- | ------- |
| **Header** | **Authorization**   *required* | Bearer type token string     | string                                                                      |         |
| **Header** | **Et-App-Key**   *required*    | Application key              | string                                                                      |         |
| **Path**   | **userId**   *required*        | User identifier              | integer (int32)                                                             |         |
| **Path**   | **version**   *required*       | The requested API version    | string                                                                      | `"1"`   |
| **Path**   | **watchlistId**   *required*   | Watchlist identifier         | integer (int32)                                                             |         |
| **Body**   | **body**   *required*          | Security symbol and exchange | [SecuritySignature](/rest-api/trading-api/definitions.md#securitysignature) |         |

#### Responses

| HTTP Code | Description                                       | Schema                                                                |
| --------- | ------------------------------------------------- | --------------------------------------------------------------------- |
| **200**   | Changed watchlist with securities                 | [WatchlistModel](/rest-api/trading-api/definitions.md#watchlistmodel) |
| **401**   | Authorization has been denied for this request.   | No Content                                                            |
| **403**   | Application key is not defined or does not exist  | No Content                                                            |
| **409**   | Security was not found                            | No Content                                                            |
| **422**   | Validation error occurred while processing entity | No Content                                                            |
| **500**   | Internal server error                             | No Content                                                            |

#### Consumes

* `application/json`
* `text/json`

#### Produces

* `application/json`
* `text/json`