Wudao A-Share Stock Data MCP

Name: Wudao A-Share Stock Data MCP
Author: jcdreamjc

by io.github.jcdreamjc

Overview Discussions Admin

Server Details

China A-share data for AI agents: 57 read-only tools plus 6 tools for your own watchlist.

Ownership verified

Status: Healthy
Uptime: 7.2% over 53 days
Last Tested: 2026-10-09 23:37
Transport: Streamable HTTP · MCP 2025-11-25
URL
Repository: jcdreamjc/wudao-mcp
GitHub Stars: 11
Server Listing: Wudao Data A-Share Stock MCP Server

TDQS

A3.6/5.0

Scored 2026-10-08 05:55 across 63 tools

Disambiguation3/5

Descriptions are exceptionally detailed with explicit '何时使用' guidance and cross-references, which helps distinguish many tools. However, several families still overlap significantly (e.g., limit_up_ladder vs limit_up_filter, limit_events vs limit_event_summary, auction_data vs auction_market_scan vs auction_opening_snapshot, official_announcements vs official_disclosure_evidence). An agent must read long instructions carefully to avoid misselection.

Naming Consistency4/5

Nearly all tools use snake_case and follow a predictable noun/verb-based pattern (e.g., limit_up_ladder, stock_screener, watchlist_add). Minor deviation: 'limitup_review_workflow' drops the underscore in 'limitup' compared to the 'limit_up_*' family, but overall conventions are consistent.

Tool Count2/5

63 tools is very heavy for a single server, with many narrow variants of limit-up, auction, and workflow bundles that duplicate lower-level tools. While the domain is broad (A-share, ETF, convertible bonds, SEC, macro, watchlist), the surface is over-extended and would benefit from consolidation.

Completeness5/5

Coverage is extensive: quotes, K-line, minute data, limit-up/down analysis, auction, news, announcements, financials, valuation, shareholder structure, margin, northbound, dragon-tiger, screening, themes, macro calendars, SEC filings, ETF, convertible bonds, and full watchlist CRUD. No obvious lifecycle gaps for a market data and analysis server.

Available Tools

63 tools

anomaly_detection

Read-onlyIdempotent

Inspect

按交易所规则检测个股价格偏离基准指数的异动：3日偏离±20%/±30%（主板/双创），主板风险警示股历史按生效日切换旧/新口径，10日严重异动等，自动区分板块阈值何时使用: 监管口径异动和风险提示；主板风险警示股票按规则生效日自动切换旧/新异常波动口径。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`code`	No	股票代码或名称，例如 600519、600519.SH、贵州茅台。传 code 时查询该股票异动状态。
`date`	No	交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。不传 code 时按日期扫描全市场。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

approaching_limit_up

Read-onlyIdempotent

Inspect

实时监测涨幅接近涨停但尚未封板的个股，盘中捕捉潜在涨停机会何时使用: 仅用于当日盘中冲刺涨停监控，不支持历史日期；盘前/非交易日会返回明确状态而不是空报错。配合 minute_data。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`date`	Yes	必填。交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`maxRowsPerLevel`	No	梯队/榜单每层最多返回行数。不传走档位默认（summary=3，standard=5）。
`includeFirstBoard`	No	是否展开首板明细。不传=false（首板只统计数量）。
`includeReasonInfo`	No	是否返回长文本涨停原因 reasonInfo。不传=false。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

auction_data

Read-onlyIdempotent

Inspect

集合竞价阶段逐笔数据，含历史分位、量比、涨停委买额和 20 分后涨停委买额，开盘前发现异动信号何时使用: 单股/多股集合竞价明细（必须传 code/codes）。全市场排行→auction_market_scan；题材聚合→auction_theme_strength；昨涨停/昨炸板今表现→auction_opening_snapshot。

ParametersJSON Schema

Name	Required	Description
`code`	No	单只股票代码或名称，例如 600519、600519.SH、贵州茅台。返回包含 limitBuyAmount/limitBuyAmountAfter920 等涨停委买字段（若当日命中）。
`codes`	No	多只股票代码或名称，逗号分隔，例如 600519,300750,宁德时代。
`limit`	No	返回数量，默认 20，最大 60。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`end_date`	No	区间结束日期，格式 YYYYMMDD。
`start_date`	No	区间开始日期，格式 YYYYMMDD。
`trade_date`	No	交易日期，格式 YYYYMMDD。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

auction_market_scan

Read-onlyIdempotent

Inspect

全市场按集合竞价金额、涨停委买、封单、涨幅、量比等排序过滤。昨涨停/昨炸板今表现请用 auction_opening_snapshot；题材聚合用 auction_theme_strength。当日 9:25 前会提示未就绪。何时使用: 竞价主扫描器：按强度/成交额/涨停委买/尾秒竞价涨幅/封单等排序过滤。昨涨停与昨炸板反馈用 auction_opening_snapshot；题材线用 auction_theme_strength。未传日期且今天非交易日时按交易日历查询上一交易日并标注实际日期；交易日当日 9:25 前会提示未就绪。

ParametersJSON Schema

Name	Required	Description	Default
`pool`	No	额外票池过滤。limit_up_prev=只看昨涨停；non_limit_up_prev=剔除昨涨停；broken_limit_up_prev=只看昨真炸板池。昨涨停/昨炸板今表现请用 auction_opening_snapshot。	all
`codes`	No	可选。自定义票池（最多 100 只）。常见用法：先调用 dragon_tiger / limit_up_filter 拿到票池，再传给本工具看竞价反馈。
`limit`	No	返回 top N，默认 30，最大 100。
`order`	No	排序方向，默认 desc。asc 用于扫低开/萎缩。	desc
`format`	No	content[0].text：standard/raw 默认 JSON 明细；summary 默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`market`	No	市场范围，默认 all。	all
`preset`	No	一键预设场景；与 filters 同时传时 filters 优先级更高。hot_open=高开放量；low_open_heavy=低开放量（取自昨涨停池）；percentile_breakout=竞价额历史分位 ≥90 突破。昨涨停/昨炸板今表现请用 auction_opening_snapshot。
`sortBy`	No	排序字段，默认 bidStrength（市值归一化竞价强度，跨市值对比首选）。常用：limitBuyAmount=9:25 涨停委买额终值，用于"竞价委买/涨停委买排行"；openBidPct=9:25 开盘价相对 09:24 最后一笔有效竞价价格的尾秒涨跌幅；limitBuyAmountAfter920=9:20 后涨停委买额；finalSealAmount=最近落库封单截面，用于"封单排行"。其他：bidAmount（竞价成交额）/ limitBuyStrength（涨停委买强度）/ bidVol（竞价量，股）/ changeRate（竞价涨幅）/ volumeRatio（量比）/ turnoverRate（普通竞价换手）/ bidAmountPercentile（历史分位）/ auctionNetAmount（竞价净额）。	bidStrength
`excludeST`	No	剔除 ST/退市股，默认 true。
`tradeDate`	No	交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。不传时：交易日取今日（9:25 前返回 AUCTION_DATA_NOT_READY）；非交易日按交易日历取上一交易日并标注实际日期。显式日期不自动换日。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`minBidAmount`	No	竞价额下限（元），默认 500 万。异动场景建议拉到 1000 万 (1e7)。
`maxChangeRate`	No	竞价涨幅上限（%）。
`maxOpenBidPct`	No	尾秒竞价涨幅上限（%）；筛尾秒撤退可设 -0.5。
`minChangeRate`	No	竞价涨幅下限（%）。
`minOpenBidPct`	No	尾秒竞价涨幅下限（%）；09:25 开盘价相对 09:24 最后一笔有效竞价价格。筛尾秒抢筹可设 0.5。
`minPercentile`	No	竞价额历史分位下限（0-100）。需 sortBy=bidAmountPercentile 或 preset=percentile_breakout 自动启用。
`recent60dHigh`	No	是否要求"非近 60 日高点"。默认不限制。
`minBidStrength`	No	归一化竞价强度下限（‱，万分之）。
`minVolumeRatio`	No	量比下限。
`recent20dGainMax`	No	近 20 日累计涨幅上限（%）。低位首板候选场景建议 ≤15。
`minLimitBuyAmount`	No	9:25 涨停委买额终值下限（元），用于筛选竞价定盘后涨停价位委买资金。
`excludePrevLimitUp`	No	剔除昨日涨停股，找"新异动"场景常用。默认 false。
`minFinalSealAmount`	No	最近落库封单截面下限（元），用于筛选封单较大的涨停股票；该字段不保证等同当前实时封单。
`minAuctionNetAmount`	No	竞价净额下限（元）。
`minLimitBuyAmountAfter920`	No	09:20 后涨停委买额下限（元），用于筛选撤单限制阶段仍有涨停价位委买资金的股票。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

auction_opening_snapshot

Read-onlyIdempotent

Inspect

一次返回六个固定竞价视图：竞价涨停、竞价跌停、涨停委买额前 N、竞价成交额前 N、昨日炸板今表现、昨日涨停今表现。每行保留完整竞价字段，适合开盘后快速复盘和生成观察名单。何时使用: 竞价全景快照：一次返回八个固定视图——竞价涨停、竞价跌停、涨停委买额前 N、竞价成交额前 N、9:25 尾秒抢筹、9:25 尾秒撤退、昨日炸板今表现、昨日涨停今表现；每行保留完整竞价字段。未传日期且今天非交易日时按交易日历查询上一交易日并标注实际日期；显式日期不自动换日。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`limit`	No	六个全市场桶返回 top N：竞价涨停、竞价跌停、涨停委买额、竞价成交额、尾秒抢筹、尾秒撤退。默认 30，最大 100。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`prevDate`	No	对比的昨日。不传则自动取 tradeDate 的上一交易日。
`excludeST`	No	是否剔除 ST/退市股，默认 true。
`tradeDate`	No	交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。不传时：交易日取今日（9:25 前返回 AUCTION_DATA_NOT_READY）；非交易日按交易日历取上一交易日并标注实际日期。显式日期不自动换日。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`prevPoolLimit`	No	昨日炸板今表现、昨日涨停今表现两个反馈池的返回上限。默认 200，最大 300。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

auction_theme_strength

Read-onlyIdempotent

Inspect

默认按开盘啦题材聚合集合竞价表现，也可显式切到 CLS 概念或行业；输出竞价额、平均涨幅、高开数量、龙头候选和一致性；支持传 codes 只看自选股/观察池内部的主线强度。何时使用: 题材集合竞价强度聚合：把全市场或自定义票池竞价数据按开盘啦题材/CLS 概念/行业聚合，默认开盘啦题材口径，回答"今天竞价资金打哪条主线"、"我的自选股里哪个方向最强"。未传日期且今天非交易日时按交易日历查询上一交易日并标注实际日期；显式日期不自动换日。

ParametersJSON Schema

Name	Required	Description	Default
`codes`	No	可选。自定义票池（最多 100 只）。传入自选股/观察池后，仅在这些股票内部聚合题材强度；9:25 后可小票池冷算。
`limit`	No	返回 top N 题材，默认 20，最大 50。
`format`	No	content[0].text：standard/raw 默认 JSON 明细；summary 默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`tradeDate`	No	交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。不传时：交易日取今日（9:25 前返回 AUCTION_DATA_NOT_READY）；非交易日按交易日历取上一交易日并标注实际日期。显式日期不自动换日。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`themeSource`	No	题材分类口径，默认 kpl=开盘啦题材；可传 kpl/theme、cls/concept、industry。	kpl
`minBidAmount`	No	成员股入榜门槛（元），默认 500 万。
`minMemberCount`	No	题材至少有几只成员入榜才纳入聚合，默认 3。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

board_break_analysis

Read-onlyIdempotent

Inspect

短线复盘核心面板：昨涨停 × 今日行情交叉。回答"昨涨停今天断板的、昨连板今天没板、高标杀、断板后是退潮还是分歧、晋级/淘汰率、市场是退潮还是修复"。返回 breakRate（断板率）、avgBrokenPctChg、sentimentSignal=cooling/neutral/warming、highBoardBroken 高标杀名单、statusBreakdown 细分。focus=broken/sealed_again/all。何时使用: 断板分析（短线复盘核心面板）：昨涨停 × 今日行情交叉。短线高频问法直接命中："昨天涨停今天断板的有哪些"、"昨天连板今天没板的"、"高标(≥3 板)有没有被杀"、"断板后是直接低开退潮还是分歧高开低走"、"昨日连板淘汰率"、"今天市场是退潮还是修复"。返回 summary.breakRate（断板率）、avgBrokenPctChg（平均跌幅）、sentimentSignal=cooling/neutral/warming（直接给出退潮信号）、highBoardBroken（高标杀名单）、statusBreakdown（限跌/深跌/分歧失败/红盘弱续细分）。focus=broken 默认（只看断板）；sealed_again（只看续板成功）；all（两者）。minStreak=3 只看高标；theme 按题材过滤。

ParametersJSON Schema

Name	Required	Description	Default
`focus`	No	视角。broken=只看断板（默认，最常问的复盘视角）；sealed_again=只看续板成功的；all=两者都要。	broken
`limit`	No	返回最大条数，默认 100，最大 300。
`theme`	No	题材关键词（reason_type / kpl_theme / kpl_lu_desc / jiuyangongshe_category_name 任一字段模糊匹配）。例如 "机器人"、"AI"。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`prevDate`	No	对比的昨日。不传则自动取 tradeDate 的上一交易日。
`minStreak`	No	昨日至少 N 连板才纳入分析。1=昨日所有涨停（默认）；2=2 板以上；3=只看高标（≥3 板）。
`tradeDate`	No	查询的交易日期（今日），支持 YYYY-MM-DD 或 YYYYMMDD。不传则取最近交易日。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

briefings

Read-onlyIdempotent

Inspect

AI 生成的每日市场简报（早盘/午盘/收盘/晚间），快速了解当日要点何时使用: AI 生成的每日早/午/收盘/晚盘简报。

ParametersJSON Schema

Name	Required	Description
`date`	No	简报日期，格式 YYYY-MM-DD；不传默认今天。
`type`	No	简报类型。支持 opening/open/morning/premarket/pre_market（均映射早盘）、midday、closing、evening 等后端已有类型；不传返回全部。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

broken_limit_up

Read-onlyIdempotent

Inspect

实时获取当日曾触及涨停但未能封住的炸板股列表，含最高封单和开板次数何时使用: 炸板池，判断市场分歧；配合 limit_stats。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`date`	Yes	必填。交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`maxRowsPerLevel`	No	梯队/榜单每层最多返回行数。不传走档位默认（summary=3，standard=5）。
`includeFirstBoard`	No	是否展开首板明细。不传=false（首板只统计数量）。
`includeReasonInfo`	No	是否返回长文本涨停原因 reasonInfo。不传=false。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

capital_flow

Read-onlyIdempotent

Inspect

资金流向：个股/大盘/北向=东财日频四档；盘中个股主力用 intraday_main_flow；板块资金请优先 theme_intraday_capital（本工具 flowType=sector 仅兼容，东财板块传 sectorSource=dongfang）何时使用: 资金流：个股/大盘/北向=东财日频四档。板块资金请直接用 theme_intraday_capital；本工具 flowType=sector 仅兼容（默认等同 theme_*，东财板块传 sectorSource=dongfang）。盘中个股主力用 intraday_main_flow。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`date`	No	交易日期，支持 YYYY-MM-DD 或 YYYYMMDD；可选。个股/大盘/北向与东财板块为日频资金流；开盘啦板块为盘中题材资金快照日期。
`limit`	No	返回数量，默认 10。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`keyword`	No	可选。flowType=sector 且开盘啦口径时，按题材名/代码模糊过滤。
`flowType`	No	资金流类型，默认 market。stock=个股，sector=板块，market=大盘，hsgt=沪深港通/北向。	market
`stockCode`	No	flowType=stock 单股查询：代码或名称，例如 600519、贵州茅台。
`sectorType`	No	仅 sectorSource=dongfang 时有效：板块类型，默认概念。常用：概念、行业、地域。	概念
`stockCodes`	No	flowType=stock 批量查询：代码或名称数组，例如 ["600519","000001"]。上限 20 只。多股资金流横向比较时优先用 stockCodes。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`sectorSource`	No	【兼容】板块资金请优先直接调 theme_intraday_capital。本参数仅在 flowType=sector 时有效：默认 kpl 内部复用 theme_*；dongfang/dc=东财日频 moneyflow_ind_dc。	kpl

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

cls_news

Read-onlyIdempotent

Inspect

实时电报快讯原文，支持按关键词、股票、消息级别、时间范围过滤。用于盘前消息面复盘、盘中利好利空跟踪、个股相关消息查证。何时使用: 实时电报快讯：实时滚动的快讯原文，支持按关键词/股票/级别/时间过滤。短线盘前复盘、盘中消息面跟踪、个股利好利空查证的核心信息源。每条结果带 ref 字段（markdown 超链接格式），回答时直接将 ref 值嵌入正文作为可点击引用，不要另列 References 段落。

ParametersJSON Schema

Name	Required	Description	Default
`date`	No	日期，YYYY-MM-DD 格式，默认今天。支持 today/yesterday。与 hoursAgo 互斥，hoursAgo 优先。
`level`	No	消息级别过滤。A=重大突发，B=重要，AB=A+B级，all=全部。默认 all。	all
`limit`	No	返回条数，默认 30，最大 100。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endTime`	No	时间范围终点 HH:mm，配合 date 使用。用户说"盘前消息"时填"09:25"。
`keyword`	No	内容关键词，支持逗号分隔多个。用户说"关于华为的消息"时填"华为"，说"芯片或半导体相关"时填"芯片,半导体"。
`hoursAgo`	No	最近N小时内的消息。优先级高于 date。用户说"最近2小时消息"时填 2。
`startTime`	No	时间范围起点 HH:mm，配合 date 使用。用户说"盘前消息"时填"06:00"。
`stockCode`	No	股票代码，匹配快讯关联股票字段。如 600519、000001。
`stockName`	No	股票名称，模糊匹配快讯内容和关联股票。如"贵州茅台"。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

convertible_bond_market

Read-onlyIdempotent

Inspect

查询可转债搜索、正股映射、实时快照、涨幅/成交额排行、日线、分钟线和转股溢价率。可转债是独立资产，不要当作股票涨停或股票筛选工具使用。何时使用: 可转债行情工具：查转债搜索、正股映射、实时快照、涨幅/成交额排行、日线、分钟线和转股溢价率。不要把可转债当股票涨停工具使用。

ParametersJSON Schema

Name	Required	Description	Default
`code`	No	可选。单个可转债代码；等价于 symbols 单元素。
`mode`	No	查询模式，默认 snapshot。search=搜索可转债；snapshot=实时快照；rank=排行；daily=日线；minute=分钟线。	snapshot
`limit`	No	返回数量，snapshot 默认 30，rank 默认 50；日线/分钟默认返回尾部窗口。
`order`	No	排序方向，默认 desc。	desc
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`period`	No	minute 模式周期，默认 1m。	1m
`sortBy`	No	rank/snapshot 排序字段，默认 pctChg；可选 pctChg/amount/close/vol/conversionPremiumRate/premiumRate。	pctChg
`endDate`	No	可选。daily 模式结束日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`keyword`	No	可选。名称/代码/分类关键词。search 模式按关键词搜索；snapshot/rank 模式用于过滤。
`symbols`	No	可选。可转债代码，数组或逗号分隔字符串。daily/minute 模式建议显式传入。
`startDate`	No	可选。daily 模式起始日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`tradeDate`	No	可选。交易日期，支持 YYYY-MM-DD 或 YYYYMMDD；daily/minute 模式可指定日期。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`forceRefresh`	No	调试用。true 时绕过共享结果缓存；指数实时模式仍只读取最新落盘快照，不会由用户请求触发现场刷新。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

dragon_tiger

Read-onlyIdempotent

Inspect

龙虎榜买卖席位详情。按游资名/营业部追踪请用 branchSearch（不要用 stockName），如 branchSearch="炒股养家" 会通过 BranchTag 反查自动扩展到对应营业部；startDate+endDate 支持区间扫描（如某游资最近一周操作轨迹）；stockCode 查个股席位。何时使用: 龙虎榜席位和机构/活跃资金。重要：「按游资名/营业部追踪」必须用 branchSearch 参数，不要用 stockName（stockName 只搜股票名）。例：查"炒股养家最近一周操作"用 branchSearch="炒股养家"+startDate/endDate（支持 BranchTag 标签反查，会自动扩展到对应营业部）；查"三亚迎宾路上榜没"用 branchSearch="三亚迎宾路"；查"某票谁在做"用 stockCode。配合 limit_up_ladder。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`date`	No	龙虎榜日期，格式 YYYY-MM-DD。与 startDate/endDate 二选一。
`page`	No	页码，默认 1。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endDate`	No	区间结束日期。
`pageSize`	No	每页数量，默认 50，最大 100。
`startDate`	No	区间开始日期。追踪某游资近期操作时和 endDate + branchSearch 配合使用。
`stockCode`	No	股票代码或名称。
`stockName`	No	股票名称关键词（只搜股票）。注意：搜游资/营业部请用 branchSearch，不要用这里。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`branchSearch`	No	【按游资/营业部搜索请用这个，不是 stockName】关键词支持：①营业部名称（如"东方财富证券拉萨"、"三亚迎宾路"）；②BranchTag 游资名/标签（如"炒股养家"、"一线游资"、"溧阳路"），后端会反查所有打了该 tag 的营业部并一起搜。配合 startDate+endDate 追踪某游资近期操作轨迹。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

etf_market

Read-onlyIdempotent

Inspect

查询 ETF 搜索、实时快照、涨幅/成交额排行、日线和分钟线。ETF 是独立资产，不要把 ETF 条件查询改用 stock_screener。何时使用: ETF 行情工具：查 ETF 搜索、实时快照、涨幅/成交额排行、日线和分钟线。不要把 ETF 塞进 stock_screener。

ParametersJSON Schema

Name	Required	Description	Default
`code`	No	可选。单个ETF代码；等价于 symbols 单元素。
`mode`	No	查询模式，默认 snapshot。search=搜索ETF；snapshot=实时快照；rank=排行；daily=日线；minute=分钟线。	snapshot
`limit`	No	返回数量，snapshot 默认 30，rank 默认 50；日线/分钟默认返回尾部窗口。
`order`	No	排序方向，默认 desc。	desc
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`period`	No	minute 模式周期，默认 1m。	1m
`sortBy`	No	rank/snapshot 排序字段，默认 pctChg；可选 pctChg/amount/close/vol。	pctChg
`endDate`	No	可选。daily 模式结束日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`keyword`	No	可选。名称/代码/分类关键词。search 模式按关键词搜索；snapshot/rank 模式用于过滤。
`symbols`	No	可选。ETF代码，数组或逗号分隔字符串。daily/minute 模式建议显式传入。
`startDate`	No	可选。daily 模式起始日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`tradeDate`	No	可选。交易日期，支持 YYYY-MM-DD 或 YYYYMMDD；daily/minute 模式可指定日期。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`forceRefresh`	No	调试用。true 时绕过共享结果缓存；指数实时模式仍只读取最新落盘快照，不会由用户请求触发现场刷新。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

financial_summary

Read-onlyIdempotent

Inspect

聚合利润表、资产负债表、现金流量表、财务指标、审计意见和主营构成，形成个股基本面摘要何时使用: 营收/利润/现金流/ROE/审计/主营构成；纯短线问题不用。

ParametersJSON Schema

Name	Required	Description
`code`	Yes	必填。股票代码或名称，例如 600519、600519.SH、贵州茅台。
`limit`	No	返回财报期数，默认 8，最大 20。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endDate`	No	可选。财务区间结束日期，支持 YYYY-MM-DD 或 YYYYMMDD；默认今天。
`sections`	No	可选展开：audit/segments。不传=核心财务摘要。
`startDate`	No	可选。财务区间开始日期，支持 YYYY-MM-DD 或 YYYYMMDD；默认近三年。
`embedStock`	No	是否回完整 stock 档案（行业/地区/交易所等）。不传=false。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

index_market

Read-onlyIdempotent

Inspect

查询指数搜索、实时快照、涨幅/成交额排行、日线和分钟线。实时快照、排行和当日分钟线读取站内持续落盘数据，不会因单次调用现场冷取；用于三大指数、宽基指数、行业指数点位和走势分析。两市成交额及量能变化直接读取 summary.marketTurnover 或 marketTurnoverSeries；市场宽度仍使用 market_overview。何时使用: 指数行情工具：查三大指数/宽基/行业指数点位、涨跌幅、成交额排行、日线和分钟线。用户问"两市成交额/沪深成交额/全市场成交额/量能变化"时用 summary.marketTurnover 或 marketTurnoverSeries；不要自行混加不同 amountScope 的指数行，也不要用 market_overview 或 short_term_emotion 代替。

ParametersJSON Schema

Name	Required	Description	Default
`code`	No	可选。单个指数代码；等价于 symbols 单元素。
`mode`	No	查询模式，默认 snapshot。search=搜索指数；snapshot=实时快照；rank=排行；daily=日线；minute=分钟线。	snapshot
`limit`	No	返回数量，snapshot 默认 30，rank 默认 50；日线/分钟默认返回尾部窗口。
`order`	No	排序方向，默认 desc。	desc
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`period`	No	minute 模式周期，默认 1m。	1m
`sortBy`	No	rank/snapshot 排序字段，默认 pctChg；可选 pctChg/amount/close/vol。	pctChg
`endDate`	No	可选。daily 模式结束日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`keyword`	No	可选。名称/代码/分类关键词。search 模式按关键词搜索；snapshot/rank 模式用于过滤。
`symbols`	No	可选。指数代码，数组或逗号分隔字符串。daily/minute 模式建议显式传入。
`startDate`	No	可选。daily 模式起始日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`tradeDate`	No	可选。交易日期，支持 YYYY-MM-DD 或 YYYYMMDD；daily/minute 模式可指定日期。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`forceRefresh`	No	调试用。true 时绕过共享结果缓存；指数实时模式仍只读取最新落盘快照，不会由用户请求触发现场刷新。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

intraday_main_flow

Read-onlyIdempotent

Inspect

查询盘中个股主力资金快照，支持自选股/指定代码池过滤。口径为开盘红盘中主力净额，不是传统四档大/中/小单资金流；用户问盘中主力、大单、竞价主力净额时优先使用。何时使用: 盘中个股主力资金：开盘红口径，不是传统四档大/中/小单资金流。用户问自选股/指定股票盘中主力净额、大单净额、竞价主力净额时优先用它；不要改用 capital_flow。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`codes`	No	可选。股票代码池，数组或逗号分隔字符串；适合传自选股/观察池后只看这些股票的盘中主力资金。
`limit`	No	返回数量，默认 30，最大 300。
`order`	No	排序方向，默认 desc。	desc
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`sortBy`	No	排序字段，默认 mainNetAmount。可选 mainNetAmount/mainBuyAmount/mainSellAmount/auctionMainNetAmount/auctionMainBuyAmount/auctionMainSellAmount。	mainNetAmount
`keyword`	No	可选。股票名称或代码关键词过滤。
`tradeDate`	No	交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。不传默认最近交易日/今日盘中缓存。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

kline

Read-onlyIdempotent

Inspect

获取个股日K线数据，盘中实时融合最新行情，支持自定义天数范围；adjust=qfq 可返回前复权价格，默认 none 不复权何时使用: 日K线原子工具：返回指定股票或批量股票的 OHLC、涨跌幅、成交额 amount（元）、换手率等历史序列；适合计算区间涨幅、阶段高低点、价格分位、放量倍数等窗口型条件。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`code`	No	单股查询：股票/指数代码或名称，例如 600519、600519.SH、贵州茅台。返回按日期升序的日K序列，包含 open/high/low/close、涨跌幅、成交额 amount（元）、换手率等字段。
`days`	No	K 线天数，默认 15。窗口型条件要传足够天数，例如计算 120 日区间位置时传 121+。
`codes`	No	批量查询：代码或名称数组，例如 ["600519","000001","平安银行"]。上限 20 只。多股同时分析时优先使用 codes 而不是逐股调用；适合给事件池候选批量补历史价格、成交额、区间高低点。
`adjust`	No	复权方式：none=不复权（默认）；qfq=前复权。当前不支持 hfq 后复权。qfq 使用本地昨收参考价因子并以查询截止日定基，可覆盖现金分红、送转、配股等参考价变化且不会引入截止日之后的公司行为；返回时仍应检查 qualityWarnings。	none
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endDate`	No	可选。历史截止日期，支持 YYYY-MM-DD 或 YYYYMMDD，返回该日期（含当天）及之前的 K 线；事件日分析应传事件发生日期，不传则取最新交易日/盘中实时合并数据。
`maxRows`	No	每只股票 rows 最多返回多少根K线。不传默认返回最近60根；因子/窗口计算需要100+根时可传100/120，上限150。days 也必须同步传足；codes 较多时仍可能触发全局响应预算截断，建议分批。
`embedStock`	No	是否回完整 stock 档案（行业/地区/交易所等）。不传=false。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

limit_down

Read-onlyIdempotent

Inspect

实时获取当日跌停股池，含跌停原因、封单金额等，识别市场恐慌情绪何时使用: 跌停池和负反馈分析。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`date`	Yes	必填。交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`maxRowsPerLevel`	No	梯队/榜单每层最多返回行数。不传走档位默认（summary=3，standard=5）。
`includeFirstBoard`	No	是否展开首板明细。不传=false（首板只统计数量）。
`includeReasonInfo`	No	是否返回长文本涨停原因 reasonInfo。不传=false。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

limit_events

Read-onlyIdempotent

Inspect

实时推送涨停封板和炸板事件，精确到秒级时间戳，适合盘中监控何时使用: 秒级封/炸事件流。仅当用户明确要求实时事件或最新封板时使用，否则用 limit_up_ladder。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`type`	No	事件类型，当前仅支持 limit_up 封板/炸板事件。跌停池请使用 limit_down 工具。	limit_up
`limit`	No	返回最近事件数量，默认 50，最大 500。
`order`	No	事件排序，默认 desc 返回最新事件优先；asc 返回开盘后最早事件优先。	desc
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`sinceTime`	No	可选。仅返回该时间之后的事件，格式按上游事件 time 字段，例如 14:30:00。
`eventTypes`	No	可选。按上游事件 type 过滤，多个用英文逗号分隔。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

limit_event_summary

Read-onlyIdempotent

Inspect

聚合封板/炸板事件流，提炼首封最早、炸板最多、回封最多、尾盘事件和分时情绪拐点何时使用: 盘中分歧/炸板潮/尾盘事件/反复回封等过程分析；普通复盘不需要。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`topN`	No	各榜单返回数量，默认 10，最大 50。
`type`	No	事件类型，当前仅支持 limit_up 涨停封板/炸板事件。跌停池请使用 limit_down 工具。	limit_up
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`coreOnly`	No	是否只保留多次封/炸或封单额较高的核心事件股票，默认 false。
`tailStart`	No	尾盘事件起始时间，默认 14:30:00。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`bucketMinutes`	No	分时统计桶宽，默认 30 分钟，范围 5-120。
`maxRowsPerLevel`	No	梯队/榜单每层最多返回行数。不传走档位默认（summary=3，standard=5）。
`includeFirstBoard`	No	是否展开首板明细。不传=false（首板只统计数量）。
`includeReasonInfo`	No	是否返回长文本涨停原因 reasonInfo。不传=false。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

limit_stats

Read-onlyIdempotent

Inspect

实时涨跌停统计：封板数、炸板数、封板率、今日vs昨日对比，量化市场强度何时使用: 权威涨跌停/炸板/封板率口径；历史交易日优先读取本地收盘统计，盘前/非交易日返回明确状态。配合 market_overview 和 limit_up_ladder。

ParametersJSON Schema

Name	Required	Description
`date`	Yes	必填。交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

limit_up_filter

Read-onlyIdempotent

Inspect

涨停事件池原子工具：按日期/区间筛选涨停记录，支持连板数、开盘啦主类题材、涨停原因、行业、流通市值/总市值、涨停日成交额、封单额、换手率、炸板次数、首封时间、回封标签等事件字段。返回记录可作为 kline、valuation_snapshot、stock_screener 等后续原子工具的候选池；给用户描述封板时间时优先使用 firstLimitUpTimeText/lastLimitUpTimeText。何时使用: 涨停事件池原子工具：按日期/区间返回涨停记录，可筛连板数、题材/原因/行业、流通市值/总市值、涨停日成交额 trading_amount（元）、封单额、换手率、炸板次数、首封时间、回封标签。返回 rows 保留 date/code/name 及事件字段，适合作为后续 kline/valuation_snapshot/stock_screener 的候选池；给用户描述封板时间时优先读 firstLimitUpTimeText/lastLimitUpTimeText。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`date`	No	单日筛选日期，支持 YYYY-MM-DD 或 YYYYMMDD。与 startDate/endDate 二选一使用。
`page`	No	页码，默认 1。
`limit`	No	每页数量，默认 20，最大 100。需要完整事件池时结合 pagination.totalPages 翻页。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`sortBy`	No	排序字段，默认 continue_num。常用：continue_num、first_limit_up_time、last_limit_up_time、currency_value、total_market_cap、actual_currency_value、order_amount、trading_amount、turnover_rate、open_num。	continue_num
`endDate`	No	区间结束日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`pattern`	No	跨日模式匹配。break_then_limit_up=反包板（T-2涨停、T-1断板、T涨停）。传此参数时常规筛选条件（reasonType、continueNum 等）不生效，仅 date/startDate/endDate、breakMode、includePatternContext 有效。
`industry`	No	行业名称关键词。模糊匹配。
`breakMode`	No	断板口径，配合 pattern 使用。not_limit_up=T-1未涨停（默认）；close_negative=T-1收跌；failed_limit_up=T-1炸板。	not_limit_up
`changeTag`	No	change_tag 精确匹配。FIRST_LIMIT=首次涨停；LIMIT_BACK=涨停回落后又涨停（回封/反包）。
`sortOrder`	No	排序方向，默认 desc。	desc
`startDate`	No	区间开始日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`openNumMax`	No	最大开板/炸板次数。0=只要一字板/未炸；≥3 可筛烂板。
`openNumMin`	No	最小开板/炸板次数。0=未炸板（一字/T字板），≥1=炸板回封；与 changeTag=LIMIT_BACK 互补使用。
`reasonType`	No	涨停简要原因关键词（reason_type 字段），例如光伏、AI、机器人。模糊匹配。
`conceptTags`	No	按连板天梯同口径的开盘啦主类题材筛选，多个词用逗号/分号/空格分隔；旧分类、行业和涨停原因仅作缺失兜底。例：conceptTags="华为,先进封装"。
`continueNum`	No	精确连板数，例如 2 表示 2 连板。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`continueNumMax`	No	最大连板数。
`continueNumMin`	No	最小连板数。1=首板，≥2=连板。
`maxOrderAmount`	No	最大封单额（元）。
`minOrderAmount`	No	最小封单额（元）。例：1e8 表示封单过亿，强势板常用。
`conceptTagsMode`	No	conceptTags 多标签匹配模式。any=任一标签命中主类即返回（默认）；all=每个标签都要命中解析后的主类。	any
`maxRowsPerLevel`	No	梯队/榜单每层最多返回行数。不传走档位默认（summary=3，standard=5）。
`maxTurnoverRate`	No	最大换手率（%）。例：5 表示换手率 <5%（缩量板场景）。
`minTurnoverRate`	No	最小换手率（%）。
`currencyValueMax`	No	最大流通市值 currency_value（元）。例：5e9 表示 50 亿；小市值筛选场景常用。
`currencyValueMin`	No	最小流通市值 currency_value（元）。例：5e9 表示 50 亿。
`maxTradingAmount`	No	最大涨停日成交额 trading_amount（元）。
`minTradingAmount`	No	最小涨停日成交额 trading_amount（元）。例：1e10 表示成交额 100 亿。
`includeFirstBoard`	No	是否展开首板明细。不传=false（首板只统计数量）。
`includeReasonInfo`	No	是否返回长文本涨停原因 reasonInfo。不传=false。
`totalMarketCapMax`	No	最大总市值 total_market_cap（元）。
`totalMarketCapMin`	No	最小总市值 total_market_cap（元）。例：5e10 表示 500 亿。
`firstLimitUpTimeAfter`	No	首次封板时间不早于（含）此时间点，格式 HH:mm 或 HH:mm:ss。例："14:30"=尾盘板。兼容 Unix / HHmmss / HH:mm:ss 三种存储格式。
`includePatternContext`	No	是否返回反包上下文（T-2连板数/原因、T-1涨跌幅等），默认 true。
`actualCurrencyValueMax`	No	最大实际流通市值 actual_currency_value（元）。
`actualCurrencyValueMin`	No	最小实际流通市值 actual_currency_value（元）。
`firstLimitUpTimeBefore`	No	首次封板时间不晚于（含）此时间点，格式 HH:mm 或 HH:mm:ss。例："10:00"=10 点前封板的早盘强势板。兼容库内 Unix 时间戳 / HHmmss / HH:mm:ss 三种存储格式。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

limit_up_ladder

Read-onlyIdempotent

Inspect

实时按连板高度分层展示涨停股，清晰呈现当日连板梯队结构和晋级路径何时使用: 涨停梯队、连板高度、龙头结构；返回 primaryThemeStats 表示按开盘啦主类聚合的涨停题材排行；配合 limit_stats、dragon_tiger。行内 firstLimitUpTime/lastLimitUpTime 是原始时间字段，给用户描述封板时间时优先读 firstLimitUpTimeText/lastLimitUpTimeText。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`date`	Yes	必填。交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`maxRowsPerLevel`	No	梯队/榜单每层最多返回行数。不传走档位默认（summary=3，standard=5）。
`includeFirstBoard`	No	是否展开首板明细。不传=false（首板只统计数量）。
`includeReasonInfo`	No	是否返回长文本涨停原因 reasonInfo。不传=false。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

limit_up_premium

Read-onlyIdempotent

Inspect

统计涨停股次日溢价收益排行，量化打板策略的盈亏比和成功率何时使用: 涨停次日溢价和历史胜率统计；不能单独作实时信号。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`page`	No	页码，默认 1。
`limit`	No	每页数量，默认 20。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`sortBy`	No	排序字段，默认 avgPremium。常用：avgPremium、winRate、limitUpCount。	avgPremium
`endDate`	Yes	必填。统计区间结束日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`sortOrder`	No	排序方向，默认 desc。	desc
`startDate`	Yes	必填。统计区间开始日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`minLimitUpCount`	No	最少涨停样本数，默认 5。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

limitup_review_workflow

Read-onlyIdempotent

Inspect

一键生成涨停板复盘数据包：涨跌停统计、涨停梯队、涨停主类排行、炸板池、跌停池，可选涨停溢价统计。何时使用: 一键涨停复盘：涨跌停统计/梯队/题材/炸板/跌停。默认 digest。盘中事件分析问题再开 includeEventSummary。

ParametersJSON Schema

Name	Required	Description
`date`	No	复盘交易日期，支持 YYYY-MM-DD 或 YYYYMMDD；不传默认今天。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endDate`	No	涨停溢价统计结束日期，includePremium=true 时使用。
`startDate`	No	涨停溢价统计开始日期，includePremium=true 时使用。
`returnMode`	No	digest=仅 stepDigest 摘要+nextActions（默认）；structured=各子步骤完整 data；rawSteps=完整 step 调试。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`includeBroken`	No	是否包含炸板池和跌停池，默认 true。
`includePremium`	No	是否在 startDate/endDate 存在时包含涨停溢价统计，默认 false。
`includeEventSummary`	No	Agent 自动判断。是否额外分析封板/炸板事件流，默认 false。仅当问题关注盘中封板过程、情绪拐点、炸板潮、尾盘事件、反复开板回封或实时监控时开启。普通涨停复盘不需要。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

macro_calendar

Read-onlyIdempotent

Inspect

查询全球宏观财经日历，覆盖经济数据、央行/机构事件、国家/货币维度；适合回答未来几天有哪些重要经济数据或宏观事件。何时使用: 宏观财经日历：查询未来/指定日期的全球经济数据和宏观事件，支持国家、货币、关键词过滤。适合"未来几天有哪些重要经济数据/央行事件"；不覆盖全部产业大会和产品发布。

ParametersJSON Schema

Name	Required	Description
`date`	No	指定单日，支持 YYYY-MM-DD 或 YYYYMMDD。与 startDate/endDate 二选一。
`limit`	No	返回数量，默认 50，最大 100。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`country`	No	国家过滤，例如中国、美国、欧元区、日本。
`endDate`	No	区间结束日期，支持 YYYY-MM-DD 或 YYYYMMDD。不传默认未来 14 天。
`keyword`	No	事件关键词模糊匹配，例如非农、CPI、PMI、利率、GDP。
`currency`	No	货币过滤，例如 CNY、USD、EUR、JPY。
`startDate`	No	区间开始日期，支持 YYYY-MM-DD 或 YYYYMMDD。不传默认今天。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`minImportance`	No	重要性下限，0-3。例如 2 表示只看较重要事件。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

margin_trading

Read-onlyIdempotent

Inspect

查询融资融券市场汇总或个股明细。传 code 返回 margin_detail，不传 code 返回交易所汇总 margin；支持 tradeDate 或 startDate/endDate。何时使用: 融资融券：不传 code 返回交易所汇总，传 code 返回个股融资融券明细。用于判断杠杆资金拥挤、融资余额变化和券源/融券压力。

ParametersJSON Schema

Name	Required	Description
`code`	No	可选。股票代码或名称；传入则返回个股融资融券明细，不传则返回交易所汇总。
`limit`	No	返回数量，默认 60，最大 200。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endDate`	No	区间结束日期。
`startDate`	No	区间开始日期。
`tradeDate`	No	单日交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。与 startDate/endDate 二选一。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

market_catalyst_calendar

Read-onlyIdempotent

Inspect

查询政策会议、行业大会、产品发布、指数调整、经济数据和假日等未来催化事件。适合回答"未来几天有什么短线催化/大会/发布会/政策生效"。何时使用: 短线催化日历：查询政策会议、行业大会、产品发布、指数调整、重要经济数据和假日等未来催化事件。用户问"未来几天有什么短线催化/大会/发布会/政策生效/行业会议"时优先使用；不是上市公司公告原文。

ParametersJSON Schema

Name	Required	Description
`date`	No	指定单日，支持 YYYY-MM-DD 或 YYYYMMDD。与 startDate/endDate 二选一。
`type`	No	事件类型：all/0=全部；economic/1=经济数据；event/2=事件/产业催化；holiday/3=假日。默认 all。
`limit`	No	返回数量，默认 50，最大 120。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`country`	No	国家/地区过滤，例如中国、美国、日本、中国台湾。
`endDate`	No	区间结束日期，支持 YYYY-MM-DD 或 YYYYMMDD。不传默认未来 14 天。
`keyword`	No	标题关键词过滤，例如发布会、大会、论坛、指数、华为、机器人。
`minStar`	No	快讯星级下限，通常 1-5；例如 5 只看高星事件。
`startDate`	No	区间开始日期，支持 YYYY-MM-DD 或 YYYYMMDD。不传默认今天。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

market_overview

Read-onlyIdempotent

Inspect

实时全市场涨跌家数、市场温度计等大盘宽度数据；涨跌停/炸板口径请使用 limit_stats 何时使用: 实时全市场涨跌家数、市场温度计等大盘宽度（开盘啦）。不传日期时，交易日默认今日，非交易日按交易日历自动取上一交易日并标注 fallback；交易日开市前若尚未就绪返回 MARKET_SUMMARY_NOT_READY，不冒充昨收。涨跌停/炸板口径请用 limit_stats。

ParametersJSON Schema

Name	Required	Description
`date`	No	可选。交易日期，格式 YYYY-MM-DD；不传时交易日默认今日，非交易日按交易日历自动取上一交易日并标注 fallback。交易日盘前今日数据未就绪时明确报错，不冒充昨日。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

market_replay_workflow

Read-onlyIdempotent

Inspect

一键生成 A 股市场复盘数据包：交易日判断、市场概况、涨跌停统计、涨停梯队、涨停主类排行、概念排行和每日简报；股票/资讯热榜默认不跑，可按需开启。何时使用: 一键 A 股复盘：温度/宽度/涨跌停/梯队/题材/简报。默认 digest。问题问到题材为什么热时再开 includeHotlist。

ParametersJSON Schema

Name	Required	Description
`date`	No	复盘交易日期，支持 YYYY-MM-DD 或 YYYYMMDD；不传默认今天，并会先调用 trading_calendar 辅助判断。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`returnMode`	No	digest=仅 stepDigest 摘要+nextActions（默认）；structured=各子步骤完整 data；rawSteps=完整 step 调试。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`includeHotlist`	No	Agent 自动判断。是否包含股票热榜和资讯热榜，默认 false。仅当问题关注多平台热度、新闻关注度、热门讨论或题材为什么热时开启。
`includeBriefing`	No	是否包含每日简报，默认 true。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

minute_data

Read-onlyIdempotent

Inspect

获取个股实时或指定交易日分时走势，含价格、均价和成交量；历史日期优先读取单股归档何时使用: 个股分时路径：盘中查实时走势；历史查询传 tradeDate，优先读取“单票+交易日”归档。

ParametersJSON Schema

Name	Required	Description
`code`	Yes	必填。股票代码或名称，例如 600519、600519.SH、贵州茅台。返回个股实时或指定交易日分时走势。
`ndays`	No	分时天数，默认 1；指定 tradeDate 时只返回该交易日。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`tradeDate`	No	可选。指定历史交易日，支持 YYYY-MM-DD 或 YYYYMMDD；优先读取“单票+交易日”长期归档，不回退成当天实时走势。
`embedStock`	No	是否回完整 stock 档案（行业/地区/交易所等）。不传=false。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

news_hotlist

Read-onlyIdempotent

Inspect

聚合全网热点与财经媒体热榜，观察资讯关注度和潜在题材线索。何时使用: 资讯热榜：全网/财经媒体热点话题排行；用于观察消息面温度和潜在题材线索。

ParametersJSON Schema

Name	Required	Description	Default
`limit`	No	返回数量，默认 30，最大 100。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`category`	No	资讯类别，默认 financial。general=全网热点，financial=财经资讯，all=全部。单平台榜单时可不传。	financial
`platform`	No	资讯热榜平台，默认 combined 综合热榜；可选 douyin=抖音、weibo=微博、baidu=百度、toutiao=今日头条、eastmoney=东方财富、ths=同花顺、sina=新浪财经、yicai=第一财经。	combined
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

northbound_holdings

Read-onlyIdempotent

Inspect

查询沪深股通持股明细。传 code 返回个股北向持股历史，不传 code 可按日期查看全市场明细；marketType 可选 SH/SZ。何时使用: 北向持股：沪深股通个股持股和全市场持股明细。用于判断外资持仓变化，注意数据通常下个交易日更新。

ParametersJSON Schema

Name	Required	Description
`code`	No	可选。股票代码或名称；传入则返回个股沪深股通持股历史，不传可按日期查全市场明细。
`limit`	No	返回数量，默认 100，最大 500。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endDate`	No	区间结束日期。
`startDate`	No	区间开始日期。
`tradeDate`	No	单日交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。与 startDate/endDate 二选一。
`marketType`	No	可选。沪深股通市场过滤，常用 SH/SZ；不传不限。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

official_announcements

Read-onlyIdempotent

Inspect

查询上市公司正式公告。默认读取站内记录；支持 keywords 多关键词一次检索并返回 matchedKeywords；verificationMode=live 较慢，仅用于用户明确要求官网实时核验；verificationMode=auto 会先查站内记录，缺失时再补查官网。何时使用: 查上市公司正式公告。默认使用站内记录；支持 keywords 多关键词并行检索；只有用户明确要求官网实时核验/站内记录缺失补查时才切到实时或自动核验。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`code`	No	股票代码或名称，例如 601991、大唐发电、601991.SH。与 stock/stockCode/keywordStock 任传其一。
`days`	No	相对回看天数，默认 30。传 startDate 时优先 startDate。
`page`	No	页码，默认 1。
`limit`	No	返回数量，默认 20，最大 100。
`stock`	No	股票代码或名称，例如 601991、大唐发电、601991.SH。与 stockCode/code/keywordStock 任传其一。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endDate`	No	公告结束日期，格式 YYYY-MM-DD；不传默认今天。
`keyword`	No	公告标题/正文关键词。兼容单关键词调用；多关键词优先用 keywords。
`category`	No	官方实时查询类型别名，通常不必传。
`keywords`	No	多关键词并行检索，数组或逗号/顿号分隔字符串，例如 ["算力","数据中心","火电"]。最多 10 个；返回 rows 会标注 matchedKeywords。
`maxPages`	No	实时核验或自动补查时最多检查页数，默认 1，最大 20。
`startDate`	No	公告开始日期，格式 YYYY-MM-DD；不传默认近 30 天。
`stockCode`	No	股票代码或名称，例如 601991、大唐发电、601991.SH。与 stock/code/keywordStock 任传其一。
`stockName`	No	公司简称关键词。
`pageColumn`	No	巨潮栏目/市场筛选，通常不必传。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`keywordMode`	No	多关键词匹配方式：any=命中任一关键词（默认）；all=同一条记录需命中全部关键词。	any
`keywordStock`	No	股票代码或名称别名。
`announcementType`	No	公告类型筛选，通常不必传。
`verificationMode`	No	核验模式：default=站内记录（默认、最快）；live=官网实时核验（较慢，仅用户明确要求时使用）；auto=先查站内记录，无结果再实时核验。	default

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

official_disclosure_evidence

Read-onlyIdempotent

Inspect

给定股票，聚合官方公告和官方互动问答，返回单股官方证据包。默认读站内记录；支持 keywords 多关键词证据包；verificationMode=auto 会先查站内记录，缺失时再补官网；verificationMode=live 较慢，仅用于明确要求。何时使用: 给单股同时返回公告和官方互动问答证据包。默认使用站内官方证据；支持 keywords 多关键词证据包；自动核验会先查站内记录，缺失时再补官网。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`code`	No	必填。股票代码或名称，例如 601991、大唐发电、601991.SH。与 stock/stockCode 任传其一。
`days`	No	相对回看天数，默认 30。传 startDate 时优先 startDate。
`limit`	No	每类证据返回数量，默认 10，最大 30。
`stock`	No	必填。股票代码或名称，例如 601991、大唐发电、601991.SH。与 stockCode/code 任传其一。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endDate`	No	证据结束日期，格式 YYYY-MM-DD；不传默认今天。
`keyword`	No	公告/问答关键词，例如算电协同、低空经济、重大合同。兼容单关键词调用；多关键词优先用 keywords。
`keywords`	No	多关键词证据包检索，数组或逗号/顿号分隔字符串，例如 ["算力","数据中心","火电"]。最多 10 个；返回记录会标注 matchedKeywords。
`maxPages`	No	实时核验或自动补查时最多检查页数，默认 2，最大 20。
`startDate`	No	证据开始日期，格式 YYYY-MM-DD；不传默认近 30 天。
`stockCode`	No	必填。股票代码或名称，例如 601991、大唐发电、601991.SH。与 stock/code 任传其一。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`keywordMode`	No	多关键词匹配方式：any=命中任一关键词（默认）；all=同一条记录需命中全部关键词。	any
`interactionScope`	No	互动问答范围：all=深交所+上交所，szse=互动易，sse=上证 e 互动。	all
`verificationMode`	No	核验模式：default=站内记录（默认、最快）；live=官网实时核验（较慢，仅用户明确要求时使用）；auto=先查站内记录，无结果再实时核验。	default

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

official_interactions

Read-onlyIdempotent

Inspect

查询深交所互动易和上证 e 互动问董秘数据。默认读取站内记录；支持 keywords 多关键词一次检索并返回 matchedKeywords；verificationMode=live 较慢，仅用于用户明确要求官网实时核验；verificationMode=auto 会先查站内记录，缺失时再补查官网。何时使用: 查官方互动问答（深交所互动易/上证 e 互动）。默认使用站内记录；支持 keywords 多关键词并行检索；只有用户明确要求官网实时核验/站内记录缺失补查时才切到实时或自动核验。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`code`	No	股票代码或名称，例如 601991、大唐发电、601991.SH。与 stock/stockCode/keywordStock 任传其一。
`days`	No	相对回看天数，默认 30。传 startDate 时优先 startDate。
`page`	No	页码，默认 1。
`limit`	No	返回数量，默认 20，最大 100。
`stock`	No	股票代码或名称，例如 601991、大唐发电、601991.SH。与 stockCode/code/keywordStock 任传其一。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`status`	No	回复状态：all/answered/unanswered。默认 all。	all
`endDate`	No	问题结束日期，格式 YYYY-MM-DD；不传默认今天。
`keyword`	No	问答内容关键词。兼容单关键词调用；多关键词优先用 keywords。
`exchange`	No	交易所筛选：SZSE 或 SSE。通常可不传，由股票代码推断。
`keywords`	No	多关键词并行检索，数组或逗号/顿号分隔字符串，例如 ["算力","数据中心","火电"]。最多 10 个；返回 rows 会标注 matchedKeywords。
`maxPages`	No	实时核验或自动补查时最多检查页数，默认 1，最大 20。
`startDate`	No	问题开始日期，格式 YYYY-MM-DD；不传默认近 30 天。
`stockCode`	No	股票代码或名称，例如 601991、大唐发电、601991.SH。与 stock/code/keywordStock 任传其一。
`stockName`	No	公司简称关键词。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`keywordMode`	No	多关键词匹配方式：any=命中任一关键词（默认）；all=同一条记录需命中全部关键词。	any
`keywordStock`	No	股票代码或名称别名。
`interactionScope`	No	互动问答范围：all=深交所+上交所，szse=互动易，sse=上证 e 互动。	all
`verificationMode`	No	核验模式：default=站内记录（默认、最快）；live=官网实时核验（较慢，仅用户明确要求时使用）；auto=先查站内记录，无结果再实时核验。	default

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

research_reports

Read-onlyIdempotent

Inspect

券商研报查询：个股评级、目标价、盈利预测，支持按股票或关键词搜索何时使用: 券商研报和评级；配合 kline、capital_flow。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`page`	No	页码，默认 1。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`sortBy`	No	排序字段，默认 publishDate。	publishDate
`endDate`	No	研报结束日期，格式 YYYY-MM-DD。
`keyword`	No	关键词，例如人工智能、算力、公司简称。
`pageSize`	No	每页数量，默认 10。
`sortOrder`	No	排序方向，默认 desc。	desc
`startDate`	No	研报开始日期，格式 YYYY-MM-DD。
`stockCode`	No	股票代码或名称。可与 keyword 搭配。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

sec_company_facts

Read-onlyIdempotent

Inspect

查询 SEC companyfacts XBRL 财务事实，支持 Revenues、NetIncomeLoss、Assets、EarningsPerShareDiluted 等 us-gaap/dei tags。用于美股财报事实核验。何时使用: SEC companyfacts：按 ticker/CIK 查询 XBRL 财务事实，如 Revenues、NetIncomeLoss、Assets、EarningsPerShareDiluted。适合美股财报事实核验。

ParametersJSON Schema

Name	Required	Description
`cik`	No	SEC CIK，支持带或不带前导 0，例如 0001045810。与 ticker/query 任传其一。
`tag`	No	单个 XBRL tag，例如 Revenues、RevenueFromContractWithCustomerExcludingAssessedTax、NetIncomeLoss、Assets、EarningsPerShareDiluted。
`tags`	No	多个 XBRL tag。不传则返回常用财务事实。
`unit`	No	可选。单位筛选，例如 USD、shares、USD/shares。不传返回该 tag 所有单位。
`limit`	No	返回事实条数，默认 20，最大 80。
`query`	No	公司名或 ticker，无法确定 ticker 时传这里。与 ticker/cik 任传其一。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`ticker`	No	美股 ticker，例如 NVDA、AAPL、TSLA。与 cik/query 任传其一。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

sec_company_search

Read-onlyIdempotent

Inspect

按美股 ticker 或公司名检索 SEC 公司 CIK。查询美国上市公司 10-K/10-Q/8-K/companyfacts 前先用它解析公司。何时使用: SEC 公司检索：按美股 ticker/公司名查 CIK。用户问美股公告、10-K/10-Q/8-K、海外公司财报前先用它解析公司。

ParametersJSON Schema

Name	Required	Description
`limit`	No	返回数量，默认 8，最大 20。
`query`	Yes	必填。美股 ticker 或公司名关键词，例如 NVDA、NVIDIA、Tesla、Apple。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

sec_filings

Read-onlyIdempotent

Inspect

查询美国上市公司最近 SEC filings，支持 10-K、10-Q、8-K、DEF 14A、Form 4、13F-HR 等表单过滤，并返回 SEC 官方 filing URL。何时使用: SEC filings 列表：按 ticker 或 CIK 查询 10-K/10-Q/8-K/DEF 14A/Form 4 等最近披露，并返回官方 filing URL。适合海外公司披露核验和 A 股海外映射。

ParametersJSON Schema

Name	Required	Description
`cik`	No	SEC CIK，支持带或不带前导 0，例如 0001045810。与 ticker/query 任传其一。
`form`	No	可选。披露表单类型，例如 10-K、10-Q、8-K、DEF 14A、4、13F-HR。不传返回全部最近 filing。
`limit`	No	返回数量，默认 10，最大 50。
`query`	No	公司名或 ticker，无法确定 ticker 时传这里。与 ticker/cik 任传其一。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`ticker`	No	美股 ticker，例如 NVDA、AAPL、TSLA。与 cik/query 任传其一。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

sector_analysis

Read-onlyIdempotent

Inspect

板块轮动四象限分析（动量 × 强度），默认开盘啦题材口径；也可切行业/财联社概念何时使用: 板块轮动四象限，默认开盘啦题材口径（source=kpl）；行业用 source=industry；财联社概念兼容 source=cls_concept。配合 theme_intraday_capital / theme_stocks。

ParametersJSON Schema

Name	Required	Description	Default
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`period`	No	分析周期，默认 60。
`source`	No	板块分类口径，默认 kpl=开盘啦题材；可传 kpl/kaipanla、industry（财联社行业）、cls_concept（财联社概念兼容）、theme（站内旧题材）。concept 别名也映射到 kpl。	kpl
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`strengthPeriod`	No	强度周期，默认 5。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

shareholder_structure

Read-onlyIdempotent

Inspect

聚合十大股东、十大流通股东、股东户数、质押、分红和回购数据，观察筹码和公司行为何时使用: 十大股东、户数趋势、质押、分红、回购；配合 valuation_snapshot。

ParametersJSON Schema

Name	Required	Description
`code`	Yes	必填。股票代码或名称。
`limit`	No	十大股东/流通股东返回数量，默认 10，最大 30。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endDate`	No	可选。区间结束日期；默认今天。
`sections`	No	可选展开：top10/floatHolders/holderNumbers/pledge/dividends/repurchases/all。不传=top10+holderNumbers。
`startDate`	No	可选。区间开始日期；默认近三年。
`embedStock`	No	是否回完整 stock 档案（行业/地区/交易所等）。不传=false。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

short_term_emotion

Read-onlyIdempotent

Inspect

查询早盘/盘中短线情绪快照，包含涨跌停、炸板率、晋级率、涨停委买额、一字封单额和市场宽度。用于快速判断短线情绪强弱。turnoverAmountYi 仅是情绪源附带成交额，不是交易所两市成交额；两市成交额请改用 index_market。何时使用: 早盘/盘中短线情绪仪表盘：涨跌停、炸板率、晋级率、涨停委买额、一字封单、市场宽度。盘前数据未开始时返回 status=not_started 与 availableAfter，Agent 应按提示等待而不是循环重试。用户问"今天情绪怎么样/晋级率/封单/炸板率"时优先用它，再下钻 limit_stats/limit_up_ladder。turnoverAmountYi 不是交易所两市成交额；问两市/沪深成交额请改用 index_market。

ParametersJSON Schema

Name	Required	Description
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`tradeDate`	No	交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。不传默认最近交易日/今日盘中缓存。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

smart_hotlist

Read-onlyIdempotent

Inspect

股票热榜：platform 默认 combined 综合热榜；也支持 ths=同花顺、eastmoney=东方财富、tgb=淘股吧、kaipanla=开盘啦等单平台热股排行，返回会保留平台信息。何时使用: 股票热榜：多平台热股关注度排行；不可用作基本面证据或直接因果证据。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`type`	No	兼容旧参数。可作为热榜范围别名；general/financial 会按 combined 处理。
`limit`	No	返回数量，默认 30，最大 100。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`thsType`	No	单平台热榜周期，默认 hour。	hour
`listType`	No	榜单类型，默认 normal。	normal
`platform`	No	股票热榜平台，默认 combined 综合热榜；可选 ths=同花顺、eastmoney=东方财富、tgb=淘股吧、kaipanla=开盘啦。	combined
`stockType`	No	股票市场类型，默认 a。	a
`marketType`	No	市场范围，默认全部。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

stock_event_calendar

Read-onlyIdempotent

Inspect

聚合限售解禁、股东增减持、回购、分红除权和财报披露计划，用于短线排雷、事件驱动和盘前风险检查；不是宏观财经日历/产业大会日历。eventTypes 支持 unlock/holder_trade/repurchase/dividend/disclosure。何时使用: 公司事件/风险日历：聚合限售解禁、股东增减持、回购、分红除权、财报披露计划。短线用途是排雷、解释事件驱动和盘前风险检查；不是宏观财经日历/产业大会日历。

ParametersJSON Schema

Name	Required	Description
`code`	No	可选。股票代码或名称；不传则查询全市场公司事件。注意：这是公司事件/风险日历，不是宏观财经日历或产业大会日历。
`limit`	No	返回事件数，默认 80，最大 300。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endDate`	No	事件结束日期，支持 YYYY-MM-DD 或 YYYYMMDD；不传默认未来 180 天。
`startDate`	No	事件开始日期，支持 YYYY-MM-DD 或 YYYYMMDD；不传默认近 90 天。
`eventTypes`	No	事件类型过滤：unlock=限售解禁；holder_trade=股东增减持；repurchase=回购；dividend=分红除权；disclosure=财报披露计划。数组或逗号分隔字符串。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

stock_rank

Read-onlyIdempotent

Inspect

实时涨幅榜、跌幅榜、成交额榜、换手率榜等多维排行，盘中实时刷新何时使用: 全市场涨跌幅/成交金额/换手榜 + 盘中异动榜；参数用 type（或别名 rankType），支持 gainers/losers/amount 等，盘中异动用 speed_5m/speed_down_5m/amount_5m（5分钟涨速/跌速/成交额，分钟级更新）；changePercent/pctChange/涨幅榜会软映射到 gainers。返回 rows[] 附带前复权 change3d/change5d/change10d/change20d，普通多周期强弱比较不要重复调用多个 N 日榜；配合 theme_intraday_capital 找题材。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`type`	No	排行类型，默认 gainers。支持 gainers、losers、amount、turnover_rate、volume_ratio、intraday_drawdown、intraday_profit、overnight_drawdown、overnight_profit，也支持 gainers_Nd / losers_Nd；盘中异动榜：speed_5m=5分钟涨速、speed_down_5m=5分钟跌速、amount_5m=5分钟成交额（全市场分钟截面，metricValue 为窗口涨速%/成交额元，meta 带 momentumWindow）；volume 为旧兼容别名，实际等同 amount 成交金额榜；返回行会附带前复权 change3d/change5d/change10d/change20d。	gainers
`limit`	No	返回数量，默认 20，最大 200。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`market`	No	市场范围，默认 all。常用：all、sh、sz、cyb、kcb。	all
`rankType`	No	type 的别名（agent 常误用 rankType）。与 type 二选一，等价。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

stock_research_workflow

Read-onlyIdempotent

Inspect

一键生成个股研究数据包：股票搜索、K 线、个股资金流、研报、龙虎榜，并可附带估值、财务摘要和股东结构。何时使用: 一键个股研究：K 线/资金流/研报/龙虎榜，可选估值/财务/股东。默认 digest。短线场景可关 includeFundamental。

ParametersJSON Schema

Name	Required	Description
`code`	Yes	必填。股票代码或名称，例如 600519、600519.SH、贵州茅台。
`days`	No	K 线天数，默认 30。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`returnMode`	No	digest=仅 stepDigest 摘要+nextActions（默认）；structured=各子步骤完整 data；rawSteps=完整 step 调试。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`includeFundamental`	No	Agent 自动判断。是否包含估值、财务摘要和股东结构，默认 true。中长线/基本面研究保持 true；短线盘口、涨停、龙虎榜或资金流问题可设为 false。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

stock_screener

Read-onlyIdempotent

Inspect

MCP 主条件选股工具：支持概念/题材、行业、地区、股票名称包含、价格、市值、收盘涨跌幅、盘中最高/最低涨幅、开盘涨幅、换手、成交额、PE/PB、均线位置、放量倍数、市场板块和 ST/上市状态过滤。用户用问财式自然语言提条件时，agent 应直接映射为本工具结构化参数再调用。何时使用: MCP 主条件选股工具。conceptKeywords/conceptCodes 默认开盘啦题材库（conceptSource=kpl）；未命中可设 conceptSource=auto 回退东财/CLS。用户用问财式自然语言提条件时，agent 应先把语义直接映射到本工具 schema 参数再调用，例如"半导体板块、五日线之上、放量三倍、上海、名字带龙"→conceptKeywords/aboveMa/volumeRatioMin/areaKeywords/nameIncludes；"收盘涨幅超过7"→closePctChgMin:7；"盘中最高涨幅超过7/最高到过7以上"→highPctChgMin:7。不要在 agent 侧分批拼 concept_stocks+kline+valuation_snapshot。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`date`	No	筛选交易日，支持 YYYY-MM-DD 或 YYYYMMDD。不传默认取最新已落库交易日；非交易日会使用此前最近有数据的交易日并返回时效提示。
`codes`	No	股票代码票池，数组或逗号分隔字符串。传入后只在该票池内做条件筛选。常见用法：先用 limit_up_ladder/broken_limit_up 拿到事件池，再传给本工具做二次筛选。支持6位代码或带后缀格式。
`limit`	No	返回数量，默认 50，最大 300。
`pbMax`	No	PB 上限。
`pbMin`	No	PB 下限。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`maMode`	No	多条均线匹配方式：all=全部满足（默认）；any=任一满足。	all
`market`	No	市场范围，默认 all。支持 all/main/sh/sz/gem/cyb/star/kcb/bse/bj。	all
`sortBy`	No	排序字段，默认 volumeRatio。常用：volumeRatio、closePctChg、highPctChg、lowPctChg、openPctChg、close、amountYi、turnoverRate、totalMarketCapYi、circMarketCapYi、marketCapYi、peTtm、pb。	volumeRatio
`aboveMa`	No	要求收盘价站上指定均线，支持 5/10/20/30/60/90/250。用户说"五日线之上/站上5日线/突破20日均线"时填 [5] 或 [20]；"5日和10日线之上"填 [5,10]。
`belowMa`	No	要求收盘价低于指定均线，支持 5/10/20/30/60/90/250。
`peTtmMax`	No	PE(TTM) 上限。
`peTtmMin`	No	PE(TTM) 下限。
`priceMax`	No	收盘价上限（元）。用户说"价格10到20/股价低于20元"时填 20。
`priceMin`	No	收盘价下限（元）。用户说"价格10到20/股价10元以上"时填 10。
`excludeST`	No	是否剔除 ST/退市风险名称，默认 true。
`sortOrder`	No	排序方向，默认 desc。	desc
`listStatus`	No	上市状态，默认 L=上市；传 all 不限制。	L
`amountMaxYi`	No	成交额上限（亿元）。
`amountMinYi`	No	成交额下限（亿元）。
`conceptMode`	No	多概念匹配模式：any=命中任一概念（默认）；all=同时属于所有概念。	any
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`areaKeywords`	No	公司地区关键词，来自 StockBasic.area。用户说"上海地区/上海公司/注册地上海/位于上海"时填 ["上海"]。
`conceptCodes`	No	题材/概念代码；默认按开盘啦 kplId 或题材名匹配。
`lowPctChgMax`	No	盘中最低涨幅上限（%）。用户说"盘中最低涨幅低于-3/最低跌到-3以下"时填这里。
`lowPctChgMin`	No	盘中最低涨幅下限（%），口径为 (当日最低价 / 昨收价 - 1) * 100。
`nameIncludes`	No	股票名称包含关键词。用户说"名字带龙/名称包含科技/简称含光"时填 ["龙"]、["科技"]、["光"]。
`auctionChgMax`	No	竞价涨幅上限（%）。
`auctionChgMin`	No	竞价涨幅下限（%）。用户说"竞价高开3个点以上"时填 3。
`conceptSource`	No	概念成分口径，默认 kpl=开盘啦题材库；auto=开盘啦优先、未命中回退东财∪CLS；dongfang/cls/legacy 为兼容。	kpl
`highPctChgMax`	No	盘中最高涨幅上限（%）。
`highPctChgMin`	No	盘中最高涨幅下限（%），口径为 (当日最高价 / 昨收价 - 1) * 100。用户说"盘中最高涨幅超过7/最高到过7以上/冲高超过7"时填这里。
`marketCapType`	No	市值口径：total=总市值（默认）；circ=流通市值。用户说"流通市值"时填 circ，否则"市值/总市值"填 total。	total
`openPctChgMax`	No	开盘涨幅上限（%）。用户说"低开2个点以上"时应换算为负数，例如 -2。
`openPctChgMin`	No	开盘涨幅下限（%），口径为 (开盘价 / 昨收价 - 1) * 100。用户说"高开3个点以上/开盘涨幅超过5"时填这里。正数为高开，负数为低开。
`textMatchMode`	No	名称/地区/行业多关键词匹配方式：any=任一命中（默认）；all=全部命中。	any
`volumeAvgDays`	No	成交量均值基准天数，默认 5，最大 60。
`closePctChgMax`	No	收盘涨跌幅上限（%）。用户说"收盘涨幅低于3/跌幅超过5"时应换算为负数，例如 -5。
`closePctChgMin`	No	收盘涨跌幅下限（%），口径为当日收盘价相对昨收/前收的涨跌幅。用户说"收盘涨幅超过7/当日涨跌幅大于3"时填这里。
`marketCapMaxYi`	No	市值上限（亿元）。用户说"市值200到300亿/市值不超过300亿"时填 300。
`marketCapMinYi`	No	市值下限（亿元）。用户说"市值200到300亿/市值200亿以上"时填 200。
`recentNdChgMax`	No	近N日累计涨幅上限（%）。用户说"近20日涨幅不超过15%"时填 15。
`recentNdChgMin`	No	近N日累计涨幅下限（%）。用户说"近5日涨幅超过20%"时填 20。
`volumeRatioMax`	No	放量倍数上限。
`volumeRatioMin`	No	放量倍数下限。口径：最新交易日 vol / 前 volumeAvgDays 个交易日平均 vol，前 N 日不含当日。用户说"放量三倍/量比大于3/成交量是前五日均量3倍以上"时填 3。
`conceptFallback`	No	conceptSource=kpl 时若未命中是否回退东财∪CLS，默认 false。也可用 conceptSource=auto。
`conceptKeywords`	No	开盘啦题材/板块关键词（默认 conceptSource=kpl），数组或逗号分隔字符串。用户说"半导体板块/机器人概念/低空经济题材"时直接填 ["半导体"]、["机器人"]、["低空经济"]。按开盘啦题材库名称模糊匹配。
`recentNdChgDays`	No	近N日涨幅的天数窗口。用户说"近5日涨幅超过20%"时填 5。
`turnoverRateMax`	No	换手率上限（%）。
`turnoverRateMin`	No	换手率下限（%）。
`auctionAmountMin`	No	竞价额下限（元）。用户说"竞价额大于5000万"时填 50000000。
`industryKeywords`	No	StockBasic.industry 行业关键词，数组或逗号分隔字符串。用户明确说"电子行业/软件行业"时填这里；说"半导体板块/机器人概念"优先填 conceptKeywords。
`turnoverRateFMax`	No	实际换手率上限（%）。
`turnoverRateFMin`	No	实际换手率下限（%），基于自由流通股本。短线里比普通换手率更贴近盘口。
`limitUpCountNdMax`	No	近N日涨停次数上限。用户说"很少涨停/基本不涨停"时填 0 或 1。
`limitUpCountNdMin`	No	近N日涨停次数下限。
`freeMarketCapMaxYi`	No	自由流通市值上限（亿元）。
`freeMarketCapMinYi`	No	自由流通市值下限（亿元）。短线实战中比流通市值更准确。
`limitUpCountNdDays`	No	统计涨停次数的天数窗口。用户说"近10日涨停次数不超过1次"时填 10。
`auctionVolumeRatioMin`	No	竞价量比下限。
`auctionTurnoverRateMax`	No	竞价换手率上限。
`auctionTurnoverRateMin`	No	竞价换手率下限（基于流通股本）。
`auctionTurnoverRateFMax`	No	竞价实际换手率上限。
`auctionTurnoverRateFMin`	No	竞价实际换手率下限（基于自由流通股本），单位%。用户说"竞价实际换手大于1%"时填 1。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

stock_search

Read-onlyIdempotent

Inspect

通过股票名称、代码、拼音或行业关键词模糊搜索，快速定位目标股票何时使用: 模糊股票名/拼音/行业/代码解析；结果传给 kline/capital_flow/research_reports 等。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`limit`	No	返回数量，默认 10。
`query`	Yes	必填。搜索关键词，支持股票名称、代码、拼音首字母、行业或地区。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

theme_intraday_capital

Read-onlyIdempotent

Inspect

题材/板块强度与主力资金主入口：默认返回最新快照；mode=timeline 可返回精选题材、概念或行业的盘中资金曲线。问爆发原因/为何走强时传 includeBoomReason=true 读 boomReason。成分股下钻请用 theme_stocks。何时使用: 题材/板块主入口：盘中板块强度与主力资金排行。问"为什么这个板块强/爆发逻辑"时传 includeBoomReason=true 读取 rows[].boomReason（冷门板可能为空，勿编造）。成分下钻用 theme_stocks。不要用 capital_flow(sector) 或已隐藏的 concept_ranking。

ParametersJSON Schema

Name	Required	Description	Default
`mode`	No	返回模式。snapshot=最新快照；timeline=分钟级板块资金曲线。	snapshot
`limit`	No	返回数量。snapshot 默认 30、最大 100；timeline 最大 10。
`order`	No	排序方向，默认 desc。	desc
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`sortBy`	No	排序字段，默认 mainNetAmount。可选 mainNetAmount/bigOrderNetAmount/strength/pctChg/changeSpeed/amount/volumeRatio。	mainNetAmount
`endTime`	No	timeline 可选结束时间，HH:mm。
`keyword`	No	可选。板块名称或代码关键词过滤。
`baseline`	No	timeline 金额基准。open=相对首个时点变化；raw=原始累计净额。	open
`universe`	No	板块范围。featured=精选题材；concept=完整概念；industry=行业。	featured
`startTime`	No	timeline 可选起始时间，HH:mm。
`tradeDate`	No	交易日期，支持 YYYY-MM-DD 或 YYYYMMDD。不传默认最近交易日/今日盘中缓存。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`themeSymbols`	No	可选。板块代码过滤，数组或逗号分隔字符串。
`intervalMinutes`	No	timeline 模式的采样间隔，默认 5 分钟。
`includeBoomReason`	No	是否附加开盘啦板块爆发原因（rows[].boomReason/boomTitle/boomLeaders）。默认 false。用户问"为什么这个板块强/爆发逻辑/催化"时再开；冷门板可能为空，勿编造。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

theme_stocks

Read-onlyIdempotent

Inspect

题材成分股主入口。传入 theme_intraday_capital 的 themeCode（如 801843k）或题材名；返回成分股代码、名称、热度与标签。何时使用: 题材成分股主入口：传 theme_intraday_capital 的 themeCode（如 801843k）或题材名。不要用已隐藏的 concept_stocks。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`kplId`	No	开盘啦题材库数字 ID（可选）。
`limit`	No	返回成分股数量，默认 50，最大 300。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`themeCode`	No	开盘啦盘中板块代码，来自 theme_intraday_capital.rows[].themeCode，例如 801843k。
`themeName`	No	开盘啦题材名称，例如商业航天 / 低空经济。可与 themeCode 二选一；同时传时以能解析到的题材名为准。
`tradeDate`	No	可选。当只用 themeCode 时，用于从当日 theme_intraday_capital 快照反查题材名，格式 YYYYMMDD。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`onlyLimitUp`	No	仅返回题材库标记为涨停的成分股，默认 false。
`syncIfMissing`	No	本地题材库未命中时，是否调用开盘啦 Theme API 搜索并同步，默认 true。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

trading_calendar

Read-onlyIdempotent

Inspect

查询指定日期是否为A股交易日，自动处理节假日和周末何时使用: 周末/节假日前后判断今日是否交易日。

ParametersJSON Schema

Name	Required	Description
`date`	Yes	必填。查询日期，支持 YYYY-MM-DD 或 YYYYMMDD。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

unlock_events

Read-onlyIdempotent

Inspect

查询个股或全市场限售股解禁事件，返回解禁日期、解禁股份、解禁比例、股东和股份类型。适合排查未来解禁压力。何时使用: 限售解禁专项：查全市场或单股未来/历史解禁压力。用户问"明天/下周哪些票解禁"或"这票有没有解禁压力"时使用。

ParametersJSON Schema

Name	Required	Description
`code`	No	可选。股票代码或名称；不传查询全市场解禁。
`limit`	No	返回数量，默认 50，最大 200。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`endDate`	No	解禁结束日期；不传默认未来 365 天。
`startDate`	No	解禁开始日期；不传默认近 30 天。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

valuation_snapshot

Read-onlyIdempotent

Inspect

获取个股最新估值、市值、换手率、股息率等 daily_basic 指标，适合快速判断估值位置何时使用: PE/PB/PS/股息率/市值快照；配合 financial_summary。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`code`	No	单股查询：股票代码或名称，例如 600519、600519.SH、贵州茅台。
`date`	No	可选。估值交易日，支持 YYYY-MM-DD 或 YYYYMMDD；不传则取最近可用交易日。
`codes`	No	批量查询：代码或名称数组，例如 ["600519","000001"]。上限 20 只。多股估值横向比较时优先使用 codes。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`embedStock`	No	是否回完整 stock 档案（行业/地区/交易所等）。不传=false。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

watchlist_add

Idempotent

Inspect

把用户明确指定的股票加入当前 API key 所属用户的私有自选股，支持批量、去重、自动分组、标签和备注。写入工具，仅在用户明确要求加入自选时使用。何时使用: 把用户明确指定的一只或多只股票加入当前 API key 所属用户的自选股。自选总数最多 300 只，每组最多 50 只；同一股票可属于多个组。支持股票名称/代码混输、批量去重、自动分组（连板/首板/题材/行业）和备注标签。只有用户明确要求"加入自选/加到观察池/帮我收藏这些票"时调用。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`note`	No	可选备注。
`tags`	No	可选标签数组，例如 ["机器人","连板观察"]。也兼容逗号分隔字符串。
`codes`	No	兼容字段。逗号/空格分隔的股票代码或名称，例如 "中际旭创,300750,600839"。
`stock`	No	单只股票代码或名称，例如 600519、贵州茅台。与 stocks/codes 任传其一。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`stocks`	No	批量股票代码或名称数组，例如 ["中际旭创","300750","600839"]。单次最多 50 只；自选总数最多 300 只。
`position`	No	加入位置。top=放到自选股最前；bottom=放到末尾。默认 top。	top
`groupName`	No	手动分组名。传入后默认使用该分组。每组最多 50 只股票；同一股票可属于多个组。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`groupStrategy`	No	分组策略。auto=按连板/首板/题材/行业自动分组；manual=使用 groupName；none=不分组。默认：有 groupName 时 manual，否则 auto。
`sourceContext`	No	可选来源上下文，例如"盘后复盘看到承接不错"。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

watchlist_group_create

Idempotent

Inspect

创建当前 API key 所属用户的空自选股分组。写入工具，仅在用户明确要求新增/创建分组时使用。何时使用: 创建当前 API key 所属用户的自选股空分组。自选分组最多 20 个。只有用户明确要求创建/新增分组时调用。

ParametersJSON Schema

Name	Required	Description
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`groupName`	Yes	必填。要创建的自选股分组名。分组名最长 50 字；每个用户最多 20 个自选分组。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

watchlist_group_delete

DestructiveIdempotent

Inspect

删除当前 API key 所属用户的自选股分组。股票仍保留在自选股中，只移出该组。写入工具，仅在用户明确要求删除/清理分组时使用。何时使用: 删除当前 API key 所属用户的自选股分组。股票仍保留在自选股中，只移出该组。只有用户明确要求删除/清理分组时调用。

ParametersJSON Schema

Name	Required	Description
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`groupName`	Yes	必填。要删除的自选股分组名。删除分组不会删除股票，组内股票仍保留在自选股中。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`onlyIfEmpty`	No	true=仅当该分组为空时才删除；false=即使组内有股票也删除分组并保留股票。默认 false。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

watchlist_group_list

Read-onlyIdempotent

Inspect

读取当前 API key 所属用户的自选股分组列表，支持只看空分组。只读工具。何时使用: 读取当前 API key 所属用户的自选股分组列表，可筛空分组。只在用户明确问"我的自选分组/有哪些空组/分组列表"时使用。

ParametersJSON Schema

Name	Required	Description
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`onlyEmpty`	No	是否只返回空分组。用户说"空组/没有股票的组"时传 true。默认 false。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

watchlist_group_rename

Idempotent

Inspect

重命名当前 API key 所属用户的自选股分组，并同步更新该分组内股票。写入工具，仅在用户明确要求改分组名/重命名分组时使用。何时使用: 重命名当前 API key 所属用户的自选股分组，并同步更新组内股票分组名。只有用户明确要求改分组名/重命名分组时调用。

ParametersJSON Schema

Name	Required	Description
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`newGroupName`	Yes	必填。新的自选股分组名。
`oldGroupName`	Yes	必填。原自选股分组名。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

watchlist_list

Read-onlyIdempotent

Inspect

读取当前 API key 所属用户的私有自选股列表，返回分组、标签、备注和最近涨停上下文。只读工具。何时使用: 读取当前 API key 所属用户的自选股列表，可按 groupName 筛选，并返回分组、标签、备注和最近涨停上下文。只在用户明确问"我的自选/自选股列表/观察池"时使用。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`limit`	No	返回数量，默认 200，最大 500。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`groupName`	No	可选。只查看某个自选分组。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`includeLimitUpContext`	No	是否带最近涨停/连板上下文，默认 true。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

watchlist_remove

DestructiveIdempotent

Inspect

从当前 API key 所属用户的私有自选股中移除用户明确指定的股票。写入工具，仅在用户明确要求删除/移除时使用。何时使用: 从当前 API key 所属用户的自选股中移除股票。只有用户明确要求移除/删除自选时调用。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description
`codes`	No	兼容字段。逗号/空格分隔的股票代码或名称。
`stock`	No	单只股票代码或名称。与 stocks/codes 任传其一。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`stocks`	No	批量股票代码或名称数组。最多 50 只。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No

watchlist_update_stock

Idempotent

Inspect

更新当前 API key 所属用户自选股条目的分组、标签、备注或来源上下文。写入工具，仅在用户明确要求移动股票分组、打标签或改备注时使用。何时使用: 更新当前 API key 所属用户自选股条目的分组、标签、备注。groupMode=add 可把股票追加到新分组且保留原分组；replace 才是移动到新分组。适合用户说"把这些票移到某组/打标签/改备注"。【链接】rows/items/嵌套股票对象含 code/name；列股必须用 [name(code)](https://stock.quicktiny.cn/quote/<code>) markdown 链接。

ParametersJSON Schema

Name	Required	Description	Default
`note`	No	新的备注。
`tags`	No	要写入的标签数组。也兼容逗号分隔字符串。
`codes`	No	兼容字段。逗号/空格分隔的股票代码或名称。
`stock`	No	单只股票代码或名称。与 stocks/codes 任传其一。
`format`	No	content[0].text：默认1行 headline；markdown=完整 markdown 表格；json=完整 JSON。
`stocks`	No	批量股票代码或名称数组。最多 50 只。
`groupMode`	No	分组写入模式。add=追加到该组且保留原分组；remove=从该组移除；replace=替换为该单一分组/清空。默认 replace。	replace
`groupName`	No	要写入的分组名。传空字符串且 groupMode=replace 时可清空分组。每组最多 50 只股票。
`detailLevel`	No	档位：默认 standard（Agent 可计算标准字段）；summary=压缩摘要；raw=全字段+原始数据。
`replaceTags`	No	true=用 tags 覆盖原标签；false=追加 tags。默认 true。
`sourceContext`	No	新的来源上下文。

Output Schema

ParametersJSON Schema

Name	Required	Description
`data`	No
`meta`	No
`success`	No