finance-data-retrieval

name	finance-data-retrieval
description	金融数据智能检索。根据用户的自然语言描述，自动识别需要的数据接口， 查阅 API 文档，构造请求并返回数据。覆盖股票、指数、期货、债券、 基金、宏观经济等 15 大类 209 个接口。 触发词：查行情、看股票、财务数据、基金净值、期货行情、宏观数据、 涨停股、龙虎榜、资金流向、利率、CPI、GDP、可转债、ETF、港股、美股。

金融数据智能检索

根据用户的自然语言需求，自动检索金融数据。

工作流程

Step 1: 理解用户意图

分析用户的自然语言请求，提取关键信息：

• 数据类型：股票行情、财务报表、宏观指标、基金净值等
• 具体标的：股票代码、指数名称、期货品种等
• 时间范围：日期、时间段
• 数据粒度：日线、分钟线、周线、月线等

Step 2: 查找目标 API

根据提取的意图，在下方 API 索引 中找到匹配的接口名称（api_name）。

匹配策略：

1. 先根据大类缩小范围（如“沪深300成分股”→ 指数专题）
2. 再在子分类中定位具体接口（如“成分和权重”→ index_weight）
3. 如果用户意图模糊，选择最常用的接口并在返回结果时说明

索引中找不到时的降级策略：

如果在 API 索引中没有找到明确匹配的接口，不要直接放弃。按以下顺序尝试：

1. 浏览相关分类目录：用 Glob 工具扫描可能相关的 references 子目录，查看是否有遍漏的接口文档

   Glob: references/股票数据/特色数据/*.md
   Glob: references/指数专题/*.md
   

2. 读取完整索引：读取 references/MAP.md 查看完整的接口目录树，可能有索引未列出的接口
3. 按关键词搜索文档内容：用 Grep 工具在 references 目录中搜索用户描述的关键词

   Grep: pattern="涨停" path="references/"
   Grep: pattern="北向资金" path="references/"
   

4. 如果以上方法都无法找到匹配接口，才告知用户该数据不在当前接口覆盖范围内

Step 3: 查阅 API 详细文档

找到目标 api_name 后，必须先读取对应的接口文档，再构造调用。不要凭猜测填写参数。

具体操作：

1. 根据下方 文档查阅路径映射，确定文档所在目录
2. 用 Read 工具读取该文档，例如：

   Read: references/股票数据/行情数据/历史日线.md
   

3. 从文档中提取以下关键信息：
   • 输入参数：哪些必填、哪些可选、参数类型和格式
   • 输出字段：可返回的字段列表，用于按需选择 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 中的错误信息
• 数据量大时，摘要展示并说明总条数

重要注意事项

1. 代码格式：股票代码带交易所后缀（如 000001.SZ、600000.SH、430047.BJ）
2. 日期格式：大多数接口使用 YYYYMMDD（如 20250301），新闻类接口使用 YYYY-MM-DD HH:mm:ss
3. 必填参数：部分接口有必填参数（如期货合约信息需要 exchange），务必从文档确认
4. 数据限量：部分接口有单次返回上限，需要分页请求
5. 已停用接口：标记"停"的接口不可调用，索引中已标注
6. 仅SDK接口：标记"仅SDK"的接口不支持 HTTP 调用（如 pro_bar 复权行情、实时爬虫接口），改用对应的 HTTP 接口
7. 已下线接口：标记"已下线"的接口服务端已移除，无法调用。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