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