# 熱門股單

`GET` `/v1/sharelists/popular`

獲取社區熱門股單列表。

## Parameters

### Query Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `count` | integer | No | 返回數量上限，默認 20 |

## Request Example

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

## Response

### Response Properties

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `sharelists` | object[] | No | 用戶自建股單列表， |
| `└ id` | string | No | 股單 ID |
| `└ subscribers_count` | integer | No | 訂閱人數 |
| `└ stocks_count` | integer | No | 清單內標的數量。 |
| `└ name` | string | No | 標的名稱。 |
| `└ description` | string | No | 描述 |
| `└ cover` | string | No | 封面圖片 URL |
| `└ created_at` | string | No | 創建時間，Unix 時間戳（秒） |
| `└ this_year_chg` | string | No | 今年以來漲跌幅 |
| `└ status` | integer | No | 運行終態：`succeeded` / `interrupted` / `failed` / `stopped` |
| `└ edited_at` | string | No | 最後編輯時間。 |
| `└ digest` | string | No | 簡介。 |
| `└ creator` | object | No | 創建者名稱。 |
| `└ ∟ id` | string | No | 股單 ID |
| `└ ∟ name` | string | No | 標的名稱。 |
| `└ ∟ avatar` | string | No | 作者頭像 URL |
| `└ ∟ member_id` | string | No | 作者 member ID |
| `└ ∟ scopes` | object | No | 訂閱權限資訊 |
| `└ ∟ ∟ followed` | boolean | No | 當前用戶是否已關注。 |
| `└ ∟ ∟ following` | boolean | No | 是否關注創建者。 |
| `└ ∟ ∟ self` | boolean | No | 是否為當前用戶本人。 |
| `└ ∟ ∟ blocked` | boolean | No | 是否被當前用戶屏蔽。 |
| `└ ∟ ∟ special_following` | boolean | No | 是否特別關注。 |
| `└ ∟ ∟ be_blocked` | boolean | No | 當前用戶是否被屏蔽。 |
| `└ ∟ ∟ trade_following` | boolean | No | 是否跟單關注。 |
| `└ ∟ profile_id` | string | No | 資料 ID。 |
| `└ ∟ group_scopes` | object | No | 分組權限範圍。 |
| `└ ∟ ∟ joined` | boolean | No | 是否已加入。 |
| `└ ∟ group_member` | string | No | 是否羣組成員。 |
| `└ ∟ description` | string | No | 描述 |
| `└ ∟ invite_code` | string | No | 邀請碼。 |
| `└ ∟ cert_scopes` | object | No | 認證範圍。 |
| `└ ∟ ∟ official` | boolean | No | 是否官方清單。 |
| `└ ∟ ∟ cert_Info` | object | No | 認證信息。 |
| `└ ∟ ∟ ∟ label` | string | No | 標籤。 |
| `└ ∟ ∟ ∟ name` | string | No | 標的名稱。 |
| `└ ∟ ∟ ∟ desc` | string | No | 當前估值描述 |
| `└ ∟ ∟ ∟ icon` | string | No | 圖標鏈接 |
| `└ ∟ ∟ security_live_info` | string | No | 證券直播信息。 |
| `└ ∟ certification` | boolean | No | 認證。 |
| `└ stocks` | array | No | 成份股列表， |
| `└ subscribed` | boolean | No | 當前用戶是否已訂閱 |
| `└ stock_group_id` | string | No | 股票分組 ID。 |
| `└ last_read_log_id` | string | No | 最後已讀變更日誌 ID。 |
| `└ chg` | string | No | 日漲跌幅 |
| `└ group_id` | string | No | 羣組 ID。 |
| `└ sharelist_type` | integer | No | 類型：`0`=普通，`3`=官方，`4`=行業 |
| `└ industry_code` | string | No | 行業代碼（行業股單適用） |

### Response JSON Example

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "list": [
      {
        "id": 123,
        "name": "AI Picks",
        "description": "Top AI infrastructure stocks"
      },
      {
        "id": 456,
        "name": "EV Leaders",
        "description": "Electric vehicle sector leaders"
      }
    ]
  }
}
```
