个股全景(一次拿齐) 在线试调 →

one-shot 个股全景: 行情摘要(近N根不复权日线+区间涨跌幅) / 盘后五档快照 / 最新一期财务 / 行业归属 / 所属板块 / 主题 / 近期事件(龙虎榜·解禁·分红·财报日历), 一次调用拿齐

门槛需要 专业版 及以上

数据各区块复用对应数据面的最新归档; AI/agent 单轮上下文友好

限制单次=单票; 计量1次=1点(不是各端点分别计点)

接口说明

个股全景(一次拿齐):行情摘要(近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"])

输入参数

名称类型必填描述
codestr必填证券代码, 四种写法都认(sh600519/600519/600519.SH/sz.600519)
recent_daysint可选行情摘要取近N根日线, 缺省30, 上限250
sectionsstr可选逗号分隔区块白名单: profile/quote/snapshot/financial/industry/blocks/themes/events; 缺省=全量; code/name/data_as_of 恒返; 被排除区块不做取数; 未知区块400

返回字段

名称类型描述
codestr证券代码(归一后)
namestr证券名称
data_as_ofstr行情最新交易日 YYYY-MM-DD
profiledict基本信息: 名称/市场/类型/状态
quotedict行情摘要: rows=近N根日线(开高低收/量额/换手) + chg_pct_window=区间涨跌幅(%)
snapshotdict盘后五档快照(结构同盘后五档快照端点)
financialdict最新一期财务(fields=字段dict, periods=可用报告期)
industrydict行业归属(三级分类)
blocksdict所属板块清单
themesdict所属主题/题材
eventsdict近期事件: 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%的财务可按需排除)。

认证方式、代码规范、错误码等通用约定见文档首页; 可在在线测试中直接调试本接口。