WorkBuddy PandaData 数据源覆盖
本技能在 WorkBuddy 专家包中运行时,所有实时和历史金融数据必须来自已连接的
pandadata Connector。若下文、参考资料或脚本提到 Python panda_data SDK、
AkShare、Tushare、网页抓取、直连 HTTP 或本地凭证,以本节为准:不得使用这些
方式获取正式数据。
- 数据型任务必须先完成
auth_status 和至少一次真实的 call_pandadata 业务调用;在收到
Connector 返回前,禁止输出分析、排名、数字结论或“无数据”。本 Skill 的流程不得绕过
主 Agent 的最低接口调用清单。
- 先按本 Skill 的
references/pandadata-interface-contracts.md 选择已登记方法和参数。只要任务能映射到已登记接口,
就直接通过 call_pandadata 传入该业务方法和 params;常规调用前不得执行接口检索。
- 仅当已登记方法被 Connector 明确报告为参数契约不兼容、字段契约变化或调用失败时,
才对该方法调用一次
get_method_doc,修正参数后最多重试一次。
- 仅当本地接口表没有匹配项,或 Connector 明确报告方法不存在/不受支持时,才调用
search_methods 动态发现接口;不得靠猜测连续试用名称相近的 get_* 方法。
- 只有
call_pandadata 实际返回 0 行时才允许写“无数据”。必须先完成一次复查调用:校验
最新交易日与代码格式,放宽日期窗口,移除非必填过滤条件,或使用登记的备用参数;仍为
0 行才可如实报告,并保留两次调用回执。0 行不得触发 search_methods。
- 不向
call_pandadata 添加未登记参数或顶层行数限制;记录实际方法、参数、数据日期、
频率、复权口径、行数、空值和错误状态。
- 包内脚本只可处理 Connector 已返回的数据或执行纯本地计算与校验,不得自行联网取数。
最终答案必须包含“数据调用回执”表:接口、实际参数、状态、行数、数据日期范围和关键字段。
缺少回执表示任务未完成,必须继续调用工具而不是结束回答。
权限不足、配额限制、空结果、延迟发布和字段缺失都必须明确披露,不得切换到其他数据源
或用模型推断补数。
包内专家工作流
本 Skill 仅服务于 PD-A股风险红绿灯。不得绕过主 Agent 的数据闸门、最低接口路由或最终回执。
执行步骤
- 先用 PandaData 宏观、指数和资金数据定义市场观察窗口。
- 计算各维度红黄绿或未知状态,缺失数据只能为未知。
- 对个股再补充价格、质押、解禁和状态变化。
- 只有多个真实信号同时触发时才描述风险共振。
工作边界
- 只处理
pandadata Connector 已返回的事实数据和纯本地计算。
- 不读取环境变量、凭据、网络地址或包外数据;不得执行联网脚本。
- 所有派生指标必须说明公式、字段、窗口和数据日期。
- 不承诺收益,不输出自动交易或具体仓位指令。
已登记接口契约
完整参数、返回字段与备用参数见 references/pandadata-interface-contracts.md。
PandaData 已登记接口契约
本文件由包内 PandaData 接口文档生成,是本专家已登记业务接口的本地契约。
任务能映射到下列方法时,直接调用 call_pandadata;不要先调用 search_methods 或
get_method_doc。只有接口未登记、方法不受支持或 Connector 明确报告契约失效时,
才进入动态发现或单方法契约修复流程。接口返回 0 行不是动态检索条件。
日期通常使用 YYYYMMDD;A 股代码通常使用 000001.SZ / 600000.SH。具体以每个
方法的参数表为准。调用时把方法名与 params 对象传给 call_pandadata,不要添加
未列出的参数或顶层行数限制。
get_last_trade_date
用途:获取最新交易日
入参
| 参数 |
类型 |
必填 |
说明 |
exchange |
Optional[string] |
否 |
交易所代码,默认为 "SH",目前支持"SH","HK"和"US" |
返回字段
| 字段 |
类型 |
说明 |
date |
string |
最新交易日,格式 "YYYYMMDD",如果没有则返回None |
get_trade_cal
用途:获取交易日历
入参
| 参数 |
类型 |
必填 |
说明 |
start_date |
Optional[string] |
否 |
开始日期,格式为 YYYYMMDD |
end_date |
Optional[string] |
否 |
结束日期,格式为 YYYYMMDD |
exchange |
Optional[string] |
否 |
交易所代码,默认为 "SH",目前支持"SH","HK"和"US" |
is_trading_day |
Optional[integer] |
否 |
是否为交易日,1=交易日,0=非交易日,None=全部 |
fields |
Optional[Union[string, List[string]]] |
否 |
需要返回的字段列表 |
返回字段
| 字段 |
类型 |
说明 |
nature_date |
integer |
日期,格式为YYYYMMDD |
exchange |
string |
交易所代码 |
is_trade |
integer |
是否为交易日,1表示交易日,0表示非交易日 |
pretrade_date |
string |
当前日期前一个交易日 |
next_trade_date |
string |
当前日期后一个交易日 |
get_macro_ci
用途:中国宏观-景气指数
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
指标代码,完整指标码表见文件下载 |
start_date |
string |
是 |
开始日期 YYYYMMDD |
end_date |
string |
是 |
结束日期 YYYYMMDD |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段 |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
指标代码 |
period_date |
string |
数据期 |
data_value |
float |
指标数值 |
get_macro_pi
用途:中国宏观-价格指数
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
指标代码,完整指标码表见文件下载 |
start_date |
string |
是 |
开始日期 YYYYMMDD |
end_date |
string |
是 |
结束日期 YYYYMMDD |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段 |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
指标代码 |
period_date |
string |
数据期 |
data_value |
float |
指标数值 |
get_macro_pm
用途:中国宏观-区域宏观
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
指标代码,完整指标码表见文件下载 |
start_date |
string |
是 |
开始日期 YYYYMMDD |
end_date |
string |
是 |
结束日期 YYYYMMDD |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段 |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
指标代码 |
period_date |
string |
数据期 |
data_value |
float |
指标数值 |
get_macro_fi
用途:中国宏观-财政
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
指标代码,完整指标码表见文件下载 |
start_date |
string |
是 |
开始日期 YYYYMMDD |
end_date |
string |
是 |
结束日期 YYYYMMDD |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段 |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
指标代码 |
period_date |
string |
数据期 |
data_value |
float |
指标数值 |
get_macro_mb
用途:中国宏观-货币与银行
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
指标代码,完整指标码表见文件下载 |
start_date |
string |
是 |
开始日期 YYYYMMDD |
end_date |
string |
是 |
结束日期 YYYYMMDD |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段 |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
指标代码 |
period_date |
string |
数据期 |
data_value |
float |
指标数值 |
get_macro_ir
用途:中国宏观-利率汇率
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
指标代码,完整指标码表见文件下载 |
start_date |
string |
是 |
开始日期 YYYYMMDD |
end_date |
string |
是 |
结束日期 YYYYMMDD |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段 |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
指标代码 |
period_date |
string |
数据期 |
data_value |
float |
指标数值 |
get_index_daily
用途:获取指数日线
入参
| 参数 |
类型 |
必填 |
说明 |
start_date |
string |
是 |
开始日期,eg:"20250702",与结束日期间不超过5年 |
end_date |
string |
是 |
结束日期,eg:"20250702",与开始日期间不超过5年 |
symbol |
string |
否 |
指数代码 |
fields |
string |
否 |
返回字段 |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
指数代码 |
date |
string |
日期 |
open |
float |
开盘价 |
close |
float |
收盘价 |
high |
float |
最高价 |
low |
float |
最低价 |
volume |
float |
成交量 |
pre_close |
float |
昨日结算价 |
amount |
float |
成交额 |
get_index_indicator
用途:获取指数估值指标数据
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
指数代码 |
start_date |
Optional[string] |
否 |
开始日期,eg:"20250702" |
end_date |
Optional[string] |
否 |
结束日期,eg:"20250702" |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段列表 |
返回字段
| 字段 |
类型 |
说明 |
date |
string |
日期 |
symbol |
string |
指数代码 |
pb_lf |
float |
市净率(LF) |
pb_lyr |
float |
市净率(LYR) |
pb_ttm |
float |
市净率(TTM) |
pe_lyr |
float |
市盈率(LYR) |
pe_ttm |
float |
市盈率(TTM) |
get_margin
用途:获取融资融券信息
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
股票代码 |
start_date |
string |
是 |
开始日期,eg:"20250702" |
end_date |
string |
是 |
结束日期,eg:"20250702" |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段列表 |
margin_type |
Optional[string] |
否 |
买卖方向,"stock" 代表融券卖出,"cash" 代表融资买入 |
返回字段
| 字段 |
类型 |
说明 |
short_sell_quantity |
float |
融券卖出量 |
buy_on_margin_value |
float |
融资买入额 |
date |
string |
日期 |
margin_repayment |
float |
融券偿还额 |
short_balance |
float |
融券余额 |
margin_balance |
float |
融资余额 |
symbol |
string |
股票代码 |
short_balance_quantity |
float |
融券余量 |
short_repayment_quantity |
float |
融券偿还量 |
margin_type |
string |
买卖方向,"stock" 代表融券卖出,"cash" 代表融资买入 |
total_balance |
float |
总余额 |
get_hsgt_hold
用途:获取沪深股通持股信息
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
股票代码 |
start_date |
string |
是 |
开始日期,eg:"20250702" |
end_date |
string |
是 |
结束日期,eg:"20250702" |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段列表 |
返回字段
| 字段 |
类型 |
说明 |
date |
string |
日期 |
shares_num |
float |
持股数量 |
symbol |
string |
股票代码 |
adjusted_holding_ratio |
float |
调整后持股比例 |
holding_ratio |
float |
持股比例 |
get_lhb_list
用途:获取股票龙虎榜数据
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
股票代码,如 "000001.SZ" |
type |
Optional[Union[string, List[string]]] |
否 |
龙虎榜类型 |
start_date |
Optional[string] |
否 |
开始日期,格式 "YYYYMMDD" |
end_date |
Optional[string] |
否 |
结束日期,格式 "YYYYMMDD" |
fields |
Optional[Union[string, List[string]]] |
否 |
需要返回的字段列表 |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
股票代码 |
date |
string |
龙虎榜日期 |
type |
string |
龙虎榜类型 |
reason |
string |
龙虎榜原因 |
amount |
float |
龙虎榜金额 |
volume |
float |
龙虎榜数量 |
amplitude |
float |
龙虎榜振幅 |
change_rate |
float |
龙虎榜涨跌幅 |
deviation |
float |
龙虎榜涨跌幅偏离值 |
turnover |
float |
龙虎榜换手率 |
start_date |
float |
异动开始日期 |
end_date |
string |
异动结束日期 |
get_concept_list
用途:获取概念列表
入参
| 参数 |
类型 |
必填 |
说明 |
concept |
Optional[Union[string, List[string]]] |
否 |
概念名称 |
start_date |
Optional[string] |
否 |
开始时间 |
end_date |
Optional[string] |
否 |
结束时间 |
返回字段
| 字段 |
类型 |
说明 |
name |
string |
概念名称 |
date |
string |
概念纳入日期 |
get_concept_constituents
用途:获取概念成分股
入参
| 参数 |
类型 |
必填 |
说明 |
concept |
Optional[Union[string, List[string]]] |
否 |
概念名称 |
concept_stock |
Optional[Union[string, List[string]]] |
否 |
股票代码 |
start_date |
Optional[string] |
否 |
开始日期,格式 YYYYMMDD |
end_date |
Optional[string] |
否 |
结束日期,格式 YYYYMMDD |
date |
Optional[string] |
否 |
日期,返回该日期前被纳入对应概念的股票 |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段 |
返回字段
| 字段 |
类型 |
说明 |
concept |
string |
概念名称 |
concept_stock |
string |
概念成分股 |
date |
string |
股票纳入概念日期 |
get_option_underlying_volatility
用途:获取期权标的历史波动率
入参
| 参数 |
类型 |
必填 |
说明 |
start_date |
string |
是 |
开始日期,eg:"20250702",与结束日期间不超过5年 |
end_date |
string |
是 |
结束日期,eg:"20250702",与开始日期间不超过5年 |
symbol |
Optional[Union[string, List[string]]] |
否 |
期权标的代码 |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段 |
exchange |
Optional[Union[string, List[string]]] |
否 |
交易市场 |
period |
integer |
否 |
历史波动率期限(5/10/30/60/90/120/180/250/500日) |
返回字段
| 字段 |
类型 |
说明 |
date |
string |
日期 |
symbol |
string |
期权标的代码 |
ticker_symbol |
float |
期权标的简称 |
exchange |
string |
交易市场 |
is_adj |
integer |
是否为复权数据 |
close |
float |
收盘价 |
period |
integer |
历史波动率期限(5/10/30/60/90/120/180/250/500日) |
historical_volatility |
float |
历史波动率 |
get_stock_detail
用途:获取股票基本信息
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
股票代码 |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段 |
status |
Optional[integer] |
否 |
是否在市,1 -在市,0 -退市,-1 -未知 |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
股票代码 |
market_tplus |
integer |
交易制度 |
name |
string |
股票名称 |
special_type |
string |
特别处理状态 |
status |
integer |
股票状态 |
de_listed_date |
string |
退市日期 |
listed_date |
string |
上市日期 |
sector_code_name |
string |
以当地语言为标准的板块代码名 |
abbrev_symbol |
string |
股票的名称缩写 |
sector_code |
string |
板块缩写代码 |
min_order_amount |
float |
一手对应多少股 |
trading_hours |
string |
产品最新交易时间 |
board_type |
string |
板块类别 |
issue_price |
float |
该证券发行价 |
trading_code |
string |
交易代码 |
office_address |
string |
公司地址 |
province |
string |
省份 |
purchasedate |
string |
申购日期 |
get_stock_daily
用途:获取A股日线数据
入参
| 参数 |
类型 |
必填 |
说明 |
start_date |
string |
是 |
开始日期,eg:"20250702",与结束日期间不超过5年 |
end_date |
string |
是 |
结束日期,eg:"20250702",与开始日期间不超过5年 |
symbol |
Optional[Union[string, List[string]]] |
否 |
股票代码 |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段 |
indicator |
Optional[string] |
否 |
股票池,参考本文档数据概述部分中的股票池说明,默认为空表示查询所有 |
st |
Optional[bool] |
否 |
是否包含ST股,默认True表示包含。仅在type为stock时有效 |
返回字段
| 字段 |
类型 |
说明 |
date |
string |
日期 |
symbol |
string |
股票代码 |
name |
string |
股票名称 |
open |
float |
当日开盘价 |
close |
float |
当日收盘价 |
high |
float |
当日最高价 |
low |
float |
当日最低价 |
volume |
float |
当日成交量 |
amount |
float |
当日成交额 |
pre_close |
float |
昨收价 |
limit_up |
float |
当日涨停价 |
limit_down |
float |
当日跌停价 |
trade_status |
integer |
当日是否停牌(0表示当日不停牌) |
get_restricted_list
用途:获取股票限售解禁明细数据
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
股票代码 |
start_date |
string |
是 |
开始日期,eg:"20250702" |
end_date |
string |
是 |
结束日期,eg:"20250702" |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段列表 |
market |
Optional[string] |
否 |
市场,默认"cn"为中国内地市场 |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
合约代码 |
date |
string |
限售解禁信息发布日期 |
relieve_date |
string |
解禁日期 |
shareholder |
string |
股东名 |
shareholder_type |
string |
股东类型 |
relieve_shares |
float |
解除限售股份数量(股) |
actual_relieve_shares |
float |
实际上市流通数量(股) |
relieve_reason |
string |
解禁原因 |
get_stock_pledge_stat
用途:获取股票质押信息统计
入参
| 参数 |
类型 |
必填 |
说明 |
start_date |
string |
是 |
开始日期,eg:"20250702" |
end_date |
string |
是 |
结束日期,eg:"20250702" |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段列表 |
返回字段
| 字段 |
类型 |
说明 |
data_source |
string |
数据来源 |
pledge_begin_date |
string |
起始日期 |
pledge_end_date |
string |
结束日期 |
unrestricted_avg_pledge_ratio |
float |
无限售条件股份平均质押率 |
restricted_avg_pledge_ratio |
float |
有限售条件股份平均质押率 |
pledge_number |
float |
质押笔数 |
pledge_volume |
float |
质押数量 |
init_amount |
float |
初始交易金额 |
repurchase_amount |
float |
购回交易金额 |
get_stock_status_change
用途:获取合约特殊处理数据
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
股票代码 |
start_date |
Optional[string] |
否 |
开始日期,eg:"20250702" |
end_date |
Optional[string] |
否 |
结束日期,eg:"20250702" |
fields |
Optional[Union[string, List[string]]] |
否 |
返回字段列表 |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
股票代码 |
date |
string |
信息发布日期 |
change_date |
string |
特别处理(或撤销)实施日期 |
description |
string |
特别处理(或撤销)事项描述 |
name |
string |
股票名称 |
type |
string |
特别处理(或撤销)类别 |
get_fina_forecast
用途:获取业绩预告数据
入参
| 参数 |
类型 |
必填 |
说明 |
symbol |
Optional[Union[string, List[string]]] |
否 |
股票代码,可以是单个字符串或字符串列表 |
fields |
Optional[Union[string, List[string]]] |
否 |
需要返回的字段列表 |
info_date |
Optional[string] |
否 |
信息发布日期,格式为 "YYYYMMDD" |
end_quarter |
Optional[string] |
否 |
报告季度,格式为 "YYYYqN" |
返回字段
| 字段 |
类型 |
说明 |
symbol |
string |
股票代码 |
info_date |
string |
信息发布日期 |
end_date |
string |
报告日期 |
forecast_type |
string |
整体业绩预期 |
forecast_description |
string |
业绩预期时间段描述 |
forecast_growth_rate_floor |
float |
最小预期增长幅度 |
forecast_growth_rate_ceiling |
float |
最大预期增长幅度 |
forecast_earning_floor |
float |
最小预期收入 |
forecast_earning_ceiling |
float |
最大预期收入 |
forecast_np_floor |
float |
最小预期净利润 |
forecast_np_ceiling |
float |
最大预期净利润 |
forecast_eps_floor |
float |
最小预期每股 |
forecast_eps_ceiling |
float |
最大预期每股收益 |
net_profit_yoy_const_forecast |
float |
一致预期净利润增幅 |
forecast_ne_ceiling |
float |
最小预测归母股东权益 |
forecast_ne_floor |
float |
最大预测归母股东权益 |
1---
2name: pd-a-share-market-risk-radar-workflow
3description: "Use this private PandaData-only workflow when PD-A股风险红绿灯 is invoked inside its WorkBuddy expert package."
4metadata:
5 source: https://skillmd.com/skills/ahang1598/pd-a-share-market-risk-radar-workflow
6---
7
8## WorkBuddy PandaData 数据源覆盖
9
10本技能在 WorkBuddy 专家包中运行时,所有实时和历史金融数据必须来自已连接的
11`pandadata` Connector。若下文、参考资料或脚本提到 Python `panda_data` SDK、
12AkShare、Tushare、网页抓取、直连 HTTP 或本地凭证,以本节为准:不得使用这些
13方式获取正式数据。
14
151. 数据型任务必须先完成 `auth_status` 和至少一次真实的 `call_pandadata` 业务调用;在收到
16 Connector 返回前,禁止输出分析、排名、数字结论或“无数据”。本 Skill 的流程不得绕过
17 主 Agent 的最低接口调用清单。
182. 先按本 Skill 的 `references/pandadata-interface-contracts.md` 选择已登记方法和参数。只要任务能映射到已登记接口,
19 就直接通过 `call_pandadata` 传入该业务方法和 `params`;常规调用前不得执行接口检索。
203. 仅当已登记方法被 Connector 明确报告为参数契约不兼容、字段契约变化或调用失败时,
21 才对该方法调用一次 `get_method_doc`,修正参数后最多重试一次。
224. 仅当本地接口表没有匹配项,或 Connector 明确报告方法不存在/不受支持时,才调用
23 `search_methods` 动态发现接口;不得靠猜测连续试用名称相近的 `get_*` 方法。
245. 只有 `call_pandadata` 实际返回 0 行时才允许写“无数据”。必须先完成一次复查调用:校验
25 最新交易日与代码格式,放宽日期窗口,移除非必填过滤条件,或使用登记的备用参数;仍为
26 0 行才可如实报告,并保留两次调用回执。0 行不得触发 `search_methods`。
276. 不向 `call_pandadata` 添加未登记参数或顶层行数限制;记录实际方法、参数、数据日期、
28 频率、复权口径、行数、空值和错误状态。
297. 包内脚本只可处理 Connector 已返回的数据或执行纯本地计算与校验,不得自行联网取数。
30
31最终答案必须包含“数据调用回执”表:接口、实际参数、状态、行数、数据日期范围和关键字段。
32缺少回执表示任务未完成,必须继续调用工具而不是结束回答。
33
34权限不足、配额限制、空结果、延迟发布和字段缺失都必须明确披露,不得切换到其他数据源
35或用模型推断补数。
36
37
38## 包内专家工作流
39
40本 Skill 仅服务于 **PD-A股风险红绿灯**。不得绕过主 Agent 的数据闸门、最低接口路由或最终回执。
41
42### 执行步骤
43
441. 先用 PandaData 宏观、指数和资金数据定义市场观察窗口。
452. 计算各维度红黄绿或未知状态,缺失数据只能为未知。
463. 对个股再补充价格、质押、解禁和状态变化。
474. 只有多个真实信号同时触发时才描述风险共振。
48
49### 工作边界
50
51- 只处理 `pandadata` Connector 已返回的事实数据和纯本地计算。
52- 不读取环境变量、凭据、网络地址或包外数据;不得执行联网脚本。
53- 所有派生指标必须说明公式、字段、窗口和数据日期。
54- 不承诺收益,不输出自动交易或具体仓位指令。
55
56## 已登记接口契约
57
58完整参数、返回字段与备用参数见 `references/pandadata-interface-contracts.md`。
59
60# PandaData 已登记接口契约
61
62本文件由包内 PandaData 接口文档生成,是本专家已登记业务接口的本地契约。
63任务能映射到下列方法时,直接调用 `call_pandadata`;不要先调用 `search_methods` 或
64`get_method_doc`。只有接口未登记、方法不受支持或 Connector 明确报告契约失效时,
65才进入动态发现或单方法契约修复流程。接口返回 0 行不是动态检索条件。
66
67日期通常使用 `YYYYMMDD`;A 股代码通常使用 `000001.SZ` / `600000.SH`。具体以每个
68方法的参数表为准。调用时把方法名与 `params` 对象传给 `call_pandadata`,不要添加
69未列出的参数或顶层行数限制。
70
71## `get_last_trade_date`
72
73用途:获取最新交易日
74
75### 入参
76
77| 参数 | 类型 | 必填 | 说明 |
78|---|---|---|---|
79| `exchange` | Optional[string] | 否 | 交易所代码,默认为 "SH",目前支持"SH","HK"和"US" |
80
81### 返回字段
82
83| 字段 | 类型 | 说明 |
84|---|---|---|
85| `date` | string | 最新交易日,格式 "YYYYMMDD",如果没有则返回None |
86
87## `get_trade_cal`
88
89用途:获取交易日历
90
91### 入参
92
93| 参数 | 类型 | 必填 | 说明 |
94|---|---|---|---|
95| `start_date` | Optional[string] | 否 | 开始日期,格式为 YYYYMMDD |
96| `end_date` | Optional[string] | 否 | 结束日期,格式为 YYYYMMDD |
97| `exchange` | Optional[string] | 否 | 交易所代码,默认为 "SH",目前支持"SH","HK"和"US" |
98| `is_trading_day` | Optional[integer] | 否 | 是否为交易日,1=交易日,0=非交易日,None=全部 |
99| `fields` | Optional[Union[string, List[string]]] | 否 | 需要返回的字段列表 |
100
101### 返回字段
102
103| 字段 | 类型 | 说明 |
104|---|---|---|
105| `nature_date` | integer | 日期,格式为YYYYMMDD |
106| `exchange` | string | 交易所代码 |
107| `is_trade` | integer | 是否为交易日,1表示交易日,0表示非交易日 |
108| `pretrade_date` | string | 当前日期前一个交易日 |
109| `next_trade_date` | string | 当前日期后一个交易日 |
110
111## `get_macro_ci`
112
113用途:中国宏观-景气指数
114
115### 入参
116
117| 参数 | 类型 | 必填 | 说明 |
118|---|---|---|---|
119| `symbol` | Optional[Union[string, List[string]]] | 否 | 指标代码,完整指标码表见文件下载 |
120| `start_date` | string | 是 | 开始日期 YYYYMMDD |
121| `end_date` | string | 是 | 结束日期 YYYYMMDD |
122| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段 |
123
124### 返回字段
125
126| 字段 | 类型 | 说明 |
127|---|---|---|
128| `symbol` | string | 指标代码 |
129| `period_date` | string | 数据期 |
130| `data_value` | float | 指标数值 |
131
132## `get_macro_pi`
133
134用途:中国宏观-价格指数
135
136### 入参
137
138| 参数 | 类型 | 必填 | 说明 |
139|---|---|---|---|
140| `symbol` | Optional[Union[string, List[string]]] | 否 | 指标代码,完整指标码表见文件下载 |
141| `start_date` | string | 是 | 开始日期 YYYYMMDD |
142| `end_date` | string | 是 | 结束日期 YYYYMMDD |
143| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段 |
144
145### 返回字段
146
147| 字段 | 类型 | 说明 |
148|---|---|---|
149| `symbol` | string | 指标代码 |
150| `period_date` | string | 数据期 |
151| `data_value` | float | 指标数值 |
152
153## `get_macro_pm`
154
155用途:中国宏观-区域宏观
156
157### 入参
158
159| 参数 | 类型 | 必填 | 说明 |
160|---|---|---|---|
161| `symbol` | Optional[Union[string, List[string]]] | 否 | 指标代码,完整指标码表见文件下载 |
162| `start_date` | string | 是 | 开始日期 YYYYMMDD |
163| `end_date` | string | 是 | 结束日期 YYYYMMDD |
164| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段 |
165
166### 返回字段
167
168| 字段 | 类型 | 说明 |
169|---|---|---|
170| `symbol` | string | 指标代码 |
171| `period_date` | string | 数据期 |
172| `data_value` | float | 指标数值 |
173
174## `get_macro_fi`
175
176用途:中国宏观-财政
177
178### 入参
179
180| 参数 | 类型 | 必填 | 说明 |
181|---|---|---|---|
182| `symbol` | Optional[Union[string, List[string]]] | 否 | 指标代码,完整指标码表见文件下载 |
183| `start_date` | string | 是 | 开始日期 YYYYMMDD |
184| `end_date` | string | 是 | 结束日期 YYYYMMDD |
185| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段 |
186
187### 返回字段
188
189| 字段 | 类型 | 说明 |
190|---|---|---|
191| `symbol` | string | 指标代码 |
192| `period_date` | string | 数据期 |
193| `data_value` | float | 指标数值 |
194
195## `get_macro_mb`
196
197用途:中国宏观-货币与银行
198
199### 入参
200
201| 参数 | 类型 | 必填 | 说明 |
202|---|---|---|---|
203| `symbol` | Optional[Union[string, List[string]]] | 否 | 指标代码,完整指标码表见文件下载 |
204| `start_date` | string | 是 | 开始日期 YYYYMMDD |
205| `end_date` | string | 是 | 结束日期 YYYYMMDD |
206| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段 |
207
208### 返回字段
209
210| 字段 | 类型 | 说明 |
211|---|---|---|
212| `symbol` | string | 指标代码 |
213| `period_date` | string | 数据期 |
214| `data_value` | float | 指标数值 |
215
216## `get_macro_ir`
217
218用途:中国宏观-利率汇率
219
220### 入参
221
222| 参数 | 类型 | 必填 | 说明 |
223|---|---|---|---|
224| `symbol` | Optional[Union[string, List[string]]] | 否 | 指标代码,完整指标码表见文件下载 |
225| `start_date` | string | 是 | 开始日期 YYYYMMDD |
226| `end_date` | string | 是 | 结束日期 YYYYMMDD |
227| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段 |
228
229### 返回字段
230
231| 字段 | 类型 | 说明 |
232|---|---|---|
233| `symbol` | string | 指标代码 |
234| `period_date` | string | 数据期 |
235| `data_value` | float | 指标数值 |
236
237## `get_index_daily`
238
239用途:获取指数日线
240
241### 入参
242
243| 参数 | 类型 | 必填 | 说明 |
244|---|---|---|---|
245| `start_date` | string | 是 | 开始日期,eg:"20250702",与结束日期间不超过5年 |
246| `end_date` | string | 是 | 结束日期,eg:"20250702",与开始日期间不超过5年 |
247| `symbol` | string | 否 | 指数代码 |
248| `fields` | string | 否 | 返回字段 |
249
250### 返回字段
251
252| 字段 | 类型 | 说明 |
253|---|---|---|
254| `symbol` | string | 指数代码 |
255| `date` | string | 日期 |
256| `open` | float | 开盘价 |
257| `close` | float | 收盘价 |
258| `high` | float | 最高价 |
259| `low` | float | 最低价 |
260| `volume` | float | 成交量 |
261| `pre_close` | float | 昨日结算价 |
262| `amount` | float | 成交额 |
263
264## `get_index_indicator`
265
266用途:获取指数估值指标数据
267
268### 入参
269
270| 参数 | 类型 | 必填 | 说明 |
271|---|---|---|---|
272| `symbol` | Optional[Union[string, List[string]]] | 否 | 指数代码 |
273| `start_date` | Optional[string] | 否 | 开始日期,eg:"20250702" |
274| `end_date` | Optional[string] | 否 | 结束日期,eg:"20250702" |
275| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段列表 |
276
277### 返回字段
278
279| 字段 | 类型 | 说明 |
280|---|---|---|
281| `date` | string | 日期 |
282| `symbol` | string | 指数代码 |
283| `pb_lf` | float | 市净率(LF) |
284| `pb_lyr` | float | 市净率(LYR) |
285| `pb_ttm` | float | 市净率(TTM) |
286| `pe_lyr` | float | 市盈率(LYR) |
287| `pe_ttm` | float | 市盈率(TTM) |
288
289## `get_margin`
290
291用途:获取融资融券信息
292
293### 入参
294
295| 参数 | 类型 | 必填 | 说明 |
296|---|---|---|---|
297| `symbol` | Optional[Union[string, List[string]]] | 否 | 股票代码 |
298| `start_date` | string | 是 | 开始日期,eg:"20250702" |
299| `end_date` | string | 是 | 结束日期,eg:"20250702" |
300| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段列表 |
301| `margin_type` | Optional[string] | 否 | 买卖方向,"stock" 代表融券卖出,"cash" 代表融资买入 |
302
303### 返回字段
304
305| 字段 | 类型 | 说明 |
306|---|---|---|
307| `short_sell_quantity` | float | 融券卖出量 |
308| `buy_on_margin_value` | float | 融资买入额 |
309| `date` | string | 日期 |
310| `margin_repayment` | float | 融券偿还额 |
311| `short_balance` | float | 融券余额 |
312| `margin_balance` | float | 融资余额 |
313| `symbol` | string | 股票代码 |
314| `short_balance_quantity` | float | 融券余量 |
315| `short_repayment_quantity` | float | 融券偿还量 |
316| `margin_type` | string | 买卖方向,"stock" 代表融券卖出,"cash" 代表融资买入 |
317| `total_balance` | float | 总余额 |
318
319## `get_hsgt_hold`
320
321用途:获取沪深股通持股信息
322
323### 入参
324
325| 参数 | 类型 | 必填 | 说明 |
326|---|---|---|---|
327| `symbol` | Optional[Union[string, List[string]]] | 否 | 股票代码 |
328| `start_date` | string | 是 | 开始日期,eg:"20250702" |
329| `end_date` | string | 是 | 结束日期,eg:"20250702" |
330| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段列表 |
331
332### 返回字段
333
334| 字段 | 类型 | 说明 |
335|---|---|---|
336| `date` | string | 日期 |
337| `shares_num` | float | 持股数量 |
338| `symbol` | string | 股票代码 |
339| `adjusted_holding_ratio` | float | 调整后持股比例 |
340| `holding_ratio` | float | 持股比例 |
341
342## `get_lhb_list`
343
344用途:获取股票龙虎榜数据
345
346### 入参
347
348| 参数 | 类型 | 必填 | 说明 |
349|---|---|---|---|
350| `symbol` | Optional[Union[string, List[string]]] | 否 | 股票代码,如 "000001.SZ" |
351| `type` | Optional[Union[string, List[string]]] | 否 | 龙虎榜类型 |
352| `start_date` | Optional[string] | 否 | 开始日期,格式 "YYYYMMDD" |
353| `end_date` | Optional[string] | 否 | 结束日期,格式 "YYYYMMDD" |
354| `fields` | Optional[Union[string, List[string]]] | 否 | 需要返回的字段列表 |
355
356### 返回字段
357
358| 字段 | 类型 | 说明 |
359|---|---|---|
360| `symbol` | string | 股票代码 |
361| `date` | string | 龙虎榜日期 |
362| `type` | string | 龙虎榜类型 |
363| `reason` | string | 龙虎榜原因 |
364| `amount` | float | 龙虎榜金额 |
365| `volume` | float | 龙虎榜数量 |
366| `amplitude` | float | 龙虎榜振幅 |
367| `change_rate` | float | 龙虎榜涨跌幅 |
368| `deviation` | float | 龙虎榜涨跌幅偏离值 |
369| `turnover` | float | 龙虎榜换手率 |
370| `start_date` | float | 异动开始日期 |
371| `end_date` | string | 异动结束日期 |
372
373## `get_concept_list`
374
375用途:获取概念列表
376
377### 入参
378
379| 参数 | 类型 | 必填 | 说明 |
380|---|---|---|---|
381| `concept` | Optional[Union[string, List[string]]] | 否 | 概念名称 |
382| `start_date` | Optional[string] | 否 | 开始时间 |
383| `end_date` | Optional[string] | 否 | 结束时间 |
384
385### 返回字段
386
387| 字段 | 类型 | 说明 |
388|---|---|---|
389| `name` | string | 概念名称 |
390| `date` | string | 概念纳入日期 |
391
392## `get_concept_constituents`
393
394用途:获取概念成分股
395
396### 入参
397
398| 参数 | 类型 | 必填 | 说明 |
399|---|---|---|---|
400| `concept` | Optional[Union[string, List[string]]] | 否 | 概念名称 |
401| `concept_stock` | Optional[Union[string, List[string]]] | 否 | 股票代码 |
402| `start_date` | Optional[string] | 否 | 开始日期,格式 YYYYMMDD |
403| `end_date` | Optional[string] | 否 | 结束日期,格式 YYYYMMDD |
404| `date` | Optional[string] | 否 | 日期,返回该日期前被纳入对应概念的股票 |
405| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段 |
406
407### 返回字段
408
409| 字段 | 类型 | 说明 |
410|---|---|---|
411| `concept` | string | 概念名称 |
412| `concept_stock` | string | 概念成分股 |
413| `date` | string | 股票纳入概念日期 |
414
415## `get_option_underlying_volatility`
416
417用途:获取期权标的历史波动率
418
419### 入参
420
421| 参数 | 类型 | 必填 | 说明 |
422|---|---|---|---|
423| `start_date` | string | 是 | 开始日期,eg:"20250702",与结束日期间不超过5年 |
424| `end_date` | string | 是 | 结束日期,eg:"20250702",与开始日期间不超过5年 |
425| `symbol` | Optional[Union[string, List[string]]] | 否 | 期权标的代码 |
426| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段 |
427| `exchange` | Optional[Union[string, List[string]]] | 否 | 交易市场 |
428| `period` | integer | 否 | 历史波动率期限(5/10/30/60/90/120/180/250/500日) |
429
430### 返回字段
431
432| 字段 | 类型 | 说明 |
433|---|---|---|
434| `date` | string | 日期 |
435| `symbol` | string | 期权标的代码 |
436| `ticker_symbol` | float | 期权标的简称 |
437| `exchange` | string | 交易市场 |
438| `is_adj` | integer | 是否为复权数据 |
439| `close` | float | 收盘价 |
440| `period` | integer | 历史波动率期限(5/10/30/60/90/120/180/250/500日) |
441| `historical_volatility` | float | 历史波动率 |
442
443## `get_stock_detail`
444
445用途:获取股票基本信息
446
447### 入参
448
449| 参数 | 类型 | 必填 | 说明 |
450|---|---|---|---|
451| `symbol` | Optional[Union[string, List[string]]] | 否 | 股票代码 |
452| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段 |
453| `status` | Optional[integer] | 否 | 是否在市,1 -在市,0 -退市,-1 -未知 |
454
455### 返回字段
456
457| 字段 | 类型 | 说明 |
458|---|---|---|
459| `symbol` | string | 股票代码 |
460| `market_tplus` | integer | 交易制度 |
461| `name` | string | 股票名称 |
462| `special_type` | string | 特别处理状态 |
463| `status` | integer | 股票状态 |
464| `de_listed_date` | string | 退市日期 |
465| `listed_date` | string | 上市日期 |
466| `sector_code_name` | string | 以当地语言为标准的板块代码名 |
467| `abbrev_symbol` | string | 股票的名称缩写 |
468| `sector_code` | string | 板块缩写代码 |
469| `min_order_amount` | float | 一手对应多少股 |
470| `trading_hours` | string | 产品最新交易时间 |
471| `board_type` | string | 板块类别 |
472| `issue_price` | float | 该证券发行价 |
473| `trading_code` | string | 交易代码 |
474| `office_address` | string | 公司地址 |
475| `province` | string | 省份 |
476| `purchasedate` | string | 申购日期 |
477
478## `get_stock_daily`
479
480用途:获取A股日线数据
481
482### 入参
483
484| 参数 | 类型 | 必填 | 说明 |
485|---|---|---|---|
486| `start_date` | string | 是 | 开始日期,eg:"20250702",与结束日期间不超过5年 |
487| `end_date` | string | 是 | 结束日期,eg:"20250702",与开始日期间不超过5年 |
488| `symbol` | Optional[Union[string, List[string]]] | 否 | 股票代码 |
489| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段 |
490| `indicator` | Optional[string] | 否 | 股票池,参考本文档数据概述部分中的股票池说明,默认为空表示查询所有 |
491| `st` | Optional[bool] | 否 | 是否包含ST股,默认True表示包含。仅在type为stock时有效 |
492
493### 返回字段
494
495| 字段 | 类型 | 说明 |
496|---|---|---|
497| `date` | string | 日期 |
498| `symbol` | string | 股票代码 |
499| `name` | string | 股票名称 |
500| `open` | float | 当日开盘价 |
501| `close` | float | 当日收盘价 |
502| `high` | float | 当日最高价 |
503| `low` | float | 当日最低价 |
504| `volume` | float | 当日成交量 |
505| `amount` | float | 当日成交额 |
506| `pre_close` | float | 昨收价 |
507| `limit_up` | float | 当日涨停价 |
508| `limit_down` | float | 当日跌停价 |
509| `trade_status` | integer | 当日是否停牌(0表示当日不停牌) |
510
511## `get_restricted_list`
512
513用途:获取股票限售解禁明细数据
514
515### 入参
516
517| 参数 | 类型 | 必填 | 说明 |
518|---|---|---|---|
519| `symbol` | Optional[Union[string, List[string]]] | 否 | 股票代码 |
520| `start_date` | string | 是 | 开始日期,eg:"20250702" |
521| `end_date` | string | 是 | 结束日期,eg:"20250702" |
522| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段列表 |
523| `market` | Optional[string] | 否 | 市场,默认"cn"为中国内地市场 |
524
525### 返回字段
526
527| 字段 | 类型 | 说明 |
528|---|---|---|
529| `symbol` | string | 合约代码 |
530| `date` | string | 限售解禁信息发布日期 |
531| `relieve_date` | string | 解禁日期 |
532| `shareholder` | string | 股东名 |
533| `shareholder_type` | string | 股东类型 |
534| `relieve_shares` | float | 解除限售股份数量(股) |
535| `actual_relieve_shares` | float | 实际上市流通数量(股) |
536| `relieve_reason` | string | 解禁原因 |
537
538## `get_stock_pledge_stat`
539
540用途:获取股票质押信息统计
541
542### 入参
543
544| 参数 | 类型 | 必填 | 说明 |
545|---|---|---|---|
546| `start_date` | string | 是 | 开始日期,eg:"20250702" |
547| `end_date` | string | 是 | 结束日期,eg:"20250702" |
548| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段列表 |
549
550### 返回字段
551
552| 字段 | 类型 | 说明 |
553|---|---|---|
554| `data_source` | string | 数据来源 |
555| `pledge_begin_date` | string | 起始日期 |
556| `pledge_end_date` | string | 结束日期 |
557| `unrestricted_avg_pledge_ratio` | float | 无限售条件股份平均质押率 |
558| `restricted_avg_pledge_ratio` | float | 有限售条件股份平均质押率 |
559| `pledge_number` | float | 质押笔数 |
560| `pledge_volume` | float | 质押数量 |
561| `init_amount` | float | 初始交易金额 |
562| `repurchase_amount` | float | 购回交易金额 |
563
564## `get_stock_status_change`
565
566用途:获取合约特殊处理数据
567
568### 入参
569
570| 参数 | 类型 | 必填 | 说明 |
571|---|---|---|---|
572| `symbol` | Optional[Union[string, List[string]]] | 否 | 股票代码 |
573| `start_date` | Optional[string] | 否 | 开始日期,eg:"20250702" |
574| `end_date` | Optional[string] | 否 | 结束日期,eg:"20250702" |
575| `fields` | Optional[Union[string, List[string]]] | 否 | 返回字段列表 |
576
577### 返回字段
578
579| 字段 | 类型 | 说明 |
580|---|---|---|
581| `symbol` | string | 股票代码 |
582| `date` | string | 信息发布日期 |
583| `change_date` | string | 特别处理(或撤销)实施日期 |
584| `description` | string | 特别处理(或撤销)事项描述 |
585| `name` | string | 股票名称 |
586| `type` | string | 特别处理(或撤销)类别 |
587
588## `get_fina_forecast`
589
590用途:获取业绩预告数据
591
592### 入参
593
594| 参数 | 类型 | 必填 | 说明 |
595|---|---|---|---|
596| `symbol` | Optional[Union[string, List[string]]] | 否 | 股票代码,可以是单个字符串或字符串列表 |
597| `fields` | Optional[Union[string, List[string]]] | 否 | 需要返回的字段列表 |
598| `info_date` | Optional[string] | 否 | 信息发布日期,格式为 "YYYYMMDD" |
599| `end_quarter` | Optional[string] | 否 | 报告季度,格式为 "YYYYqN" |
600
601### 返回字段
602
603| 字段 | 类型 | 说明 |
604|---|---|---|
605| `symbol` | string | 股票代码 |
606| `info_date` | string | 信息发布日期 |
607| `end_date` | string | 报告日期 |
608| `forecast_type` | string | 整体业绩预期 |
609| `forecast_description` | string | 业绩预期时间段描述 |
610| `forecast_growth_rate_floor` | float | 最小预期增长幅度 |
611| `forecast_growth_rate_ceiling` | float | 最大预期增长幅度 |
612| `forecast_earning_floor` | float | 最小预期收入 |
613| `forecast_earning_ceiling` | float | 最大预期收入 |
614| `forecast_np_floor` | float | 最小预期净利润 |
615| `forecast_np_ceiling` | float | 最大预期净利润 |
616| `forecast_eps_floor` | float | 最小预期每股 |
617| `forecast_eps_ceiling` | float | 最大预期每股收益 |
618| `net_profit_yoy_const_forecast` | float | 一致预期净利润增幅 |
619| `forecast_ne_ceiling` | float | 最小预测归母股东权益 |
620| `forecast_ne_floor` | float | 最大预测归母股东权益 |