# 股單列表

`GET` `/v1/sharelists`

獲取當前用戶創建的或訂閱的所有社區自選股列表。

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | string | No | 篩選：`mine`（我創建的）或 `subscribed`（我訂閱的），不傳則返回兩者 |

## Request Example

```bash
curl --request GET \
  --url 'https://openapi.longbridge.com/v1/sharelists' \
  --header 'Authorization: Bearer <access_token>'
```

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `sharelists` | object[] | No | 用戶自建股單列表，見 SharelistInfo |
| `subscribed_sharelists` | object[] | No | 已訂閱股單列表，見 SharelistInfo |
| `tail_mark` | string | No | 已訂閱列表的分頁遊標 |
| `id` | integer | Yes | 股單 ID |
| `description` | string | No | 描述 |
| `cover` | string | No | 封面圖片 URL |
| `subscribers_count` | integer | No | 訂閱人數 |
| `chg` | string | No | 日漲跌幅 |
| `this_year_chg` | string | No | 今年以來漲跌幅 |
| `subscribed` | boolean | No | 當前用戶是否已訂閱 |
| `sharelist_type` | integer | No | 類型：`0`=普通，`3`=官方，`4`=行業 |
| `industry_code` | string | No | 行業代碼（行業股單適用） |
| `symbol` | string | Yes | 證券代碼 |
| `code` | string | No | 股票代碼 |
| `market` | string | No | 市場 |
| `intro` | string | No | 簡介 |
| `last_done` | string | No | 最新價格 |
| `change` | string | No | 日漲跌幅 |
| `trade_status` | integer | No | 交易狀態碼 |
| `latency` | boolean | No | 是否為延遲行情數據 |
| `unread_change_log_category` | string | No | 未讀變更日誌分類 |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "mine": [
      {
        "id": 15921,
        "name": "AI Picks",
        "type": "Regular",
        "day_change": "-0.40",
        "ytd_change": "6.64",
        "subscribers": 500
      }
    ],
    "subscribed": []
  }
}
```
