特殊名单
特殊名单三模式(与 themes 的 theme/code 同构): 无参=可用名单目录(名称+成员数); list_name=指定名单全量成员(代码+名称); code=反查个股所属名单
接口说明
特殊名单三模式(与 themes 的 theme/code 同构)：无参=可用名单目录(沪深港通/融资融券/指数成分/专精特新…+成员数)；list_name=指定名单全量成员(代码+名称)；code=反查个股当前所属名单。
名单快照不可变且服务端有缓存，批量取多个名单时不必自己再做本地缓存
判断个别股票是否成分股用 code 反查(一次调用)
快速调用
同一调用的三种等价写法，按接入习惯任选其一，复制即可运行。
有哪些名单
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
df = pro.special_list() # 目录 → list_name/member_count 两列
print(df.sort_values("member_count", ascending=False).head(10))
沪股通全部成员
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
df = pro.special_list(list_name="沪股通")
print(df.head())
个股所属名单反查
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
df = pro.special_list(code="sz000001") # → 单列 list_name
print(df["list_name"].tolist())
有哪些名单
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/special_list",
headers={"X-API-Key": KEY},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
沪股通全部成员
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/special_list",
headers={"X-API-Key": KEY},
params={"list_name": "沪股通"},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
个股所属名单反查
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/special_list",
headers={"X-API-Key": KEY},
params={"code": "sz000001"},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["rows"]
有哪些名单
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/special_list"
沪股通全部成员
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/special_list?list_name=%E6%B2%AA%E8%82%A1%E9%80%9A"
个股所属名单反查
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/special_list?code=sz000001"
输入参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| list_name | str | False | 名单名, 如 沪股通/深股通/港股通/融资融券/中证500; 与code二选一, 都缺省=名单目录; 未知名单404(附可用名单提示) |
| code | str | False | 证券代码(裸码或带前缀): 反查该股当前所属名单(单列list_name); 与list_name二选一 |
| date | str | False | 快照日期 YYYY-MM-DD, 缺省最新 |
返回字段
| 名称 | 类型 | 描述 |
|---|---|---|
| date | str | 实际使用的快照日 |
| lists[].list_name | str | 名单名称(目录模式) |
| lists[].member_count | int | 该名单成员数(目录模式) |
| list_name | str | 名单名(成员模式回显) |
| total | int | 成员数(成员模式) |
| codes | list | 纯代码数组(成员模式, 带市场前缀) |
| rows[].code | str | 证券代码 |
| rows[].name | str | 证券名称(名单含港股等不在 a_code_name 内时为空串) |
| list_names[] | list | 所属名单名称列表(反查模式) |
返回数据样例
{
"date": "2026-09-15",
"list_name": "LOF基金",
"total": 404,
"codes": [
"sh501001",
"sh501005",
"sh501006"
],
"rows": [
{
"code": "sh501001",
"name": ""
},
{
"code": "sh501005",
"name": ""
},
{
"code": "sh501006",
"name": ""
}
],
"note": "名单快照滞后27天(同步链路异常?), 成员时效请自行评估"
}
样例取自平台实时数据，codes共 404 条，样例仅展示前 3 条；rows共 404 条，样例仅展示前 3 条。
最佳实践：快照不可变, 同(快照日,名单)命中服务端缓存, 批量取多个名单不必自己缓存; 判断个别股票是否成分股用 code 反查(1次调用), 批量判断整份名单成分 用 list_name 拿全量; 名单含港股时 name 可能为空串, 以 code 为准。