资讯与社区
鉴权
签名方式:每个请求用 App Key / Secret 签名。请求头如下:
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 后台 上的账户 Access Token,作为原始 token 传入(不带 Bearer 前缀),并参与签名计算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 请求时间戳,单位秒(Unix 时间)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 签名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
获取社区热门股单列表。
请求
查询参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
count | integer | 可选 | 返回数量上限,默认 20 |
响应
响应字段
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
sharelists | object[] | 可选 | 用户自建股单列表, |
└ id | string | 可选 | 股单 ID |
└ subscribers_count | integer | 可选 | 订阅人数 |
└ stocks_count | integer | 可选 | 清单内标的数量。 |
└ name | string | 可选 | 标的名称。 |
└ description | string | 可选 | 描述 |
└ cover | string | 可选 | 封面图片 URL |
└ created_at | string | 可选 | 创建时间,Unix 时间戳(秒) |
└ this_year_chg | string | 可选 | 今年以来涨跌幅 |
└ status | integer | 可选 | 运行终态:`succeeded` / `interrupted` / `failed` / `stopped` |
└ edited_at | string | 可选 | 最后编辑时间。 |
└ digest | string | 可选 | 简介。 |
└ creator | object | 可选 | 创建者名称。 |
└ ∟ id | string | 可选 | 股单 ID |
└ ∟ name | string | 可选 | 标的名称。 |
└ ∟ avatar | string | 可选 | 作者头像 URL |
└ ∟ member_id | string | 可选 | 作者 member ID |
└ ∟ scopes | object | 可选 | 订阅权限信息 |
└ ∟ ∟ followed | boolean | 可选 | 当前用户是否已关注。 |
└ ∟ ∟ following | boolean | 可选 | 是否关注创建者。 |
└ ∟ ∟ self | boolean | 可选 | 是否为当前用户本人。 |
└ ∟ ∟ blocked | boolean | 可选 | 是否被当前用户屏蔽。 |
└ ∟ ∟ special_following | boolean | 可选 | 是否特别关注。 |
└ ∟ ∟ be_blocked | boolean | 可选 | 当前用户是否被屏蔽。 |
└ ∟ ∟ trade_following | boolean | 可选 | 是否跟单关注。 |
└ ∟ profile_id | string | 可选 | 资料 ID。 |
└ ∟ group_scopes | object | 可选 | 分组权限范围。 |
└ ∟ ∟ joined | boolean | 可选 | 是否已加入。 |
└ ∟ group_member | string | 可选 | 是否群组成员。 |
└ ∟ description | string | 可选 | 描述 |
└ ∟ invite_code | string | 可选 | 邀请码。 |
└ ∟ cert_scopes | object | 可选 | 认证范围。 |
└ ∟ ∟ official | boolean | 可选 | 是否官方清单。 |
└ ∟ ∟ cert_Info | object | 可选 | 认证信息。 |
└ ∟ ∟ ∟ label | string | 可选 | 标签。 |
└ ∟ ∟ ∟ name | string | 可选 | 标的名称。 |
└ ∟ ∟ ∟ desc | string | 可选 | 当前估值描述 |
└ ∟ ∟ ∟ icon | string | 可选 | 图标链接 |
└ ∟ ∟ security_live_info | string | 可选 | 证券直播信息。 |
└ ∟ certification | boolean | 可选 | 认证。 |
└ stocks | array | 可选 | 成份股列表, |
└ subscribed | boolean | 可选 | 当前用户是否已订阅 |
└ stock_group_id | string | 可选 | 股票分组 ID。 |
└ last_read_log_id | string | 可选 | 最后已读变更日志 ID。 |
└ chg | string | 可选 | 日涨跌幅 |
└ group_id | string | 可选 | 群组 ID。 |
└ sharelist_type | integer | 可选 | 类型:`0`=普通,`3`=官方,`4`=行业 |
└ industry_code | string | 可选 | 行业代码(行业股单适用) |
响应 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"
}
]
}
}错误码
参见错误码文档。