# 更新置頂

`POST` `/v1/watchlist/pinned`

在自選股分組中置頂或取消置頂指定證券，以控制顯示順序。

## Parameters

### Request Body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `mode` | string | Yes | 操作模式:`add`(置頂) 或 `remove`(取消置頂) |
| `securities` | array | Yes | 要置頂/取消的證券代碼，如 `["AAPL.US", "700.HK"]`(須已在自選中) |

## Request Example

```bash
curl --request POST \
  --url 'https://openapi.longbridge.com/v1/watchlist/pinned' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{"id":"<id>","symbol":"<symbol>","is_pinned":false}'
```

## Response

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {}
}
```
