| name | finance-data-retrieval |
| description | 金融数据智能检索。根据用户的自然语言描述，自动识别需要的数据接口， 查阅 API 文档，构造请求并返回数据。覆盖股票、指数、期货、债券、 基金、宏观经济等 15 大类 209 个接口。 触发词：查行情、看股票、财务数据、基金净值、期货行情、宏观数据、 涨停股、龙虎榜、资金流向、利率、CPI、GDP、可转债、ETF、港股、美股。
|
金融数据智能检索
根据用户的自然语言需求，自动检索金融数据。
工作流程
Step 1: 理解用户意图
分析用户的自然语言请求，提取关键信息：
- 数据类型：股票行情、财务报表、宏观指标、基金净值等
- 具体标的：股票代码、指数名称、期货品种等
- 时间范围：日期、时间段
- 数据粒度：日线、分钟线、周线、月线等
Step 2: 查找目标 API
根据提取的意图，在下方 API 索引 中找到匹配的接口名称（api_name）。
匹配策略：
- 先根据大类缩小范围（如“沪深300成分股”→ 指数专题）
- 再在子分类中定位具体接口（如“成分和权重”→
index_weight）
- 如果用户意图模糊，选择最常用的接口并在返回结果时说明
索引中找不到时的降级策略：
如果在 API 索引中没有找到明确匹配的接口，不要直接放弃。按以下顺序尝试：
- 浏览相关分类目录：用 Glob 工具扫描可能相关的 references 子目录，查看是否有遍漏的接口文档
Glob: references/股票数据/特色数据/*.md
Glob: references/指数专题/*.md
- 读取完整索引：读取
references/MAP.md 查看完整的接口目录树，可能有索引未列出的接口
- 按关键词搜索文档内容：用 Grep 工具在 references 目录中搜索用户描述的关键词
Grep: pattern="涨停" path="references/"
Grep: pattern="北向资金" path="references/"
- 如果以上方法都无法找到匹配接口，才告知用户该数据不在当前接口覆盖范围内
Step 3: 查阅 API 详细文档
找到目标 api_name 后，必须先读取对应的接口文档，再构造调用。不要凭猜测填写参数。
具体操作：
- 根据下方 文档查阅路径映射，确定文档所在目录
- 用 Read 工具读取该文档，例如：
Read: references/股票数据/行情数据/历史日线.md
- 从文档中提取以下关键信息：
- 输入参数：哪些必填、哪些可选、参数类型和格式
- 输出字段：可返回的字段列表，用于按需选择 fields 参数
- 参数格式约束：日期格式（YYYYMMDD）、代码格式（000001.SZ）、枚举值等
- 调用限制：单次返回上限、权限要求等
Step 4: 构造并执行 API 调用
使用 Bash 工具执行 curl 请求：
curl -s -X POST https://www.codebuddy.cn/v2/tool/financedata \
-H "Content-Type: application/json" \
-d '{
"api_name": "<接口名>",
"params": {<根据文档填写参数>},
"fields": "<根据需求选择返回字段，留空返回全部>"
}'
Step 5: 解析和展示结果
API 返回格式为：
{
"code": 0,
"msg": "",
"data": {
"fields": ["字段1", "字段2", "..."],
"items": [["值1", "值2", "..."], ["..."]]
}
}
- 将 fields + items 转换为可读表格展示
- 如果 code 不为 0，说明 msg 中的错误信息
- 数据量大时，摘要展示并说明总条数
重要注意事项
- 代码格式：股票代码带交易所后缀（如
000001.SZ、600000.SH、430047.BJ）
- 日期格式：大多数接口使用
YYYYMMDD（如 20250301），新闻类接口使用 YYYY-MM-DD HH:mm:ss
- 必填参数：部分接口有必填参数（如期货合约信息需要 exchange），务必从文档确认
- 数据限量：部分接口有单次返回上限，需要分页请求
- 已停用接口：标记"停"的接口不可调用，索引中已标注
- 仅SDK接口：标记"仅SDK"的接口不支持 HTTP 调用（如
pro_bar 复权行情、实时爬虫接口），改用对应的 HTTP 接口
- 已下线接口：标记"已下线"的接口服务端已移除，无法调用。reference 文档保留供参考
API 接口索引
股票数据
基础数据
| 接口名 | api_name | 简述 |
|---|
| 股票列表 | stock_basic | 股票代码、名称、上市日期等基础信息 |
| 每日股本（盘前） | stk_premarket | 盘前每日股本数据 |
| 交易日历 | trade_cal | 各交易所交易日历 |
| ST股票列表 | stock_st | 每个交易日ST股票列表 |
| ST风险警示板股票 | st | 风险警示板股票及变更记录 |
| 沪深港通股票列表 | stock_hsgt | 沪深港通标的股票 |
| 股票曾用名 | namechange | 股票历史名称变更记录 |
| 上市公司基本信息 | stock_company | 上市公司详细信息 |
| 上市公司管理层 | stk_managers | 公司高管信息 |
| 管理层薪酬和持股 | stk_rewards | 高管薪酬及持股 |
| 北交所新旧代码对照 | bse_mapping | 北交所代码映射 |
| IPO新股上市 | new_share | 新股发行与上市信息 |
| 股票历史列表 | bak_basic | 历史股票列表（含退市） |
行情数据
| 接口名 | api_name | 简述 |
|---|
| 历史日线 | daily | A股日线行情（未复权） |
| 实时日线 | rt_k | 当日实时日线行情 |
| 历史分钟 | stk_mins | 1/5/15/30/60分钟行情 |
| 实时分钟 | rt_min | 实时分钟行情 |
| 周线行情 | weekly | 周线行情数据 |
| 月线行情 | monthly | 月线行情数据 |
| 复权行情 | pro_bar | 前/后复权行情（仅SDK，不支持HTTP） |
| 周/月线行情(每日更新) | stk_weekly_monthly | 每日更新的周月线 |
| 周/月线复权行情(每日更新) | stk_week_month_adj | 每日更新的复权周月线 |
| 复权因子 | adj_factor | 复权因子数据 |
| 实时Tick（爬虫） | realtime_quote | 实时逐笔行情（仅SDK） |
| 实时成交（爬虫） | realtime_tick | 实时成交数据（仅SDK） |
| 实时排名（爬虫） | realtime_list | 实时排名数据（仅SDK） |
| 每日指标 | daily_basic | 市盈率、换手率等指标 |
| 通用行情接口 | pro_bar | 通用行情获取（仅SDK，不支持HTTP） |
| 每日涨跌停价格 | stk_limit | 涨跌停价格数据 |
| 每日停复牌信息 | suspend_d | 停复牌信息 |
| 沪深股通十大成交股 | hsgt_top10 | 沪深股通十大成交 |
| 港股通十大成交股 | ggt_top10 | 港股通十大成交 |
| 港股通每日成交统计 | ggt_daily | 港股通每日统计 |
| 港股通每月成交统计 | ggt_monthly | 港股通每月统计 |
| 备用行情 | bak_daily | 备用日线行情 |
财务数据
| 接口名 | api_name | 简述 |
|---|
| 利润表 | income | 上市公司利润表 |
| 资产负债表 | balancesheet | 上市公司资产负债表 |
| 现金流量表 | cashflow | 上市公司现金流量表 |
| 业绩预告 | forecast | 业绩预告数据 |
| 业绩快报 | express | 业绩快报数据 |
| 分红送股数据 | dividend | 分红送股信息 |
| 财务指标数据 | fina_indicator | ROE、毛利率等财务指标 |
| 财务审计意见 | fina_audit | 审计意见数据 |
| 主营业务构成 | fina_mainbz | 主营业务分类收入 |
| 财报披露日期表 | disclosure_date | 财报预约披露时间 |
参考数据
| 接口名 | api_name | 简述 |
|---|
| 前十大股东 | top10_holders | 前十大股东持股 |
| 前十大流通股东 | top10_floatholders | 前十大流通股东持股 |
| 股权质押统计数据 | pledge_stat | 质押统计 |
| 股权质押明细数据 | pledge_detail | 质押明细 |
| 股票回购 | repurchase | 股票回购记录 |
| 限售股解禁 | share_float | 限售股解禁计划 |
| 大宗交易 | block_trade | 股票大宗交易 |
| 股票开户数据（旧） | stk_account_old | 历史开户数据（2008-2015） |
| 股票开户数据（停） | stk_account | 开户数据（已停止更新） |
| 股东人数 | stk_holdernumber | 股东户数 |
| 股东增减持 | stk_holdertrade | 股东增减持明细 |
特色数据
| 接口名 | api_name | 简述 |
|---|
| 券商盈利预测数据 | report_rc | 卖方盈利预测 |
| 每日筹码及胜率 | cyq_perf | 筹码成本和胜率 |
| 每日筹码分布 | cyq_chips | 筹码分布数据 |
| 券商金股数据 | broker_recommend | 券商推荐金股 |
两融及转融通
| 接口名 | api_name | 简述 |
|---|
| 融资融券交易汇总 | margin | 两融汇总数据 |
| 融资融券交易明细 | margin_detail | 两融明细数据 |
| 融资融券标的（盘前） | margin_secs | 融资融券标的 |
| 转融资交易汇总 | slb_len | 转融资汇总 |
| 转融券交易汇总（停） | slb_sec | 转融券汇总（已停止更新） |
| 转融券交易明细（停） | slb_sec_detail | 转融券明细（已停止更新） |
| 做市借券交易汇总（停） | slb_len_mm | 做市借券汇总（已停止更新） |
资金流向数据
| 接口名 | api_name | 简述 |
|---|
| 个股资金流向 | moneyflow | 个股资金流入流出 |
| 个股资金流向（THS） | moneyflow_ths | 同花顺口径资金流向 |
| 个股资金流向（DC） | moneyflow_dc | 东财口径资金流向 |
| 板块资金流向（THS） | moneyflow_cnt_ths | 同花顺板块资金 |
| 行业资金流向（THS） | moneyflow_ind_ths | 同花顺行业资金 |
| 板块资金流向（DC） | moneyflow_ind_dc | 东财板块资金 |
| 大盘资金流向（DC） | moneyflow_mkt_dc | 东财大盘资金 |
| 沪深港通资金流向 | moneyflow_hsgt | 北向南向资金流向 |
打板专题数据
| 接口名 | api_name | 简述 |
|---|
| 龙虎榜每日统计单 | top_list | 龙虎榜数据 |
| 龙虎榜机构交易单 | top_inst | 机构龙虎榜 |
| 同花顺涨跌停榜单 | limit_list_ths | 涨跌停数据 |
| 涨跌停和炸板数据 | limit_list_d | 涨跌停及炸板 |
| 涨停股票连板天梯 | limit_step | 连板股票统计 |
| 涨停最强板块统计 | limit_cpt_list | 涨停板块排名 |
| 同花顺行业概念板块 | ths_index | 行业概念板块列表 |
| 同花顺概念和行业指数行情 | ths_daily | 板块指数行情 |
| 同花顺行业概念成分 | ths_member | 板块成分股 |
| 东方财富概念板块 | dc_index | 东财概念板块 |
| 东方财富概念成分 | dc_member | 东财概念成分 |
| 东财概念和行业指数行情 | dc_daily | 东财板块行情 |
| 开盘竞价成交（当日） | stk_auction | 竞价数据 |
| 市场游资最全名录 | hm_list | 游资名录 |
| 游资交易每日明细 | hm_detail | 游资交易明细 |
| 同花顺App热榜 | ths_hot | 同花顺热搜 |
| 东方财富App热榜 | dc_hot | 东财热搜 |
| 通达信板块信息 | tdx_index | 通达信板块 |
| 通达信板块成分 | tdx_member | 通达信成分 |
| 通达信板块行情 | tdx_daily | 通达信行情 |
| 榜单数据（开盘啦） | kpl_list | 开盘啦榜单 |
| 题材成分（开盘啦） | kpl_concept_cons | 开盘啦题材成分 |
ETF专题
| 接口名 | api_name | 简述 |
|---|
| ETF基本信息 | etf_basic | ETF基础信息 |
| ETF基准指数 | etf_index | ETF跟踪指数 |
| ETF实时分钟 | rt_min | ETF实时分钟 |
| ETF历史分钟 | stk_mins | ETF历史分钟 |
| ETF实时日线 | rt_etf_k | ETF实时日线 |
| ETF日线行情 | fund_daily | ETF日线行情 |
| ETF复权因子 | fund_adj | ETF复权因子 |
| ETF份额规模 | etf_share_size | ETF规模数据 |
指数专题
| 接口名 | api_name | 简述 |
|---|
| 指数基本信息 | index_basic | 指数基础信息 |
| 指数日线行情 | index_daily | 指数日线 |
| 指数实时日线 | rt_idx_k | 指数实时日线 |
| 指数实时分钟 | rt_idx_min | 指数实时分钟 |
| 指数周线行情 | index_weekly | 指数周线 |
| 指数历史分钟 | idx_mins | 指数历史分钟 |
| 指数月线行情 | index_monthly | 指数月线 |
| 指数成分和权重 | index_weight | 指数成分及权重 |
| 大盘指数每日指标 | index_dailybasic | 指数PE/PB等指标 |
| 申万行业分类 | index_classify | 申万行业分类体系 |
| 申万行业成分（分级） | index_member_all | 申万行业成分股 |
| 申万行业指数日行情 | sw_daily | 申万指数行情 |
| 申万实时行情 | rt_sw_k | 申万实时行情 |
| 中信行业成分 | ci_index_member | 中信行业成分 |
| 中信行业指数日行情 | ci_daily | 中信指数行情 |
| 国际主要指数 | index_global | 国际指数行情 |
| 指数技术面因子(专业版) | idx_factor_pro | 指数技术因子 |
| 沪深市场每日交易统计 | daily_info | 沪深交易统计 |
| 深圳市场每日交易情况 | sz_daily_info | 深圳交易统计 |
公募基金
| 接口名 | api_name | 简述 |
|---|
| 基金列表 | fund_basic | 公募基金基本信息 |
| 基金管理人 | fund_company | 基金公司信息 |
| 基金经理 | fund_manager | 基金经理信息 |
| 基金规模 | fund_share | 基金份额规模 |
| 基金净值 | fund_nav | 基金净值数据 |
| 基金分红 | fund_div | 基金分红记录 |
| 基金持仓 | fund_portfolio | 基金持仓明细 |
| 基金技术面因子(专业版) | fund_factor_pro | 基金技术因子 |
期货数据
| 接口名 | api_name | 简述 |
|---|
| 合约信息 | fut_basic | 期货合约列表（需exchange参数） |
| 交易日历 | trade_cal | 期货交易日历 |
| 日线行情 | fut_daily | 期货日线行情 |
| 期货周/月线行情(每日更新) | fut_weekly_monthly | 期货周月线 |
| 历史分钟行情 | ft_mins | 期货历史分钟 |
| 实时分钟行情 | rt_fut_min | 期货实时分钟 |
| 仓单日报 | fut_wsr | 仓单数据 |
| 每日结算参数 | fut_settle | 结算参数 |
| 历史Tick行情 | — | 仅网盘交付，无API |
| 每日持仓排名 | fut_holding | 持仓排名 |
| 南华期货指数行情 | index_daily | 南华指数 |
| 期货主力与连续合约 | fut_mapping | 主力合约映射 |
| 期货主要品种交易周报 | fut_weekly_detail | 品种周报 |
| 期货合约涨跌停价格 | ft_limit | 期货涨跌停 |
现货数据
| 接口名 | api_name | 简述 |
|---|
| 黄金现货基础信息 | sge_basic | 上海金交所产品信息 |
| 现货黄金日行情 | sge_daily | 黄金现货行情 |
期权数据
| 接口名 | api_name | 简述 |
|---|
| 期权合约信息 | opt_basic | 期权合约列表 |
| 期权日线行情 | opt_daily | 期权日线行情 |
债券专题
| 接口名 | api_name | 简述 |
|---|
| 可转债基础信息 | cb_basic | 可转债基本信息 |
| 可转债发行 | cb_issue | 可转债发行数据 |
| 可转债赎回信息 | cb_call | 可转债赎回 |
| 可转债票面利率 | cb_rate | 可转债利率 |
| 可转债行情 | cb_daily | 可转债日线行情 |
| 可转债技术面因子(专业版) | cb_factor_pro | 可转债技术因子 |
| 可转债转股价变动 | cb_price_chg | 转股价调整 |
| 可转债转股结果 | cb_share | 转股结果 |
| 债券回购日行情 | repo_daily | 债券回购行情 |
| 柜台流通式债券报价 | bc_otcqt | 柜台债券报价 |
| 柜台流通式债券最优报价 | bc_bestotcqt | 柜台最优报价 |
| 大宗交易 | bond_blk | 债券大宗交易 |
| 大宗交易明细 | bond_blk_detail | 债券大宗明细 |
| 国债收益率曲线 | yc_cb | 国债收益率 |
| 全球财经事件 | eco_cal | 全球财经日历 |
外汇数据
| 接口名 | api_name | 简述 |
|---|
| 外汇基础信息（海外） | fx_obasic | 外汇品种信息 |
| 外汇日线行情 | fx_daily | 外汇日线行情 |
港股数据
| 接口名 | api_name | 简述 |
|---|
| 港股列表 | hk_basic | 港股基本信息 |
| 港股日线行情 | hk_daily | 港股日线 |
| 港股分钟行情 | hk_mins | 港股分钟 |
美股数据
| 接口名 | api_name | 简述 |
|---|
| 美股基础信息 | us_basic | 美股基本信息 |
| 美股交易日历 | us_tradecal | 美股交易日历 |
| 美股日线行情 | us_daily | 美股日线 |
| 美股复权行情 | us_daily_adj | 美股复权行情 |
| 美股复权因子 | us_adjfactor | 美股复权因子 |
| 美股利润表 | us_income | 美股利润表 |
| 美股资产负债表 | us_balancesheet | 美股资产负债表 |
| 美股现金流量表 | us_cashflow | 美股现金流量表 |
| 美股财务指标数据 | us_fina_indicator | 美股财务指标 |
行业经济
TMT行业
| 接口名 | api_name | 简述 |
|---|
| 台湾电子产业月营收 | tmt_twincome | 台湾电子月营收 |
| 台湾电子产业月营收明细 | tmt_twincomedetail | 台湾电子营收明细 |
| 电影月度票房（已下线） | bo_monthly | 月度票房（接口已下线，不可调用） |
| 电影周度票房（已下线） | bo_weekly | 周度票房（接口已下线，不可调用） |
| 电影日度票房（已下线） | bo_daily | 日度票房（接口已下线，不可调用） |
| 影院日度票房（已下线） | bo_cinema | 影院票房（接口已下线，不可调用） |
| 全国电影剧本备案数据（已下线） | film_record | 电影剧本备案（接口已下线，不可调用） |
| 全国电视剧备案公示数据 | teleplay_record | 电视剧备案 |
宏观经济
利率数据
| 接口名 | api_name | 简述 |
|---|
| Shibor利率 | shibor | 上海银行间拆放利率 |
| Shibor报价数据 | shibor_quote | Shibor报价明细 |
| LPR贷款基础利率 | shibor_lpr | 贷款市场报价利率 |
| Libor利率 | libor | 伦敦银行间拆放利率 |
| Hibor利率 | hibor | 香港银行间拆放利率 |
| 温州民间借贷利率 | wz_index | 温州民间利率 |
| 广州民间借贷利率 | gz_index | 广州民间利率 |
国民经济
| 接口名 | api_name | 简述 |
|---|
| 国内生产总值（GDP） | cn_gdp | GDP数据 |
价格指数
| 接口名 | api_name | 简述 |
|---|
| 居民消费价格指数（CPI） | cn_cpi | CPI数据 |
| 工业生产者出厂价格指数（PPI） | cn_ppi | PPI数据 |
大模型语料专题数据
| 接口名 | api_name | 简述 |
|---|
| 新闻快讯 | news | 主流媒体新闻快讯 |
| 新闻通讯（长篇新闻） | major_news | 长篇新闻报道 |
| 新闻联播文字稿 | cctv_news | 央视新闻联播文字稿 |
| 公告原文 | anns_d | 上市公司公告原文 |
财富管理
| 接口名 | api_name | 简述 |
|---|
| 基金销售行业数据 | — | 数据陆续上线中，暂无API |
文档查阅路径映射
当需要查看某个 API 的详细参数和字段定义时，按以下路径读取文档：
| 数据类别 | 文档路径 |
|---|
| 股票基础数据 | references/股票数据/基础数据/<接口名>.md |
| 股票行情数据 | references/股票数据/行情数据/<接口名>.md |
| 股票财务数据 | references/股票数据/财务数据/<接口名>.md |
| 股票参考数据 | references/股票数据/参考数据/<接口名>.md |
| 股票特色数据 | references/股票数据/特色数据/<接口名>.md |
| 两融及转融通 | references/股票数据/两融及转融通/<接口名>.md |
| 资金流向数据 | references/股票数据/资金流向数据/<接口名>.md |
| 打板专题数据 | references/股票数据/打板专题数据/<接口名>.md |
| ETF | references/ETF专题/<接口名>.md |
| 指数 | references/指数专题/<接口名>.md |
| 公募基金 | references/公募基金/<接口名>.md |
| 期货 | references/期货数据/<接口名>.md |
| 现货 | references/现货数据/<接口名>.md |
| 期权 | references/期权数据/<接口名>.md |
| 债券 | references/债券专题/<接口名>.md |
| 外汇 | references/外汇数据/<接口名>.md |
| 港股 | references/港股数据/<接口名>.md |
| 美股 | references/美股数据/<接口名>.md |
| TMT行业 | references/行业经济/TMT行业/<接口名>.md |
| 利率数据 | references/宏观经济/国内宏观/利率数据/<接口名>.md |
| 国民经济 | references/宏观经济/国内宏观/国民经济/<接口名>.md |
| 价格指数 | references/宏观经济/国内宏观/价格指数/<接口名>.md |
| 新闻语料 | references/大模型语料专题数据/<接口名>.md |
| 财富管理 | references/财富管理/<接口名>.md |
| 完整索引 | references/MAP.md |
