金融数据智能检索
根据用户的自然语言需求,自动检索金融数据。
工作流程
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 |
Decide Fit First
Design Intent
How To Use It
Boundaries And Review