# 股单列表

`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": []
  }
}
```
