个股全景(一次拿齐) 在线试调 →
one-shot 个股全景: 行情摘要(近N根不复权日线+区间涨跌幅) / 盘后五档快照 / 最新一期财务 / 行业归属 / 所属板块 / 主题 / 近期事件(龙虎榜·解禁·分红·财报日历), 一次调用拿齐
接口说明
个股全景(一次拿齐):行情摘要(近N根日线+区间涨跌幅)、盘后五档快照、最新一期财务、行业归属、所属板块、主题与近期事件(龙虎榜·解禁·分红·财报日历)。
为 LLM/agent 场景设计:单次调用拿到决策所需全部上下文,省去逐端点拼接
顶层 data_as_of=行情最新交易日;各区块独立降级(暂缺时该区块带 note,不影响整体)
行情摘要根数用 recent_days 收口(缺省30,上限250)
快速调用
同一调用的三种等价写法,按接入习惯任选其一,复制即可运行。
个股全景一览
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 安装: pip install top369
ov = pro.overview(code="600519")
print(ov["data_as_of"], ov["quote"]["chg_pct_window"])
print(ov["events"]["report_calendar"]["rows"])
个股全景一览
import requests
API = "https://api.369.top/api"
KEY = "sk-xxxxxxxxxxxx"
r = requests.get(f"{API}/a/stock/overview",
headers={"X-API-Key": KEY},
params={"code": "600519"},
timeout=30)
r.raise_for_status()
data = r.json()["data"] # 信封解包, 本接口数据在 data["blocks"]
个股全景一览
curl -H "X-API-Key: sk-xxxxxxxxxxxx" \ "https://api.369.top/api/a/stock/overview?code=600519"
输入参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| code | str | 必填 | 证券代码, 四种写法都认(sh600519/600519/600519.SH/sz.600519) |
| recent_days | int | 可选 | 行情摘要取近N根日线, 缺省30, 上限250 |
| sections | str | 可选 | 逗号分隔区块白名单: profile/quote/snapshot/financial/industry/blocks/themes/events; 缺省=全量; code/name/data_as_of 恒返; 被排除区块不做取数; 未知区块400 |
返回字段
| 名称 | 类型 | 描述 |
|---|---|---|
| code | str | 证券代码(归一后) |
| name | str | 证券名称 |
| data_as_of | str | 行情最新交易日 YYYY-MM-DD |
| profile | dict | 基本信息: 名称/市场/类型/状态 |
| quote | dict | 行情摘要: rows=近N根日线(开高低收/量额/换手) + chg_pct_window=区间涨跌幅(%) |
| snapshot | dict | 盘后五档快照(结构同盘后五档快照端点) |
| financial | dict | 最新一期财务(fields=字段dict, periods=可用报告期) |
| industry | dict | 行业归属(三级分类) |
| blocks | dict | 所属板块清单 |
| themes | dict | 所属主题/题材 |
| events | dict | 近期事件: lhb_recent龙虎榜(近10次) / restricted_release解禁(近10条) / dividend分红(近10条) / report_calendar财报披露日历(近4条) |
返回数据样例
{
"code": "sz000001",
"profile": {
"code": "sz000001",
"name": "平安银行",
"market": "sz",
"type": "股票",
"found": true
},
"name": "平安银行",
"data_as_of": "2026-11-16",
"quote": {
"code": "sz000001",
"name": "平安银行",
"adjust": "none",
"rows": [
{
"date": "2026-11-10",
"open": 11.83,
"high": 11.88,
"low": 11.73,
"close": 11.86,
"volume": 74888900,
"amount": 884993280.0,
"turnover": 0.39
},
{
"date": "2026-11-11",
"open": 11.83,
"high": 11.86,
"low": 11.7,
"close": 11.71,
"volume": 105703800,
"amount": 1245341440.0,
"turnover": 0.54
},
{
"date": "2026-11-12",
"open": 11.69,
"high": 11.83,
"low": 11.66,
"close": 11.79,
"volume": 108272100,
"amount": 1273354880.0,
"turnover": 0.56
}
],
"chg_pct_window": 3.71
},
"snapshot": {
"code": "sz000001",
"name": "平安银行",
"date": "2026-11-16",
"quote": {
"market": 0,
"code": "000001",
"price": 12.3,
"last_close": 12.07,
"open": 12.06,
"high": 12.3,
"low": 12.05,
"vol": 2170129,
"cur_vol": 24530,
"amount": 2645742592.0,
"s_vol": 935315,
"b_vol": 1234815,
"bid1": 12.29,
"ask1": 12.3,
"bid_vol1": 390,
"ask_vol1": 20464,
"bid2": 12.28,
"ask2": 12.31,
"bid_vol2": 768,
"ask_vol2": 6562,
"bid3": 12.27,
"ask3": 12.32,
"bid_vol3": 2825,
"ask_vol3": 7385,
"bid4": 12.26,
"ask4": 12.33,
"bid_vol4": 1196,
"ask_vol4": 3765,
"bid5": 12.25,
"ask5": 12.34,
"bid_vol5": 1279,
"ask_vol5": 2482,
"speed": 0.08,
"symbol": "sz000001"
}
},
"financial": {
"code": "sz000001",
"fields": {
"EPS": 1.24,
"deductEPS": 1.24,
"undistributedProfitPerShare": 14.8334,
"netAssetsPerShare": 24.13,
"capitalReservePerShare": 4.1445,
"ROE": 4.687,
"operatingCashFlowPerShare": 11.08,
"moneyFunds": 354877014016.0,
"tradingFinancialAssets": 821274017792.0,
"investmentRealEstate": 552000000.0,
"fixedAssets": 10464000000.0,
"intangibleAssets": 5415000064.0,
"goodwill": 7568000000.0,
"deferredIncomeTaxAssets": 50064998400.0,
"totalAssets": 6028785090560.0
},
"periods": [
"20260630",
"20260331",
"20251231"
]
},
"industry": {
"code": "sz000001",
"l1": "银行",
"l2": "全国性银行",
"l3": "股份制银行",
"date": "2026-11-16",
"matched": true
},
"blocks": {
"code": "sz000001",
"blocks": [
"300ESG",
"300周期",
"MSCIA50"
]
},
"themes": {
"symbol": "sz000001",
"total": 1,
"rows": [
{
"theme": "深圳板块",
"symbol": "sz000001",
"cjrq": "2017-05-16",
"gpsl": 433,
"data_date": "2017-05-16"
}
]
},
"events": {
"lhb_recent": {
"code": "sz000001",
"name": "平安银行",
"total": 1,
"rows": [
{
"lhb_date": "2022-11-29",
"type": "日价格涨幅偏离值达到7.86%",
"zf": 9.99,
"bje": 1787780000.0,
"sje": 867841000.0,
"hsl": 2.45
}
]
},
"restricted_release": {
"total": 6,
"rows": [
{
"trade_date": "2018-05-21",
"code": "sz000001",
"name": "平安银行",
"release_date": "2018-05-21",
"shares_wan": 1717040.0,
"reason": "非公开发行限售",
"pct_aux": 25224.8
},
{
"trade_date": "2017-01-09",
"code": "sz000001",
"name": "平安银行",
"release_date": "2017-01-09",
"shares_wan": 1717040.0,
"reason": "非公开发行限售",
"pct_aux": 228681.0
},
{
"trade_date": "2016-05-23",
"code": "sz000001",
"name": "平安银行",
"release_date": "2016-05-23",
"shares_wan": 1430870.0,
"reason": "非公开发行限售",
"pct_aux": 38859.6
}
]
},
"dividend": {
"total": 25,
"rows": [
{
"code": "sz000001",
"fhbgq": "2026-06-30",
"szzs": 0.0,
"ann_date": null,
"ygrq": "2026-08-15",
"ex_date": "2026-09-24"
},
{
"code": "sz000001",
"fhbgq": "2025-12-31",
"szzs": 0.0,
"ann_date": null,
"ygrq": "2026-03-21",
"ex_date": "2026-06-12"
},
{
"code": "sz000001",
"fhbgq": "2025-06-30",
"szzs": 0.0,
"ann_date": null,
"ygrq": "2025-08-23",
"ex_date": "2025-10-15"
}
]
},
"report_calendar": {
"total": 0,
"rows": [],
"note": "该报告期无披露数据"
}
}
}
样例取自平台数据,rows共 5 条,样例仅展示前 3 条;财务字段共 221 个,样例仅展示前 15 个;periods共 120 条,样例仅展示前 3 条;blocks共 31 条,样例仅展示前 3 条;rows共 6 条,样例仅展示前 3 条;rows共 10 条,样例仅展示前 3 条。
最佳实践:为 LLM/agent 场景设计: 单次调用拿到决策所需全部上下文, 省去逐端点拼接; 顶层 data_as_of=行情最新交易日, 各区块独立降级(暂缺时该区块带 note, 不影响整体); 行情摘要根数用 recent_days 收口(缺省30, 上限250); 只要部分区块时用 sections 白名单收口传输(如 sections=quote,snapshot,financial 占全量60%的财务可按需排除)。