F10公司资料
F10公司资料结构化: 股东研究(十大流通股东)/分红扩股/股本结构/财务分析(指标×报告期)/公司概况/高层治理/龙虎榜单(两融/资金流/大宗)/主力追踪(机构持股/股东户数)/资本运作(增发/质押/回购)/经营分析(主营构成)/行业分析/研究报告 等
接口说明
F10 公司资料的结构化读取：公司概况/股本结构/股东研究(十大流通股东)/分红扩股/财务分析/高层治理等栏目。
不传 category 先返回可用栏目清单，再按栏目名取数
做基本面档案、股东变动跟踪、公告要点提取用它
快速调用
同一调用的三种等价写法，按接入习惯任选其一，复制即可运行。
可用栏目清单
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
info = pro.f10(code="sz000001")
print([c["category"] for c in info["categories"]])
十大流通股东(股东研究)
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
data = pro.f10(code="sz000001", category="股东研究")
print(data["data"]["sections"]["股东变化"]["blocks"][0])
分红明细
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
data = pro.f10(code="sz000001", category="分红扩股")
可用栏目清单
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/f10",
headers={"X-API-Key": KEY},
params={"code": "sz000001"},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包
十大流通股东(股东研究)
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/f10",
headers={"X-API-Key": KEY},
params={"code": "sz000001", "category": "股东研究"},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包
分红明细
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/f10",
headers={"X-API-Key": KEY},
params={"code": "sz000001", "category": "分红扩股"},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包
可用栏目清单
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/f10?code=sz000001"
十大流通股东(股东研究)
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/f10?code=sz000001&category=%E8%82%A1%E4%B8%9C%E7%A0%94%E7%A9%B6"
分红明细
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/f10?code=sz000001&category=%E5%88%86%E7%BA%A2%E6%89%A9%E8%82%A1"
输入参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
| code | str | True | 股票代码(仅股票有公司资料) |
| category | str | False | 栏目名, 缺省=返回可用栏目清单; 如 股东研究/分红扩股/财务分析/龙虎榜单 |
| section | str | False | 小节过滤(通用栏目), 如 股东变化/财务指标; 缺省=整栏目 |
返回字段
| 名称 | 类型 | 描述 |
|---|---|---|
| code / name / category | str | 证券代码/名称/栏目 |
| categories | array | 不传category时: 可用栏目清单[{category,updated_at}] |
| data | dict | 公司概况/股本结构=专项扁平结构; 其余={meta,toc,sections:{小节:{blocks:[{type:series|matrix|kv|grid|text}]}}} |
| data.sections.*.blocks[].type=series | object | 指标×日期: {dates:[...], series:{指标:{日期:数值}}}(亿/万已数值化) |
| data.sections.*.blocks[].type=matrix | object | 盒表: {columns:[...], rows:[[...]]} — 十大股东/分红明细/高管列表等 |
| data.sections.*.blocks[].type=kv | object | KV盒表: {键: 值} — 控股股东/最新分红能力等 |
返回数据样例
{
"code": "sz000001",
"name": "平安银行",
"categories": [
{
"category": "业内点评",
"updated_at": "2026-10-06 18:50:58"
},
{
"category": "主力追踪",
"updated_at": "2026-10-06 18:50:58"
},
{
"category": "公司大事",
"updated_at": "2026-10-06 18:50:58"
}
]
}
样例取自平台实时数据，categories共 16 条，样例仅展示前 3 条。
最佳实践：先用不传category的调用拿栏目清单; 大栏目(股东研究/财务分析)内容多, AI Agent 建议再传 section 锁定小节, 省token。