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 请求：

```bash
curl -s -X POST https://www.codebuddy.cn/v2/tool/financedata \
  -H "Content-Type: application/json" \
  -d '{
    "api_name": "<接口名>",
    "params": {<根据文档填写参数>},
    "fields": "<根据需求选择返回字段，留空返回全部>"
  }'
```

### Step 5: 解析和展示结果

API 返回格式为：
```json
{
  "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` |