# FIU MCP 产品说明与接入手册
FIU MCP 将金融数据查询能力提供给支持 Model Context Protocol（MCP）的 AI 应用与开发工具。本文面向产品评估、客户端配置和接口集成，覆盖 **26 个业务工具集、104 个端点**，并提供连接配置、参数说明与调用结构示例。
文档基线：2026-10-23，按当前工作区 MCP 代码、公开工具 schema、端点契约与路由核对。目录名保留原归档名称。本文完整包含产品能力、接入配置和端点入参说明，可独立阅读与交付。远端部署版本不同时，以实际 `tools/list` 和 `describe_tool` 返回为准。
## 目录
1. [产品与 MCP 介绍](#overview)
2. [接入配置指引](#connection)
3. [工具调用规则](#calling)
4. [工具集与端点功能总表](#catalog)
5. [端点入参明细](#parameters)
6. [返回结果说明](#responses)
7. [常见问题与排错](#troubleshooting)
8. [版本与验证范围](#sources)
## 1. 产品与 MCP 介绍
### 1.1 MCP 是什么
MCP 是 AI 应用连接外部工具和数据服务的开放协议。客户端通过协议获取可用工具及其参数定义，再按用户任务发起工具调用。FIU MCP 在这一协议下提供金融数据查询能力；客户端负责连接和展示，FIU 服务负责校验查询条件并返回数据。
| 概念 | 在 FIU MCP 中的含义 | 示例 |
| ---------------- | ------------------------------------------------------- | -------------------------------------------------- |
| MCP 客户端 | 发起连接、发现工具和调用工具的应用 | Claude Desktop、Claude Code、Cursor、Cherry Studio |
| MCP 服务 | 对外提供工具与数据的 FIU 服务 | `https://ai.szfiu.com/api/mcp/v2` |
| 工具集 | 以功能域划分的 MCP 工具，调用时填写`name` | `quote_spot`、`f10_financials`、`fund_data` |
| 端点（endpoint） | 工具集内的具体业务能力，通过`arguments.endpoint` 选择 | `get_quote`、`get_financial_statement` |
| 业务入参 | 限定市场、标的、日期、查询类型等条件的字段 | `market`、`symbols`、`statementType` |
| 下游 API | FIU 服务为完成查询而连接的数据接口 | 一个业务端点可以覆盖或聚合多个 API |
这里的 `endpoint` 是业务能力标识，不是独立的 HTTP URL。业务工具通过同一个 MCP 服务地址调用，无需为每个端点拼接 URL。
### 1.2 连接架构
```mermaid
flowchart LR
A[支持 stdio 的 MCP 客户端] -->|stdio| B[本地 fiu-finance-mcp 适配器]
B -->|Streamable HTTP / HTTPS| D[FIU MCP 服务]
C[支持 Streamable HTTP 的 MCP 客户端] -->|HTTPS 直连| D
D --> E[金融数据 API]
E -->|查询结果| D
```
两种方式连接同一远程服务。npm/npx 方式由客户端启动本地 stdio 适配器，需要本机 Node.js；HTTP 直连由客户端直接访问远程地址，无需安装本地适配器。
### 1.3 数据能力与边界
| 能力领域 | 主要内容 |
| ---------- | ---------------------------------------------------------------------- |
| 行情与交易 | 证券搜索、快照、买卖盘、逐笔成交、分时、K线、港股衍生品、美股期权 |
| 市场数据 | 市场统计、排行、资金流、行业与指数、筹码成本、互联互通 |
| 公司与财务 | 公司资料、高管、财务报表、关键指标、主营构成、公司行动、股东与机构持股 |
| 基金与债券 | 全球基金搜索、净值、业绩、风险、持仓、配置，以及债券行情、收益率和排行 |
| 新股 | 港股与美股 IPO 列表、招股详情、认购、承销商、基石投资者和新股资讯 |
| 资讯与事件 | 新闻、上市公司公告及附件、财经日历、精选宏观数据 |
| 参考数据 | 证券标识、代码映射、市场交易时段与状态 |
具体市场、资产类型和历史范围以各端点说明为准。财务报表和公司行动属于结构化数据；公告查询使用 `company_announcements`，新闻使用 `fiu_news`，IPO 公告使用 `ipo` 中的专用端点。当前目录不提供研报全文搜索，也不构成选股、回测或交易执行服务。
## 2. 接入配置指引
### 2.1 前置条件
1. 访问 [ai.szfiu.com](https://ai.szfiu.com) 申请 API Key。
2. HTTP 直连需要支持 **Streamable HTTP** 和自定义请求头的 MCP 客户端。
3. npm/npx 接入需要 **Node.js 20.18.1 或更高版本**，并确保客户端启动的进程能够找到 `node`、`npm` 和 `npx`。
版本检查：
```bash
node --version
npm --version
npx --version
```
### 2.2 选择接入方式
| 方式 | 适用场景 | 必要配置 |
| -------------------- | ----------------------------------- | -------------------------------------- |
| npm/npx + stdio | 客户端通过本地命令启动 MCP 服务 | `command`、`args`、`FIU_API_KEY` |
| Streamable HTTP 直连 | 客户端支持远程 MCP 地址与鉴权请求头 | 服务 URL、`Authorization` |
下列 `YOUR_API_KEY` 均需替换为实际 API Key。配置完成后重启 MCP 客户端或重新连接服务。
### 2.3 通过 npm/npx 接入
无需预先全局安装即可启动本地适配器。
macOS / Linux：
```bash
FIU_API_KEY=YOUR_API_KEY npx -y fiu-finance-mcp
```
Windows PowerShell：
```powershell
$env:FIU_API_KEY="YOUR_API_KEY"
npx -y fiu-finance-mcp
```
全局安装与启动：
```bash
npm install -g fiu-finance-mcp
fiu-finance-mcp --api-key YOUR_API_KEY
```
Claude Desktop、Cursor 等使用 stdio 的客户端可配置为：
```json
{
"mcpServers": {
"fiu-finance": {
"command": "npx",
"args": ["-y", "fiu-finance-mcp"],
"env": {
"FIU_API_KEY": "YOUR_API_KEY"
}
}
}
}
```
该模式通过标准输入输出传递 MCP 消息。手动启动后等待输入不等于服务失败，实际使用时由 MCP 客户端管理适配器进程。
### 2.4 CLI 参数
| 参数 | 说明 |
| ------------------------- | ------------------------------------------------------------------ |
| `-k, --api-key ` | FIU API Key，优先级高于`FIU_API_KEY` 环境变量 |
| `-u, --url ` | 覆盖远程 MCP 地址，默认`https://ai.szfiu.com/api/mcp/v2` |
| `--header ` | 添加自定义请求头，可重复使用，并支持`${ENV_NAME}` 环境变量占位符 |
| `--debug` | 启用代理调试日志 |
| `--silent` | 仅输出错误日志 |
| `-h, --help` | 显示帮助 |
| `-v, --version` | 显示 CLI 版本 |
`--connect-timeout`、`--headers-timeout`、`--body-timeout`、`--keep-alive`、`--ping-interval`、`--ipv4` 和 `--ignore-tool` 等参数传递给底层代理，具体单位和取值以 `fiu-finance-mcp --help` 为准。
### 2.5 Streamable HTTP 直连
| 配置项 | 值 |
| ---------- | -------------------------------------- |
| 传输协议 | Streamable HTTP |
| 服务地址 | `https://ai.szfiu.com/api/mcp/v2` |
| 鉴权请求头 | `Authorization: Bearer YOUR_API_KEY` |
客户端配置：
```json
{
"mcpServers": {
"fiu-finance": {
"type": "streamableHttp",
"url": "https://ai.szfiu.com/api/mcp/v2",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
Claude Code 命令：
```bash
claude mcp add --transport http fiu-finance https://ai.szfiu.com/api/mcp/v2 --header "Authorization: Bearer YOUR_API_KEY"
```
API Key 放在 HTTP 请求头中，不放入业务 `params`。配置字段名随客户端变化，例如地址字段可能为 `url` 或 `baseUrl`，以客户端要求为准。
### 2.6 客户端配置位置
| 客户端 | 配置入口 | 接入建议 |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
| Claude Desktop | Windows：`%APPDATA%\Claude\claude_desktop_config.json`；macOS：`~/Library/Application Support/Claude/claude_desktop_config.json` | 使用上面的 stdio 配置 |
| Cursor | 全局`~/.cursor/mcp.json`，或项目 `.cursor/mcp.json` | 使用 stdio 或客户端支持的 HTTP 配置；HTTP 的`type` 字段按版本要求填写 |
| Claude Code | `claude mcp add` 命令 | 使用上述 HTTP 命令，随后可运行`claude mcp list` 检查配置 |
| Cherry Studio | 设置中的 MCP 服务配置 | 选择 Streamable HTTP，填写服务地址和 Authorization 请求头 |
| 其他客户端 | MCP 服务或连接设置 | 根据客户端支持情况选择 stdio 或 Streamable HTTP |
### 2.7 验证连接
1. 保存配置并重启客户端或重新连接服务。
2. 获取 `tools/list`，确认出现 `quote_spot`、`describe_tool` 等 FIU 工具。当前本地版本为 26 个业务工具集加 `describe_tool`、`search`，共 28 个 MCP 工具。
3. 调用 `describe_tool` 确认目标端点的契约，再执行查询。
以下 JSON 是传给 MCP `tools/call` 的参数对象：
```json
{
"name": "describe_tool",
"arguments": {
"toolNames": ["quote_spot", "get_quote"],
"detail": "params"
}
}
```
自行实现 HTTP 客户端时，应完成 `initialize`、`notifications/initialized` 和后续工具调用。服务端返回 `Mcp-Session-Id` 时，后续请求携带该会话头，并使用协商的协议版本。HTTP `Accept` 应支持 `application/json, text/event-stream`。普通 MCP 客户端通常会处理这些步骤。
## 3. 工具调用规则
### 3.1 推荐调用流程
```mermaid
flowchart LR
A[确定查询目标] --> B{是否已有业务标识}
B -->|没有| C[证券或基金搜索]
B -->|已有| D[查询端点说明]
C --> D
D --> E[按契约填写参数]
E --> F[调用业务工具集]
F --> G[检查结果状态与数据]
```
证券代码未知时可使用独立 `search` 工具；基金标识未知时使用 `fund_data.search_funds`。已知有效标识时可直接调用目标端点。不确定参数时，先调用 `describe_tool`。
### 3.2 区分三层参数
| 层级 | 字段 | 作用 |
| ------------- | ------------------------------------ | ------------------------ |
| JSON-RPC 请求 | `method: "tools/call"`、`params` | 表示发起 MCP 工具调用 |
| MCP 工具调用 | `name`、`arguments` | 选择工具集并提供工具参数 |
| 业务调用 | `arguments.endpoint` 与业务字段 | 选择端点并限定查询条件 |
20 个工具集的公开 schema 使用 `arguments.params`；第 3.3 节列出的六个工具集将业务字段放在 `arguments` 顶层。例如，行情查询的完整 JSON-RPC 请求结构为：
```json
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "quote_spot",
"arguments": {
"endpoint": "get_quote",
"params": {
"market": "HK",
"assetType": "stock",
"symbols": ["00700.hk"]
}
}
}
}
```
后续端点示例只展示其中的 `name` 与 `arguments`，可直接作为 `tools/call` 的参数。客户端若已选定工具名，其参数编辑器通常只需填写 `arguments` 对象的内容。
### 3.3 顶层业务参数工具集
以下六个工具集的标准参数结构将业务字段直接放在 `arguments` 中：
| 工具集 | 端点 |
| ---------------------------- | ----------------------------- |
| `market_overview` | `get_market_statistics` |
| `market_flow` | `get_capital_flow` |
| `market_position_cost` | `get_position_cost` |
| `shareholding_institution` | `get_institution_holding` |
| `macro_economics` | `get_macro_overview` |
| `company_announcements` | `get_company_announcements` |
```json
{
"name": "market_overview",
"arguments": {
"endpoint": "get_market_statistics",
"market": "HK"
}
}
```
`market_ranking` 使用 `endpoint + params`，由端点名称确定市场，`params.rankType` 必填。不同排行类型允许的字段不同，应按分支参数表填写。
### 3.4 市场、标识与日期
| 项目 | 约定 |
| ------------ | ---------------------------------------------------------------------------------------------------------- |
| 市场代码 | `HK` 港股、`US` 美股、`CN` A股、`JP` 日股、`GLOBAL` 债券；仅明确支持跨市场查询的端点可用 `ALL` |
| IPO 市场 | IPO 是功能域，不是`market` 取值；港股新股用 `HK`，美股新股用 `US` |
| 股票代码 | 例如`00700.hk`、`AAPL.us`、`600519.sh`、`000001.sz`、`6758.jp` |
| 新闻标的 | 部分新闻端点使用不带交易所后缀的标识，例如`NVDA`，以端点字段说明为准 |
| 基金标识 | 使用`fund_id` 或 `fund_class_id`；相关详情接口要求二选一且只传一个 |
| 债券标识 | 按端点要求传债券代码或 ISIN，例如`US91282CHZ77` |
| IPO 详情标识 | 使用列表返回的`code`，不以普通股票 `symbol` 替代 |
| 日期 | 通常为`YYYY-MM-DD`；日期时间通常为 `YYYY-MM-DD HH:mm:ss`，具体以端点为准 |
| K线 | `get_kline` 使用截止日期 `date` 和根数 `limit`，不使用 `startDate` / `endDate` 区间 |
| 分页 | 行情等通常用`pageNum` / `pageSize`；基金使用从 0 开始的 `page` 和 `page_size` |
### 3.5 参数表阅读方式
| 标记 | 含义 |
| -------- | -------------------------------------------------------------- |
| 是 | 当前端点或当前分支必填 |
| 否 | 非固定必填；仍需遵循字段适用范围与组合规则 |
| 条件必填 | 满足说明中的查询条件时必填 |
| 二选一 | 关联字段恰好提供一个，如`fund_id` 与 `fund_class_id` |
| 组合必填 | 多个字段合并满足条件，如基金对比的两个列表合计 2-10 个且不重复 |
| 未声明 | 当前契约没有提供默认值，不能视为 0、空字符串或固定业务日期 |
枚举代表允许值，不代表所有值在所有市场或分支中均可使用。参数类型中的 `[]` 表示数组；`string\|null` 表示字符串或空值。示例中的 `<...>` 是待替换的业务标识，应从相应搜索或列表结果获取。示例日期和证券代码仅说明格式，不保证该查询在所有时间都有数据。
### 3.6 辅助工具
| 工具 | 参数 | 类型 | 规则 |
| ----------------- | ------------- | ------------ | ------------------------------------------- |
| `describe_tool` | `toolNames` | `string[]` | 推荐使用，传 1-5 个工具集或端点名称 |
| `describe_tool` | `toolName` | `string` | 单名称兼容字段，优先使用`toolNames` |
| `describe_tool` | `detail` | `string` | `summary` 或 `params`，默认 `summary` |
| `search` | `key` | `string` | 顶层搜索关键词，例如公司名称或证券代码 |
```json
{
"name": "search",
"arguments": {
"key": "腾讯"
}
}
```
当前 `describe_tool` 的公开入参只有 `toolNames`、`toolName`、`detail`。模块说明可能返回分页元数据，但当前公开 schema 未声明 `page`、`pageSize` 或 `fields`，请按具体 endpoint 名称查询，避免把模块首批端点当作完整目录。
调用结构以 `tools/list.inputSchema` 为准：部分 `describe_tool.callContract` 使用顶层兼容写法，本手册示例统一采用各工具集公开 schema 的字段位置。不要嵌套为 `arguments.params.params`。
### 3.7 实时与延时参数
`timeMode` 区分大小写，常见值为数值 0（实时）和 1（延时）。参数可选不代表每个市场或分支都支持。港股股票排行仅允许 0；行业/指数接口按指定分支使用；港股衍生品扩展行情当前仍固定发送 0。具体差异已写入对应端点说明。
## 4. 工具集与端点功能总表
覆盖 26 个工具集、104 个业务端点，另有 `describe_tool`、`search` 两个辅助工具，共 28 个 MCP 工具。下游 API 数量按每个端点关联的“服务 + API 名称”去重，包含公司资料、IPO 资料、公告附件和 US 分部财年核验等聚合调用；它表示覆盖接口数，不代表单次调用次数。不同端点可能复用 API，逐行数量不可直接相加作为全局去重数。
| 工具集 | 端点名称 | 中文名称 | 功能说明 | 下游API数量 |
| --- | --- | --- | --- | --- |
| 现货行情工具集
quote_spot | search_security | 证券搜索 | 按指定市场搜索股票、ETF、指数、窝轮或本地市场债券；基金使用 fund_data，美国及全球债券使用 bond_basic.search_bond。 | 5 |
| 现货行情工具集
quote_spot | get_security_profile | 证券基础资料 | 查询股票、ETF、指数、权证或债券的静态基础资料；基金请使用 fund_data 工具集。 | 6 |
| 现货行情工具集
quote_spot | get_quote | 证券行情 | 查询股票和债券的实时/快照行情；ETF、指数和港股窝轮使用对应专用接口。 | 9 |
| 现货行情工具集
quote_spot | get_security_definition | 证券定义与码表 | 查询证券码表详情、新股参考列表等证券定义类数据。 | 5 |
| 盘中行情工具集
quote_intraday | get_orderbook | 实时买卖盘 | 查询股票、ETF、指数和债券的买卖盘/盘口。 | 5 |
| 盘中行情工具集
quote_intraday | get_trades | 逐笔成交 | 查询股票、ETF、指数的逐笔成交和历史逐笔。 | 4 |
| 盘中行情工具集
quote_intraday | get_intraday_trend | 分时走势 | 查询股票、ETF、指数和债券的盘中分时走势。 | 5 |
| 盘中行情工具集
quote_intraday | get_trade_history | 历史逐笔成交 | 查询证券逐笔成交历史数据。 | 2 |
| 盘中行情工具集
quote_intraday | get_trade_statistics | 成交统计 | 查询成交统计总览和成交统计明细。 | 8 |
| 盘中行情工具集
quote_intraday | get_mini_trend | 日股迷你分时图 | 查询日股迷你分时图。 | 1 |
| K 线工具集
quote_kline | get_kline | 历史K线 | 查询股票、指数、债券的历史K线/走势；使用截止日期 date 和返回根数 limit。 | 5 |
| K 线工具集
quote_kline | get_jp_kline | 日股K线 | 查询日股截至指定日期或时间的最近 K 线，支持单只与批量证券，默认每只返回 20 根。 | 1 |
| K 线工具集
quote_kline | get_snapshot_history | 历史行情快照 | 查询证券历史快照数据。 | 2 |
| 港股衍生品行情工具集
quote_derivatives_hk | get_quote_extend | 港股衍生品扩展行情 | 查询港股窝轮、牛熊证等衍生品的扩展行情。 | 1 |
| 港股衍生品行情工具集
quote_derivatives_hk | get_hk_warrant_catalog | 港股窝轮与牛熊证目录 | 查询港股权证/窝轮/牛熊证目录、发行商和简介。 | 4 |
| 港股衍生品行情工具集
quote_derivatives_hk | get_hk_warrant_trading_data | 港股窝轮与牛熊证交易数据 | 查询港股权证/窝轮/牛熊证成交统计、活跃榜和历史走势。 | 3 |
| 美股期权工具集
quote_us_options | get_us_option_chain | 美股期权链 | 查询美股期权到期日、期权链、合约列表、快照和 Greeks。 | 6 |
| 美股期权工具集
quote_us_options | get_us_option_quote | 美股期权行情 | 查询美股期权合约快照、盘口、逐笔成交、K 线、分时、成交统计。 | 12 |
| 美股期权工具集
quote_us_options | get_us_option_overview | 美股期权市场概览 | 查询美股期权市场总览和 ETF 期权概览。 | 4 |
| 美股期权工具集
quote_us_options | get_us_option_rankings | 美股期权排行 | 查询美股期权排行榜。 | 3 |
| 市场概况工具集
market_overview | get_market_statistics | 市场涨跌统计 | 查询实时市场涨跌家数与涨跌幅分布；不支持按历史日期查询。 | 4 |
| 市场排行工具集
market_ranking | get_hk_ranking | 港股市场排行 | 查询港股证券、行业或概念、新股表现、经纪商持仓及A/H溢价排行。 | 5 |
| 市场排行工具集
market_ranking | get_us_ranking | 美股市场排行 | 查询美股证券、行业或概念、新股表现及ETF周期排行。 | 4 |
| 市场排行工具集
market_ranking | get_cn_ranking | A股市场排行 | 查询A股证券、行业或概念及新股表现排行。 | 3 |
| 市场排行工具集
market_ranking | get_jp_ranking | 日股市场排行 | 查询日股证券、热门股票及行业或概念排行。 | 3 |
| 资金流工具集
market_flow | get_capital_flow | 证券资金流向 | 查询指定证券的当日资金流向、近60日资金流向或资金分布。 | 12 |
| 行业与指数工具集
market_structure | get_industry_data | 行业与概念板块数据 | 查询行业列表、行业排行、行业成分股、所属行业板块。 | 12 |
| 行业与指数工具集
market_structure | get_index_data | 指数数据 | 查询指数列表、指数行情、指数成分股、指数映射、指数资金分布。 | 10 |
| 行业与指数工具集
market_structure | get_market_microstructure | 市场微观结构 | 查询市场微观结构数据，如价差、多市场溢价、双柜台、经纪席位。 | 4 |
| 筹码成本工具集
market_position_cost | get_position_cost | 筹码成本分布 | 查询筹码成本区间和筹码移动分布。 | 4 |
| 公司资料工具集
f10_profile | get_company_profile | 公司综合资料 | 查询公司基础资料、公司资料和关联资料。 | 8 |
| 公司资料工具集
f10_profile | get_company_management | 公司高管 | 查询公司高管。 | 3 |
| 公司资料工具集
f10_profile | get_company_extra_profile | 公司扩展资料 | 查询公司扩展资料或特殊证券资料，如 A 股扩展行情、港股并行交易。 | 2 |
| 财务报表工具集
f10_financials | get_financial_statement | 财务报表 | 查询利润表、资产负债表、现金流量表。 | 9 |
| 财务报表工具集
f10_financials | get_financial_indicator | 关键财务指标 | 查询关键财务指标。 | 3 |
| 公司经营治理工具集
f10_business_governance | get_business_segment | 主营构成与业务分部 | 查询主营构成/业务分部，支持按报告期、类别、日期区间和排序方向筛选。 | 4 |
| 公司经营治理工具集
f10_business_governance | get_company_action | 公司行动 | 查询证券的结构化公司行动，如分红、拆股、股东大会、回购和股本结构。 | 13 |
| 股东结构工具集
shareholding_structure | get_shareholders | 股东与持股结构 | 查询主要股东、十大股东、当前持股、股东权益明细等。 | 5 |
| 股东结构工具集
shareholding_structure | get_shareholding_change | 股本与持股变动 | 查询股本变动、高管持股变动等。 | 3 |
| 机构持股工具集
shareholding_institution | get_institution_holding | 美股机构持股 | 查询机构持股明细或统计。 | 2 |
| 券商持股与沽空工具集
shareholding_fund_broker | get_broker_holding | 港股券商持股 | 查询港股经纪商持股比例、持股详情、经纪商持仓排行。 | 5 |
| 券商持股与沽空工具集
shareholding_fund_broker | get_short_sell | 每日沽空数据 | 查询每日沽空。 | 2 |
| 基金与 ETF 工具集
fund_data | search_funds | 全球基金搜索 | 没有稳定基金标识时，按名称、Ticker 或证券标识搜索全球基金；也可列出分类、管理人和份额类别。 | 1 |
| 基金与 ETF 工具集
fund_data | get_fund_profile | 基金基本资料 | 按 fund_id 或 fund_class_id 查询基金基本资料；operation=size 查询资产规模历史。 | 1 |
| 基金与 ETF 工具集
fund_data | get_fund_managers | 基金经理 | 按基金标识查询基金经理；operation 选择当前记录、任职历史、履历或教育经历。 | 1 |
| 基金与 ETF 工具集
fund_data | get_fund_distributions | 基金分红与收益分配 | 按基金标识和必填起止日期查询分红及收益分配历史。 | 1 |
| 基金与 ETF 工具集
fund_data | get_fund_terms | 基金费率与申购条件 | 按基金标识查询费率、投资者限制或申购信息；使用 kind 选择内容。 | 1 |
| 基金与 ETF 工具集
fund_data | get_fund_nav | 基金净值 | 按基金标识查询最新单位净值；operation=history 时按起止日期查询历史净值。 | 1 |
| 基金与 ETF 工具集
fund_data | get_fund_performance | 基金业绩表现 | 按基金标识查询数据库区间业绩；operation=custom 时按起止日期计算收益。 | 1 |
| 基金与 ETF 工具集
fund_data | compare_funds | 基金资料对比 | 使用 fund_ids 和 fund_class_ids 比较 2 至 10 个基金或份额类别的基本资料。 | 1 |
| 基金与 ETF 工具集
fund_data | get_fund_risk | 基金风险与评级 | 按基金标识查询风险指标、基金评级或债券组合统计；使用 operation 选择内容。 | 1 |
| 基金与 ETF 工具集
fund_data | rank_funds | 基金排行 | 按受控业绩或分类排名字段对基金份额类别排行，可按分类、管理人、币种或销售市场过滤。 | 1 |
| 基金与 ETF 工具集
fund_data | screen_funds | 基金筛选 | 按分类、管理人、币种、销售市场、收益率和费率筛选基金份额类别。 | 1 |
| 基金与 ETF 工具集
fund_data | get_fund_holdings | 基金持仓 | 按基金标识查询最新完整持仓、前十大持仓或指定日期范围的历史持仓。 | 1 |
| 基金与 ETF 工具集
fund_data | get_fund_exposure | 基金资产配置 | 按基金标识查询最新资产、行业或国家地区配置；使用 operation 选择口径。 | 1 |
| 基金与 ETF 工具集
fund_data | get_fund_benchmark | 基金业绩基准 | 按基金标识查询关联的业绩比较基准。 | 1 |
| 基金与 ETF 工具集
fund_data | get_fund_sales_markets | 基金销售市场 | 按基金标识查询份额类别获准销售的国家或市场。 | 1 |
| 基金与 ETF 工具集
fund_data | get_country_code | 国家地区代码解析 | 将中文或英文国家地区名称、ISO2、ISO3 或常用别名解析为规范国家代码。 | 1 |
| 互联互通工具集
stock_connect | get_stock_connect_data | 沪深港通综合数据 | 查询沪深港通综合数据。 | 20 |
| 互联互通工具集
stock_connect | get_hk_stock_connect_data | 港股通数据 | 查询港股通/北向相关数据。 | 12 |
| 互联互通工具集
stock_connect | get_cn_stock_connect_data | 沪深股通数据 | 查询 A 股沪深股通/南向相关数据。 | 8 |
| 新股 IPO 工具集
ipo | get_hk_ipo_calendar | 港股新股日历 | 查询港股 IPO 日历。 | 2 |
| 新股 IPO 工具集
ipo | get_hk_ipo_list | 港股新股列表 | 查询港股新股列表、今日打新、待上市、已上市、递表数据。 | 6 |
| 新股 IPO 工具集
ipo | get_hk_ipo_detail | 港股招股详情与配售结果 | 查询港股 IPO 招股详情和配售结果。 | 5 |
| 新股 IPO 工具集
ipo | get_ipo_profile | 港股新股综合资料 | 查询港股 IPO 个股资料，合并招股详情和公司概况。 | 2 |
| 新股 IPO 工具集
ipo | get_hk_ipo_company_profile | 港股新股公司概况 | 查询港股 IPO 公司概况。 | 2 |
| 新股 IPO 工具集
ipo | get_hk_ipo_underwriter | 港股新股承销商与保荐人 | 查询港股 IPO 承销商和保荐人。 | 2 |
| 新股 IPO 工具集
ipo | get_hk_ipo_cornerstone_investor | 港股新股基石投资者 | 查询港股 IPO 基石投资者。 | 1 |
| 新股 IPO 工具集
ipo | get_hk_ipo_margin_info | 港股新股认购与孖展 | 查询港股 IPO 认购倍数、认购金额和保证金信息。 | 4 |
| 新股 IPO 工具集
ipo | get_hk_ipo_rankings | 港股新股排行 | 查询港股 IPO 热门认购、首日回报、保荐人、承销商、基石投资者等排行榜。 | 5 |
| 新股 IPO 工具集
ipo | get_hk_ipo_notice | 港股招股与递表公告 | 查询或下载港股 IPO 招股书公告、递表公告；仅限港股 IPO 场景，不是已上市公司公告搜索。 | 2 |
| 新股 IPO 工具集
ipo | get_us_ipo_list | 美股新股列表 | 查询美股新股待上市、已上市、新股走势和 PE TTM 列表。 | 4 |
| 新股 IPO 工具集
ipo | get_us_ipo_detail | 美股新股详情 | 查询美股 IPO 新股详情。 | 1 |
| 新股 IPO 工具集
ipo | get_us_ipo_underwriter | 美股新股承销商 | 查询美股 IPO 承销商表现和承销商详情。 | 2 |
| 新股 IPO 工具集
ipo | get_hk_ipo_subscription_tools | 港股打新辅助工具 | 查询港股 IPO 打新计算、认购数量、券商、认购方式和中签手数等辅助数据。 | 8 |
| 新股 IPO 工具集
ipo | get_hk_ipo_market_data | 港股新股市场统计 | 查询港股 IPO 市场概况、行业统计和行业表现。 | 4 |
| 新股 IPO 工具集
ipo | get_us_ipo_market_data | 美股新股市场统计 | 查询美股 IPO 市场概况和行业表现。 | 2 |
| 新股 IPO 工具集
ipo | search_ipo_content | 新股内容搜索 | 搜索新股资讯或内容。 | 2 |
| 新股 IPO 工具集
ipo | get_ipo_news | 新股资讯 | 查询新股资讯列表、详情、热门、排行、推荐和相关资讯；仅限 IPO/新股内容，不是已上市公司通用新闻。 | 9 |
| 新股 IPO 工具集
ipo | get_ipo_topic | 新股专题 | 查询新股专题列表、置顶专题、专题详情和专题关联资讯。 | 4 |
| 新股 IPO 工具集
ipo | get_ipo_course | 打新课堂 | 查询打新课堂课程列表、热门、排行、推荐、相关课程和课程详情。 | 8 |
| 新股 IPO 工具集
ipo | get_ipo_tags | 新股内容标签 | 查询新股内容标签和有数据标签。 | 2 |
| 债券基础工具集
bond_basic | search_bond | 债券搜索 | 搜索债券。 | 1 |
| 债券基础工具集
bond_basic | get_bond_profile | 债券基础资料 | 查询债券资料、债券码表、机构债券池。 | 3 |
| 债券基础工具集
bond_basic | get_bond_quote | 债券行情与收益率快照 | 查询债券快照、扩展行情和收益率快照。 | 3 |
| 债券基础工具集
bond_basic | get_bond_orderbook | 债券买卖盘 | 查询债券买卖盘。 | 1 |
| 债券分析工具集
bond_analytics | get_bond_rankings | 债券排行 | 查询债券排行榜、简易排行榜、债券 ETF 排行榜。 | 3 |
| 债券分析工具集
bond_analytics | get_bond_chart | 债券与收益率走势 | 查询债券历史走势图、分时图、收益率 K 线、收益率分时和国债收益率列表。 | 5 |
| 债券分析工具集
bond_analytics | get_bond_yield | 债券收益率数据 | 查询债券收益率码表、收益率快照、收益率 K 线和收益率分时。 | 4 |
| 债券分析工具集
bond_analytics | get_bond_trading_status | 债券市场交易状态 | 查询债券市场和债券收益率市场交易状态。 | 2 |
| FIU 新闻资讯工具集
fiu_news | news_search | 新闻搜索 | 搜索新闻列表。 | 1 |
| FIU 新闻资讯工具集
fiu_news | news_by_symbol | 个股相关新闻 | 按证券代码查询相关新闻；默认按相关性排序，也可按发布时间排序或仅返回主体相关内容。 | 1 |
| FIU 新闻资讯工具集
fiu_news | news_latest | 最新新闻 | 查询最近一段时间内的最新新闻，按创建时间倒序。 | 1 |
| FIU 新闻资讯工具集
fiu_news | news_get | 新闻详情 | 按新闻 ID 查询单篇新闻详情。 | 1 |
| FIU 新闻资讯工具集
fiu_news | news_related | 相关新闻 | 按新闻 ID 查询相关新闻。 | 1 |
| FIU 新闻资讯工具集
fiu_news | news_digest | 新闻摘要素材 | 查询适合 AI 摘要的新闻素材，返回 content_preview 而不是完整正文。 | 1 |
| 财经日历工具集
financial_calendar | search_financial_calendar | 财经日历搜索 | 按标题关键词模糊搜索财经日历，并可按日期、国家、市场、事件类型和重要等级筛选。 | 1 |
| 财经日历工具集
financial_calendar | get_financial_event_detail | 财经事件详情 | 按财经日历事件 ID 查询单条事件详情。 | 1 |
| 宏观经济工具集
macro_economics | get_macro_overview | 宏观经济数据 | 精选宏观数据。 | 1 |
| 上市公司公告工具集
company_announcements | get_company_announcements | 上市公司公告与附件 | 按市场查询上市公司公告，并在每条公告中合并附件地址或正文。 | 6 |
| 参考数据工具集
reference | get_reference_data | 证券参考数据 | 查询 ISIN、SEDOL、CIK、ADR、货币、交易码表、基础码表、权证关联表、债券码表等参考数据；不提供公告、资讯、研报或披露全文搜索。 | 19 |
| 参考数据工具集
reference | get_trading_status | 证券与交易状态 | 查询交易日期、交易时段、除权事件、证券状态、退市列表等状态类数据。 | 19 |
| 参考数据工具集
reference | get_symbol_mapping | 证券代码映射 | 查询证券代码名称映射、指数映射。 | 3 |
| 参考数据工具集
reference | get_market_hours | 市场交易时段 | 查询当前交易时段状态；是 get_trading_status(session) 的别名，不是完整交易日程。 | 6 |
## 5. 端点入参明细
每个端点包括参数位置、字段表、请求示例与补充说明。表中的字段名均相对于该端点注明的业务参数位置；外层 `arguments.endpoint` 固定为端点名称。
| 工具集 | 端点数量 | 入参说明 |
| ------------------------------------------------ | -------- | ------------------------------------------------ |
| 现货行情工具集`quote_spot` | 4 | [查看本工具集](#toolset-quote_spot) |
| 盘中行情工具集`quote_intraday` | 6 | [查看本工具集](#toolset-quote_intraday) |
| K 线工具集`quote_kline` | 3 | [查看本工具集](#toolset-quote_kline) |
| 港股衍生品行情工具集`quote_derivatives_hk` | 3 | [查看本工具集](#toolset-quote_derivatives_hk) |
| 美股期权工具集`quote_us_options` | 4 | [查看本工具集](#toolset-quote_us_options) |
| 市场概况工具集`market_overview` | 1 | [查看本工具集](#toolset-market_overview) |
| 市场排行工具集`market_ranking` | 4 | [查看本工具集](#toolset-market_ranking) |
| 资金流工具集`market_flow` | 1 | [查看本工具集](#toolset-market_flow) |
| 行业与指数工具集`market_structure` | 3 | [查看本工具集](#toolset-market_structure) |
| 筹码成本工具集`market_position_cost` | 1 | [查看本工具集](#toolset-market_position_cost) |
| 公司资料工具集`f10_profile` | 3 | [查看本工具集](#toolset-f10_profile) |
| 财务报表工具集`f10_financials` | 2 | [查看本工具集](#toolset-f10_financials) |
| 公司经营治理工具集`f10_business_governance` | 2 | [查看本工具集](#toolset-f10_business_governance) |
| 股东结构工具集`shareholding_structure` | 2 | [查看本工具集](#toolset-shareholding_structure) |
| 机构持股工具集`shareholding_institution` | 1 | [查看本工具集](#toolset-shareholding_institution) |
| 券商持股与沽空工具集`shareholding_fund_broker` | 2 | [查看本工具集](#toolset-shareholding_fund_broker) |
| 基金与 ETF 工具集`fund_data` | 16 | [查看本工具集](#toolset-fund_data) |
| 互联互通工具集`stock_connect` | 3 | [查看本工具集](#toolset-stock_connect) |
| 新股 IPO 工具集`ipo` | 21 | [查看本工具集](#toolset-ipo) |
| 债券基础工具集`bond_basic` | 4 | [查看本工具集](#toolset-bond_basic) |
| 债券分析工具集`bond_analytics` | 4 | [查看本工具集](#toolset-bond_analytics) |
| FIU 新闻资讯工具集`fiu_news` | 6 | [查看本工具集](#toolset-fiu_news) |
| 财经日历工具集`financial_calendar` | 2 | [查看本工具集](#toolset-financial_calendar) |
| 宏观经济工具集`macro_economics` | 1 | [查看本工具集](#toolset-macro_economics) |
| 上市公司公告工具集`company_announcements` | 1 | [查看本工具集](#toolset-company_announcements) |
| 参考数据工具集`reference` | 4 | [查看本工具集](#toolset-reference) |
### 5.1 现货行情工具集 `quote_spot`
证券搜索、证券资料、股票和债券行情；基金使用 fund_data，全球债券搜索使用 bond_basic.search_bond，ETF、指数、窝轮使用各自的搜索或资料接口。
[search_security](#endpoint-search_security) · [get_security_profile](#endpoint-get_security_profile) · [get_quote](#endpoint-get_quote) · [get_security_definition](#endpoint-get_security_definition)
#### 5.1.1 `search_security` 证券搜索
按指定市场搜索股票、ETF、指数、窝轮或本地市场债券；基金使用 fund_data，美国及全球债券使用 bond_basic.search_bond。
调用工具集：`quote_spot`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：search_security | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP"；"ALL" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）、JP（日股）、ALL（跨市场搜索）。 |
| `assetType` | `string` | 否 | "all" | 枚举："all"；"stock"；"etf"；"index"；"warrant"；"bond" | 资产类型，默认 all。 基金查询请使用 fund_data 工具集。 |
| `keyword` | `string` | 条件必填 | 未声明 | 未声明 | 可选关键词。 JP 会在列表结果上做本地过滤；HK index 使用指数列表后本地过滤。 market=ALL 时必填。 必填条件：market="ALL"。 |
| `date` | `string` | 否 | 未声明 | 未声明 | HK index 的查询日期，格式 YYYY-MM-DD；省略时使用今天。 |
| `indexSeries` | `string` | 否 | 未声明 | 枚举："C"；"H"；"S"；"T" | HK index 可选系列：C=中证、H=恒生、S=标普、T=总回报；省略时合并全部四个系列。 代码示例：000065、CES120。 |
| `limit` | `number` | 否 | 20 | 最小值：1；最大值：100 | 返回数量，默认 20，最大 100。 |
| `marketBoard` | `string` | 否 | 未声明 | 枚举："Q"；"G"；"S"；"N"；"A"；"P"；"Z"；"V" | 美股交易所筛选，仅 market=US 或 ALL 时有效。 Q=Nasdaq全球精选市场，G=Nasdaq全球市场，S=Nasdaq资本市场，N=NYSE纽约交易所，A=NYSE MKT/AMEX，P=NYSE Arca，Z=BATS，V=IEX。 |
请求示例与补充说明
```json
{
"name": "quote_spot",
"arguments": {
"endpoint": "search_security",
"params": {
"market": "HK"
}
}
}
```
补充说明：
- market 必须明确指定 HK、US、CN、JP 或 ALL。 assetType 默认 all；market=ALL 时必须提供 keyword，并合并各市场的匹配结果，先合并候选再应用最终 limit，结果按稳定规则排序并尽量保留各有匹配市场的一条。 基金查询使用 fund_data；美国及全球债券搜索使用 bond_basic.search_bond；HK index 默认合并 C/H/S/T 四个系列，date 省略时使用今天；HK index 可使用 000065、CES120，HSI 是常见名称但不是该资料接口可直接匹配的代码。
- HK index 的 date 可省略，默认今天；未指定 indexSeries 时合并 C/H/S/T 四个系列。 可用代码示例：000065（可配 indexSeries=C）、CES120；HSI 是常见名称，不是该资料接口可直接匹配的代码。
- JP keyword 会在列表结果上做本地过滤；Sony、Hang Seng 等关键词可能命中名称字段。
- market 必须传入；market=ALL 时必须同时提供 keyword。 各市场候选先合并后再应用最终 limit，结果按匹配程度及证券代码稳定排序，并尽量保留有匹配结果的市场。 基金查询使用 fund_data；HK index 使用指数列表，示例代码为 000065、CES120，HSI 不直接作为该资料接口代码；US 支持 stock/warrant，JP 支持 stock/etf 且 keyword 会在列表结果上做本地过滤；marketBoard 可筛选美股交易所。 limit 默认 20。
- 基金查询统一使用 fund_data；美国或全球债券搜索统一使用 bond_basic.search_bond。
- 如果已知 symbol，不需要先调用 search_security，可直接调用对应查询工具。
- 常用场景：按市场和资产类型查询证券代码；keyword 不保证支持名称、拼音、ISIN、SEDOL 或 CIK 的通用匹配。
- 美国或全球债券关键词搜索使用 bond_basic.search_bond。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，assetType="bond"`
- `market="CN"，assetType="bond"`
- `market="HK"，assetType="index"`
- `market="HK"`
- `market="US"，assetType="warrant"`
- `market="US"`
- `market="CN"`
- `market="JP"`
[返回本工具集](#toolset-quote_spot) · [返回入参目录](#parameters)
#### 5.1.2 `get_security_profile` 证券基础资料
查询股票、ETF、指数、权证或债券的静态基础资料；基金请使用 fund_data 工具集。
调用工具集：`quote_spot`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_security_profile | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP"；"GLOBAL" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）、JP（日股）、GLOBAL（债券）。 |
| `assetType` | `string` | 否 | "stock" | 枚举："stock"；"etf"；"index"；"bond" | 资产类型，默认 stock。 |
| `symbols` | `string[]` | 是 | 未声明 | 最少项数：1；最多项数：50 | 证券代码列表，最多 50 个。 |
| `date` | `string` | 否 | 未声明 | 未声明 | HK index 的查询日期，格式 YYYY-MM-DD；省略时使用今天。 |
| `indexSeries` | `string` | 否 | 未声明 | 枚举："C"；"H"；"S"；"T" | HK index 可选系列：C=中证、H=恒生、S=标普、T=总回报；省略时自动查询全部系列。 代码示例：000065、CES120。 |
请求示例与补充说明
```json
{
"name": "quote_spot",
"arguments": {
"endpoint": "get_security_profile",
"params": {
"market": "HK",
"symbols": [
"00700.hk"
]
}
}
}
```
补充说明：
- 用于静态证券资料，不返回财务报表或公司基本面；后者使用 f10_core。 债券使用 market=GLOBAL。
- GLOBAL 当前主要用于 bond。
- HK index 的 date 可省略，默认今天；未指定 indexSeries 时查询 C/H/S/T 四个系列并按 symbols 过滤。 可用代码示例：000065（C 系列）、CES120；HSI 是常见名称，不是该资料接口可直接匹配的代码。
- JP 资料查询需要逗号分隔的 symbols，自动转换。
- 债券使用 market=GLOBAL。
- 债券能力：market=GLOBAL。
- 债券资料使用 ISIN 或债券 symbol。
- 静态资料不包含财务报表或公司基本面；后者使用 f10_core。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `assetType="bond"`
- `market="HK"，assetType="index"`
- `market="HK"`
- `market="US"`
- `market="CN"`
- `market="JP"`
[返回本工具集](#toolset-quote_spot) · [返回入参目录](#parameters)
#### 5.1.3 `get_quote` 证券行情
查询股票和债券的实时/快照行情；ETF、指数和港股窝轮使用对应专用接口。
调用工具集：`quote_spot`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_quote | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP"；"GLOBAL" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）、JP（日股）、GLOBAL（债券）。 |
| `assetType` | `string` | 否 | "stock" | 枚举："stock"；"bond" | 资产类型。 当前实际组合仅支持 stock 和 bond；etf/index/warrant 请使用对应专用接口。 |
| `symbols` | `string[]` | 条件必填 | 未声明 | 最少项数：1；最多项数：20 | 证券代码列表，例如 ["00700.hk"]、["AAPL.us"]、["000100.sz"]、["6758.jp"]、["US91282CHZ77"]。 必填条件：market="HK"，assetType="stock"，quoteType="basic"；或 market="HK"，assetType="stock"，quoteType="extended"；或 market="US"，assetType="stock"，quoteType="basic"；或 market="US"，assetType="stock"，quoteType="extended"；或 market="CN"，assetType="stock"，quoteType="basic"；或 market="CN"，assetType="stock"，quoteType="extended"；或 market="JP"，assetType="stock"，quoteType="basic"；或 market="JP"，assetType="stock"，quoteType="extended"。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 若同时传 symbols 和 symbol，优先使用 symbols。 |
| `quoteType` | `string` | 否 | "basic" | 枚举："basic"；"extended" | 行情类型：basic=基础快照，extended=扩展行情。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式：0=实时，1=延时。 默认 0。 |
| `fields` | `string[]` | 否 | 未声明 | 枚举："snapshot"；"order"；"trade" | 仅 US stock basic：行情字段，snapshot=快照数据，order=挂单数据，trade=逐笔数据；不传时默认传递 [snapshot, order, trade]。 |
| `sessionId` | `integer` | 否 | 未声明 | 枚举：-1；1；-2 | 仅 US stock basic：请求值 -1=盘前，1=盘中，-2=盘后；返回字段还可能出现 3=数据修正。 不传时不向发送，由按当前时段处理。 |
请求示例与补充说明
```json
{
"name": "quote_spot",
"arguments": {
"endpoint": "get_quote",
"params": {
"market": "HK",
"assetType": "stock",
"quoteType": "basic",
"symbols": [
"00700.hk"
]
}
}
}
```
补充说明：
- market 必须显式提供。 assetType 默认 stock，quoteType 默认 basic。 证券代码应带 .hk/.us/.sh/.sz/.jp 后缀。 美股期权使用 quote_us_options；债券使用 market=GLOBAL。
- CN 中明确属于指数的 .sh/.sz 代码不能按 assetType=stock 查询；请改用 market_structure.get_index_data。
- CN 中明确属于指数的代码不能按 stock 查询；请使用 market_structure.get_index_data。 US extended 可能不返回 name，债券 timestamp 可能是 epoch 毫秒字符串。
- ETF、index、warrant 当前没有 get_quote 组合。
- GLOBAL 当前用于 bond。
- US extended 可能不返回 name；JP 午间休市可能保留 lastPrice=0；
- market 必须显式提供；assetType 默认 stock，quoteType 默认 basic。 证券代码应带 .hk/.us/.sh/.sz/.jp 后缀，重复或等价代码会在规范化后去重。
- quoteType=basic 返回基础快照；HK、US、CN stock 的估值扩展字段使用 quoteType=extended。
- 债券能力：market=GLOBAL。
- 常用场景：最新价、涨跌幅、成交量、成交额、批量行情、基础快照。
- HK/US/CN 股票基础行情保留分组对象，并提供字段说明；CN 顶层证券标识为 symbol/name。US 的 snapshot/trade 等分组保留来源结构。具体布局按市场和 quoteType 读取，不能把所有行情都当作紧凑表。
- 债券 epoch 秒/毫秒时间戳按 UTC+08:00 转换；重复或等价证券代码归一化后去重。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `assetType="bond"，quoteType="basic"`
- `market="HK"，assetType="stock"，quoteType="basic"`
- `market="HK"，assetType="stock"，quoteType="extended"`
- `market="US"，assetType="stock"，quoteType="basic"`
- `market="US"，assetType="stock"，quoteType="extended"`
- `market="CN"，assetType="stock"，quoteType="basic"`
- `market="CN"，assetType="stock"，quoteType="extended"`
- `market="JP"，assetType="stock"，quoteType="basic"`
- `market="JP"，assetType="stock"，quoteType="extended"`
[返回本工具集](#toolset-quote_spot) · [返回入参目录](#parameters)
#### 5.1.4 `get_security_definition` 证券定义与码表
查询证券码表详情、新股参考列表等证券定义类数据。
调用工具集：`quote_spot`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_security_definition | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 证券代码。 单证券码表详情可传；列表类接口可省略。 必填条件：market="US"，definitionType="stock_define"。 |
| `symbols` | `string[]` | 条件必填 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； 必填条件：market="HK"，definitionType="stock_define"；或 market="CN"，definitionType="stock_define"。 |
| `definitionType` | `string` | 是 | 未声明 | 枚举："stock_define"；"double_counter"；"new_stocks" | definitionType 取值：stock_define=股票码表详情，double_counter=港股双柜台股票列表，new_stocks=A股新股列表。 适用范围：double_counter 仅适用于 market=HK；new_stocks 仅适用于 market=CN。 |
| `date` | `string` | 条件必填 | 未声明 | 未声明 | 查询日期/时间。 默认日期格式为 YYYY-MM-DD；K线分钟级、逐笔、分时等需要精确时刻的场景使用 YYYY-MM-DD HH:mm:ss。 必填条件：market="HK"，definitionType="double_counter"。 |
请求示例与补充说明
```json
{
"name": "quote_spot",
"arguments": {
"endpoint": "get_security_definition",
"params": {
"market": "HK",
"definitionType": "stock_define",
"symbols": [
"00700.hk"
]
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 definitionType 用于选择查询类型。 固定必填参数：market、definitionType。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，definitionType="stock_define"`
- `market="HK"，definitionType="double_counter"`
- `market="US"，definitionType="stock_define"`
- `market="CN"，definitionType="stock_define"`
- `market="CN"，definitionType="new_stocks"`
[返回本工具集](#toolset-quote_spot) · [返回入参目录](#parameters)
### 5.2 盘中行情工具集 `quote_intraday`
买卖盘、逐笔成交、分时走势；其中 get_mini_trend 仅支持 JP，其他 endpoint 按各自参数说明支持对应市场。
[get_orderbook](#endpoint-get_orderbook) · [get_trades](#endpoint-get_trades) · [get_intraday_trend](#endpoint-get_intraday_trend) · [get_trade_history](#endpoint-get_trade_history) · [get_trade_statistics](#endpoint-get_trade_statistics) · [get_mini_trend](#endpoint-get_mini_trend)
#### 5.2.1 `get_orderbook` 实时买卖盘
查询股票、ETF、指数和债券的买卖盘/盘口。
调用工具集：`quote_intraday`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_orderbook | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP"；"GLOBAL" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）、JP（日股）、GLOBAL（债券）。 |
| `assetType` | `string` | 否 | "stock" | 枚举："stock"；"etf"；"index"；"bond" | 资产类型，默认 stock。 HK 支持 stock/etf/index/bond；其他市场按接口能力选择。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 证券代码，例如 00700.hk、AAPL.us、600519.sh、6758.jp。 |
请求示例与补充说明
```json
{
"name": "quote_intraday",
"arguments": {
"endpoint": "get_orderbook",
"params": {
"market": "HK",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- GLOBAL 当前主要用于 bond。
- HK orderbook 支持买卖十档。
- JP orderbook 只有买卖一档。
- 债券能力：market=GLOBAL。
- 常用场景：买一卖一、五档/十档盘口、bid/ask、债券买卖报价。
- 逐笔成交请使用 get_trades。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `assetType="bond"`
- `market="HK"`
- `market="US"`
- `market="CN"`
- `market="JP"`
[返回本工具集](#toolset-quote_intraday) · [返回入参目录](#parameters)
#### 5.2.2 `get_trades` 逐笔成交
查询股票、ETF、指数的逐笔成交和历史逐笔。
调用工具集：`quote_intraday`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_trades | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）、JP（日股）。 |
| `assetType` | `string` | 否 | "stock" | 枚举："stock"；"etf"；"index" | 资产类型，默认 stock；bond 不支持。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 证券代码，例如 00700.hk、AAPL.us、600519.sh、6758.jp。 |
| `time` | `string` | 条件必填 | 未声明 | 未声明 | 查询时间，格式 YYYY-MM-DD HH:mm:ss，例如 2026-07-28 09:30:00；market=JP 时必填。 必填条件：market="JP"。 |
| `startTime` | `string` | 否 | 未声明 | 未声明 | 开始时间，格式 YYYY-MM-DD HH:mm:ss，例如 2026-07-28 09:30:00。 |
| `endTime` | `string` | 否 | 未声明 | 未声明 | 结束时间，格式 YYYY-MM-DD HH:mm:ss，例如 2026-07-28 16:00:00。 |
| `pageNum` | `number` | 否 | 1 | 最小值：1；最大值：100000 | 页码，从 1 开始，默认 1。 |
| `pageSize` | `number` | 否 | 20 | 最小值：1；最大值：200 | 单页数量，默认 20，最大 200。 |
| `orderMode` | `number` | 否 | 0 | 枚举：0；1 | 逐笔成交排序/翻页方向：0=查询指定时间之前的数据，1=查询指定时间之后的数据。 默认 0。 |
| `tickerId` | `number` | 否 | 未声明 | 未声明 | 逐笔游标 ID，部分市场需要。 |
| `sessionId` | `number` | 否 | 1 | 枚举：-1；1；-2 | 美股交易时段：-1=盘前，1=盘中，-2=盘后。 默认 1。 |
请求示例与补充说明
```json
{
"name": "quote_intraday",
"arguments": {
"endpoint": "get_trades",
"params": {
"market": "HK",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- 不支持 GLOBAL 或 bond。 assetType 默认 stock，pageNum 默认 1，pageSize 默认 20，orderMode 默认 0；market=JP 时必须传入 time。
- JP trade page 返回分页数据，保留分页结构。
- US trade list 需要 sessionId/tickerId/time，提供默认值。
- bond 不支持 get_trades。
- 不支持 GLOBAL 或 bond。
- 常用场景：最新逐笔、分时成交明细、历史逐笔、按时间翻页查询。
- 默认值：assetType=stock，pageNum=1，pageSize=20，orderMode=0；JP 逐笔查询必须提供 time。
- 当前公开参数表未声明 timeMode；JP 实现有透传能力，但不作为所有市场的公开承诺。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"`
- `market="US"`
- `market="CN"`
- `market="JP"`
[返回本工具集](#toolset-quote_intraday) · [返回入参目录](#parameters)
#### 5.2.3 `get_intraday_trend` 分时走势
查询股票、ETF、指数和债券的盘中分时走势。
调用工具集：`quote_intraday`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_intraday_trend | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP"；"GLOBAL" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）、JP（日股）、GLOBAL（债券）。 |
| `assetType` | `string` | 否 | "stock" | 枚举："stock"；"etf"；"index"；"bond" | 资产类型，默认 stock。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 证券代码，例如 00700.hk、AAPL.us、600519.sh、6758.jp。 |
| `date` | `string` | 否 | 未声明 | 未声明 | 查询日期，格式 YYYY-MM-DD，例如 2026-07-28。 |
| `trendType` | `number` | 否 | 1 | 枚举：1；5 | 分时类型：1=一日分时，5=五日分时。 默认 1。 |
| `searchMode` | `number` | 否 | 0 | 枚举：0；1 | 查询模式：0=全量，1=增量/游标。 默认 0。 |
| `timeMode` | `number` | 否 | 0 | 枚举：0；1 | 时间模式：0=实时，1=延时。 默认 0。 |
| `sessionId` | `number` | 否 | 1 | 枚举：-1；1；-2 | 美股交易时段：-1=盘前，1=盘中，-2=盘后。 默认 1。 |
请求示例与补充说明
```json
{
"name": "quote_intraday",
"arguments": {
"endpoint": "get_intraday_trend",
"params": {
"market": "HK",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- assetType 默认 stock，trendType 默认 1，searchMode 默认 0，timeMode 默认 0。 历史日/周/月 K 线使用 get_kline；债券使用 market=GLOBAL。
- GLOBAL 当前主要用于 bond。
- trendType=1 表示一日分时，trendType=5 表示五日分时。
- 债券能力：market=GLOBAL。
- 历史日K/月K请使用 get_kline。
- 如果用户要历史日线/月线，请使用 get_kline。
- 常用场景：一日分时、五日分时、盘中走势、债券分时。
- 默认值：assetType=stock，trendType=1，searchMode=0，timeMode=0。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `assetType="bond"`
- `market="HK"`
- `market="US"`
- `market="CN"`
- `market="JP"`
[返回本工具集](#toolset-quote_intraday) · [返回入参目录](#parameters)
#### 5.2.4 `get_trade_history` 历史逐笔成交
查询证券逐笔成交历史数据。
调用工具集：`quote_intraday`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_trade_history | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US" | 市场代码：HK（港股）、US（美股）。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 证券代码，例如 00700.hk、AAPL.us、6758.jp。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `historyType` | `string` | 是 | 未声明 | 枚举："trade" | 历史数据类型：trade=逐笔成交历史。 |
| `startTime` | `string` | 条件必填 | 未声明 | 未声明 | 开始时间，格式 YYYY-MM-DD HH:mm:ss。 必填条件：market="HK"，historyType="trade"；或 market="US"，historyType="trade"。 |
| `endTime` | `string` | 条件必填 | 未声明 | 未声明 | 结束时间，格式 YYYY-MM-DD HH:mm:ss。 必填条件：market="HK"，historyType="trade"；或 market="US"，historyType="trade"。 |
| `pageNum` | `number` | 否 | 未声明 | 最小值：1；最大值：100000 | 页码，从 1 开始。 |
| `pageSize` | `number` | 否 | 20 | 最小值：1；最大值：200 | 单页数量。 |
请求示例与补充说明
```json
{
"name": "quote_intraday",
"arguments": {
"endpoint": "get_trade_history",
"params": {
"market": "HK",
"historyType": "trade",
"symbol": "00700.hk",
"startTime": "2026-10-09 00:00:00",
"endTime": "2026-10-09 00:00:00"
}
}
}
```
补充说明：
- historyType 用于选择查询类型。 固定必填参数：market、historyType、symbol。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，historyType="trade"`
- `market="US"，historyType="trade"`
[返回本工具集](#toolset-quote_intraday) · [返回入参目录](#parameters)
#### 5.2.5 `get_trade_statistics` 成交统计
查询成交统计总览和成交统计明细。
调用工具集：`quote_intraday`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_trade_statistics | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）、JP（日股）。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 证券代码，例如 6758.jp；JP 成交统计总览必填。 必填条件：market="HK"，statisticsType="overview"；或 market="HK"，statisticsType="detail"；或 market="US"，statisticsType="overview"；或 market="US"，statisticsType="detail"；或 market="CN"，statisticsType="overview"；或 market="CN"，statisticsType="detail"；或 market="JP"，statisticsType="overview"；或 market="JP"，statisticsType="detail"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `statisticsType` | `string` | 是 | 未声明 | 枚举："overview"；"detail" | statisticsType 取值：overview=成交统计总览，detail=成交统计明细。 |
| `type` | `number` | 否 | 4 | 枚举：0；1；2；3；4 | 成交方向：0=主买，1=主卖，2=中性盘，3=主买和主卖，4=全部。 默认 4。 |
| `date` | `string` | 条件必填 | 未声明 | 未声明 | 查询日期，格式 YYYY-MM-DD。 JP 成交统计总览省略时查询日本当地当天；非交易日可能无数据。 HK 明细可能返回之前交易日的数据，以记录 date 为准，日期不符时附告警。 必填条件：market="HK"，statisticsType="overview"；或 market="HK"，statisticsType="detail"；或 market="US"，statisticsType="overview"；或 market="US"，statisticsType="detail"；或 market="CN"，statisticsType="overview"；或 market="CN"，statisticsType="detail"。 |
| `sortField` | `string` | 条件必填 | 未声明 | 枚举："price"；"volume" | 明细排序字段，detail 必填：price=统计价位，volume=成交量。 必填条件：statisticsType="detail"。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 明细排序方式：0=升序，1=降序，默认 1。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | detail 页码，从 1 开始，最大 100000。 越界返回 PAGE_OUT_OF_RANGE；核验失败返回 PAGE_EMPTY_UNCONFIRMED。 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | detail 每页数量，默认 20，最大 200，建议 20～50。 返回完整页，超出响应预算时报 RESPONSE_TOO_LARGE；缩小页大小后从第一页重新分页。 |
| `sessionId` | `number` | 否 | 1 | 枚举：-1；1；-2 | 美股交易时段：-1=盘前，1=盘中，-2=盘后。 |
请求示例与补充说明
```json
{
"name": "quote_intraday",
"arguments": {
"endpoint": "get_trade_statistics",
"params": {
"market": "HK",
"statisticsType": "detail",
"symbol": "00700.hk",
"date": "2026-10-22",
"sortField": "volume",
"pageNum": 1,
"pageSize": 20
}
}
}
```
补充说明：
- statisticsType=detail 时 sortField 必填，仅 price/volume；pageNum 默认 1，范围 1～100000；pageSize 默认 20，范围 1～200；sortType=0/1 分别为升序/降序。
- US 明细支持 sessionId=-1/1/-2（盘前/盘中/盘后），默认 1。
- 按请求页码、页大小和实际记录重算导航；总数、页码或完整页记录数矛盾时返回 DOWNSTREAM_PAGINATION_INCONSISTENT。后续空页可用同条件首页核验：越界为 PAGE_OUT_OF_RANGE，核验失败或矛盾时为 PAGE_EMPTY_UNCONFIRMED，total/pages 为 null。
- 明细完整页采用 128,000 字符预算，超出时返回 RESPONSE_TOO_LARGE，可减小 pageSize。请求日期与记录日期不同时保留原始日期并给出 warnings。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，statisticsType="overview"`
- `market="HK"，statisticsType="detail"`
- `market="US"，statisticsType="overview"`
- `market="US"，statisticsType="detail"`
- `market="CN"，statisticsType="overview"`
- `market="CN"，statisticsType="detail"`
- `market="JP"，statisticsType="overview"`
- `market="JP"，statisticsType="detail"`
[返回本工具集](#toolset-quote_intraday) · [返回入参目录](#parameters)
#### 5.2.6 `get_mini_trend` 日股迷你分时图
查询日股迷你分时图。
调用工具集：`quote_intraday`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_mini_trend | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "JP" | 枚举："JP" | 市场代码，固定为 JP（日股）；可省略，默认 JP。 |
| `symbols` | `string[]` | 是 | 未声明 | 最少项数：1 | 日股证券代码列表，可批量查询，例如 ["6758.jp", "7203.jp"]。 |
| `timeMode` | `number` | 否 | 0 | 枚举：0；1 | 时间模式：0=实时，1=延时。 |
请求示例与补充说明
```json
{
"name": "quote_intraday",
"arguments": {
"endpoint": "get_mini_trend",
"params": {
"market": "JP",
"symbols": [
"6758.jp"
]
}
}
}
```
补充说明：
- 固定必填参数：symbols。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="JP"`
[返回本工具集](#toolset-quote_intraday) · [返回入参目录](#parameters)
### 5.3 K 线工具集 `quote_kline`
K 线、历史走势与收益率走势；get_jp_kline 仅支持 JP，get_kline 使用截止日期 date 和返回根数 limit。
[get_kline](#endpoint-get_kline) · [get_jp_kline](#endpoint-get_jp_kline) · [get_snapshot_history](#endpoint-get_snapshot_history)
#### 5.3.1 `get_kline` 历史K线
查询股票、指数、债券的历史K线/走势；使用截止日期 date 和返回根数 limit。
调用工具集：`quote_kline`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_kline | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP"；"GLOBAL" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）、JP（日股）、GLOBAL（债券）。 |
| `assetType` | `string` | 否 | 未声明 | 枚举："stock"；"index"；"bond" | 资产类型：stock=股票、index=指数、bond=债券。 HK/US/CN/JP 支持 stock/index，默认 stock；GLOBAL 仅支持 bond，默认 bond。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 证券代码，例如 00700.hk、AAPL.us、6758.jp、US91282CHZ77。 |
| `period` | `string` | 否 | "1d" | 枚举："1m"；"3m"；"5m"；"15m"；"30m"；"60m"；"120m"；"240m"；"1d"；"1w"；"1mo"；"1q"；"1y" | K 线周期：1m=1分钟、3m=3分钟、5m=5分钟、15m=15分钟、30m=30分钟、60m=60分钟、120m=120分钟、240m=240分钟、1d=日、1w=周、1mo=月、1q=季、1y=年。 默认 1d；适用资产见 assetType。 |
| `date` | `string` | 否 | 未声明 | 未声明 | 查询截止日期，所有周期均可使用 YYYY-MM-DD。 分钟 K 也可使用 YYYY-MM-DD HH:mm:ss；仅指定日期时截止到当天 23:59:59（自然日结束，非交易所收盘时刻）。 日/周/月/季/年 K 使用日期格式。 省略时截至当前时间，limit 指定向前返回的根数。 |
| `adjust` | `string` | 否 | 未声明 | 枚举："none"；"forward"；"backward" | 复权方式：none=不复权，forward=前复权，backward=后复权。 CN 日 K 默认 forward，其余默认 none；显式指定时使用指定值。 |
| `timeMode` | `number` | 否 | 0 | 枚举：0；1 | 时间模式：0=实时，1=延时。 默认 0。 |
| `limit` | `integer` | 否 | 100 | 最小值：1；最大值：500 | 请求条数上限，默认 100，范围 1～500；实际条数取决于下游。 meta.count 为实际返回条数。 |
请求示例与补充说明
```json
{
"name": "quote_kline",
"arguments": {
"endpoint": "get_kline",
"params": {
"market": "CN",
"symbol": "600519.sh",
"period": "1d",
"limit": 100
}
}
}
```
补充说明：
- 所有周期均接受 YYYY-MM-DD；分钟 K 也接受 YYYY-MM-DD HH:mm:ss。分钟 K 仅传日期时，截止到该自然日 23:59:59。省略 date 时截至当前时间。
- HK/US/CN/JP 默认 assetType=stock，支持 stock/index；GLOBAL 默认且仅支持 bond。CN 日 K 默认 adjust=forward，其余默认 none。
- limit 默认 100，范围 1～500，表示请求条数上限。meta.count 等于实际 rows.length；不自动补页，没有 pageNum/pageSize 公开参数。
- 返回 columns、columnNames、rows 紧凑表。完整响应预算为 128,000 字符，超出时返回 RESPONSE_TOO_LARGE；缩小 limit 后重试，不返回裁剪后的成功结果。
- 债券使用收益率 K 线，保留标准 OHLC 字段。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `assetType="bond"`
- `market="HK"，assetType="stock"`
- `market="HK"，assetType="index"`
- `market="US"，assetType="stock"`
- `market="US"，assetType="index"`
- `market="CN"，assetType="stock"`
- `market="CN"，assetType="index"`
- `market="JP"，assetType="stock"`
- `market="JP"，assetType="index"`
[返回本工具集](#toolset-quote_kline) · [返回入参目录](#parameters)
#### 5.3.2 `get_jp_kline` 日股K线
查询日股截至指定日期或时间的最近 K 线，支持单只与批量证券，默认每只返回 20 根。
调用工具集：`quote_kline`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_jp_kline | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "JP" | 枚举："JP" | 市场代码，固定为 JP（日股）；可省略，默认 JP。 |
| `date` | `string` | 否 | 未声明 | 未声明 | 查询日期/时间。 K线类型为日周月季年时，时间必须为格式为"yyyy-MM-dd"这种时间格式。 K线类型为分K级别时，时间必须为格式为"yyyy-MM-dd HH:mm:ss"这种时间格式 |
| `limit` | `integer` | 否 | 20 | 最小值：1；最大值：500 | 每只证券的请求条数上限，默认 20，范围 1～500；实际条数取决于，不保证达到 limit，不自动补页。 |
| `symbol` | `string` | 否 | 未声明 | 最短长度：1 | 日股证券代码，如 6758.jp；与 symbols 至少填写一个，同时填写时须包含在 symbols 中。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1 | 批量日股证券代码，至少一个，如 ["6758.jp","7203.jp"]；与 symbol 至少填写一个。 |
| `type` | `integer` | 否 | 0 | 枚举：0；1；2；3；4；5；6；7；8；9；10；11；12 | K线类型：0（日）、1（周）、2（月）、3（季）、4（年）、5（1分）、6（5分）、7（15分）、8（30分）、9（60分）、10（120分）、11（3分）、12（240分）。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式：0（实时）、1（延时），默认 0。 |
请求示例与补充说明
```json
{
"name": "quote_kline",
"arguments": {
"endpoint": "get_jp_kline",
"params": {
"market": "JP",
"symbols": [
"6758.jp",
"7203.jp"
],
"limit": 20
}
}
}
```
补充说明：
- 仅支持 JP。symbol 与 symbols 至少提供一项；批量证券按输入顺序返回。
- limit 默认每只 20 根，范围 1～500。meta.rowCounts 按 meta.symbols 顺序记录实际条数，合计等于 meta.count。
- 完整响应预算为 128,000 字符，超出时返回 RESPONSE_TOO_LARGE；减少 limit 或批量证券数量。没有 pageNum/pageSize 公开参数。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="JP"`
[返回本工具集](#toolset-quote_kline) · [返回入参目录](#parameters)
#### 5.3.3 `get_snapshot_history` 历史行情快照
查询证券历史快照数据。
调用工具集：`quote_kline`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_snapshot_history | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US" | 市场代码：HK（港股）、US（美股）。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 证券代码，例如 00700.hk、AAPL.us、6758.jp。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `historyType` | `string` | 是 | 未声明 | 枚举："snapshot" | 历史数据类型：snapshot=快照历史。 |
| `startTime` | `string` | 条件必填 | 未声明 | 未声明 | 开始时间，格式 YYYY-MM-DD HH:mm:ss。 必填条件：market="HK"，historyType="snapshot"；或 market="US"，historyType="snapshot"。 |
| `endTime` | `string` | 条件必填 | 未声明 | 未声明 | 结束时间，格式 YYYY-MM-DD HH:mm:ss。 必填条件：market="HK"，historyType="snapshot"；或 market="US"，historyType="snapshot"。 |
| `pageNum` | `number` | 否 | 未声明 | 最小值：1；最大值：100000 | 页码，从 1 开始。 |
| `pageSize` | `number` | 否 | 20 | 最小值：1；最大值：200 | 单页数量。 |
请求示例与补充说明
```json
{
"name": "quote_kline",
"arguments": {
"endpoint": "get_snapshot_history",
"params": {
"market": "HK",
"historyType": "snapshot",
"symbol": "00700.hk",
"startTime": "2026-10-09 00:00:00",
"endTime": "2026-10-09 00:00:00"
}
}
}
```
补充说明：
- historyType 用于选择查询类型。 固定必填参数：market、historyType、symbol。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，historyType="snapshot"`
- `market="US"，historyType="snapshot"`
[返回本工具集](#toolset-quote_kline) · [返回入参目录](#parameters)
### 5.4 港股衍生品行情工具集 `quote_derivatives_hk`
港股窝轮、牛熊证等扩展行情。
[get_quote_extend](#endpoint-get_quote_extend) · [get_hk_warrant_catalog](#endpoint-get_hk_warrant_catalog) · [get_hk_warrant_trading_data](#endpoint-get_hk_warrant_trading_data)
#### 5.4.1 `get_quote_extend` 港股衍生品扩展行情
查询港股窝轮、牛熊证等衍生品的扩展行情。
调用工具集：`quote_derivatives_hk`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_quote_extend | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `assetType` | `string` | 否 | "warrant" | 枚举："warrant" | 固定为 warrant；可省略，默认使用 warrant。 |
| `symbols` | `string[]` | 是 | 未声明 | 最少项数：1；最多项数：50 | 港股窝轮、牛熊证代码列表，最多 50 个。 |
| `timeMode` | `number` | 否 | 0 | 枚举：0；1 | 时间模式：0=实时，1=延时。 默认 0。 |
请求示例与补充说明
```json
{
"name": "quote_derivatives_hk",
"arguments": {
"endpoint": "get_quote_extend",
"params": {
"market": "HK",
"assetType": "warrant",
"symbols": [
"13002.hk"
]
}
}
}
```
补充说明：
- 仅用于港股窝轮和牛熊证；market 和 assetType 可省略，默认分别为 HK、warrant。 普通港股股票的市值、估值、换手率等扩展字段使用 quote_spot.get_quote，并设置 quoteType=extended。
- 普通港股股票扩展行情使用 quote_spot.get_quote + quoteType=extended。
- 本 endpoint 只属于 quote_derivatives_hk。
- 本 endpoint 只属于 quote_derivatives_hk；美股期权使用 quote_us_options。
- 当前实现中 timeMode=1 仍按 0 发送，尚不能据此声明该端点提供延时行情。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，assetType="warrant"`
[返回本工具集](#toolset-quote_derivatives_hk) · [返回入参目录](#parameters)
#### 5.4.2 `get_hk_warrant_catalog` 港股窝轮与牛熊证目录
查询港股权证/窝轮/牛熊证目录、发行商和简介。
调用工具集：`quote_derivatives_hk`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_warrant_catalog | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 正股代码（list_en）或权证代码（profile）；list_en/profile 时必填。 必填条件：market="HK"，warrantType="list_en"；或 warrantType="list_en"；或 warrantType="profile"。 |
| `symbols` | `string[]` | 条件必填 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； 必填条件：market="HK"，warrantType="profile"。 |
| `warrantType` | `string` | 是 | 未声明 | 枚举："issuer"；"list"；"list_en"；"profile" | warrantType 取值：issuer=发行商列表，list=权证列表，list_en=英文权证列表，profile=权证简介。 |
| `issuers` | `string[]` | 条件必填 | 未声明 | 枚举："BC"；"BI"；"BP"；"CI"；"CS"；"CT"；"DB"；"DC"；"DS"；"EA"；"GJ"；"GS"；"HS"；"HT"；"HU"；"JP"；"KC"；"KI"；"KS"；"MB"；"ML"；"MS"；"NM"；"RB"；"RS"；"SC"；"SG"；"UB"；"VT" | 发行商代码列表；list_en 必填，取值来自 warrantType=issuer 返回的发行商代码。 可选值：BC、BI、BP、CI、CS、CT、DB、DC、DS、EA、GJ、GS、HS、HT、HU、JP、KC、KI、KS、MB、ML、MS、NM、RB、RS、SC、SG、UB、VT。 必填条件：warrantType="list_en"。 |
| `types` | `string[]` | 条件必填 | 未声明 | 枚举："ALL"；"B"；"BE"；"BU"；"D"；"DC"；"DP" | 衍生品类型列表；list_en 必填。 ALL=窝轮牛熊，B=牛熊证，BE=熊证，BU=牛证，D=认股证，DC=认购权证，DP=认沽权证。 必填条件：warrantType="list_en"。 |
| `sortType` | `integer` | 条件必填 | 未声明 | 枚举：0；1 | 排序方式；list_en 必填：0=升序，1=降序。 必填条件：warrantType="list_en"。 |
| `sortField` | `string` | 条件必填 | 未声明 | 枚举："changeRate" | 排序字段；list_en 必填，当前支持 changeRate=涨跌幅。 必填条件：warrantType="list_en"。 |
| `moneyness` | `integer` | 条件必填 | 未声明 | 枚举：0；1 | 价内/价外；list_en 必填：0=价内，1=价外。 必填条件：warrantType="list_en"。 |
| `listingStartDate` | `string` | 条件必填 | 未声明 | 未声明 | 上市日开始，格式 YYYY-MM-DD；list_en 必填。 必填条件：warrantType="list_en"。 |
| `listingEndDate` | `string` | 条件必填 | 未声明 | 未声明 | 上市日结束，格式 YYYY-MM-DD；list_en 必填。 必填条件：warrantType="list_en"。 |
| `maturityStartDate` | `string` | 条件必填 | 未声明 | 未声明 | 到期日开始，格式 YYYY-MM-DD；list_en 必填。 必填条件：warrantType="list_en"。 |
| `maturityEndDate` | `string` | 条件必填 | 未声明 | 未声明 | 到期日结束，格式 YYYY-MM-DD；list_en 必填。 必填条件：warrantType="list_en"。 |
| `gearingRateLow` | `integer` | 条件必填 | 未声明 | 未声明 | 杠杆比率下限，integer 类型；list_en 必填。 必填条件：warrantType="list_en"。 |
| `gearingRateHigh` | `integer` | 条件必填 | 未声明 | 未声明 | 杠杆比率上限，integer 类型；list_en 必填。 必填条件：warrantType="list_en"。 |
| `outstandingRateLow` | `number` | 条件必填 | 未声明 | 未声明 | 街货比下限，number 类型；list_en 必填。 必填条件：warrantType="list_en"。 |
| `outstandingRateHigh` | `number` | 条件必填 | 未声明 | 未声明 | 街货比上限，number 类型；list_en 必填。 必填条件：warrantType="list_en"。 |
| `premiumLow` | `number` | 条件必填 | 未声明 | 未声明 | 溢价下限，number 类型；list_en 必填。 必填条件：warrantType="list_en"。 |
| `premiumHigh` | `number` | 条件必填 | 未声明 | 未声明 | 溢价上限，number 类型；list_en 必填。 必填条件：warrantType="list_en"。 |
| `status` | `string` | 否 | 未声明 | 枚举："N"；"W" | 权证状态：N=正常，W=待上市。 |
请求示例与补充说明
```json
{
"name": "quote_derivatives_hk",
"arguments": {
"endpoint": "get_hk_warrant_catalog",
"params": {
"market": "HK",
"warrantType": "issuer"
}
}
}
```
补充说明：
- list_en 组合将 issuers、types、symbol、sortType、sortField、moneyness、listingStartDate、listingEndDate、maturityStartDate、maturityEndDate、gearingRateLow、gearingRateHigh、outstandingRateLow、outstandingRateHigh、premiumLow、premiumHigh 全部定义为 required=true；由于本工具同时支持 issuer/list/profile，参数描述保留 warrantType=list_en 条件必填，选择 list_en 后以上字段必须全部传入。 list_en 当前数据当前可能返回空列表；即使参数完整，若返回 total=0/list=[]，优先改用 warrantType=list（全市场权证列表）。 warrantType 用于选择查询类型。 固定必填参数：warrantType。 按所选类型补充条件必填参数：symbol、issuers、types、sortType、sortField、moneyness、listingStartDate、listingEndDate、maturityStartDate、maturityEndDate、gearingRateLow、gearingRateHigh、outstandingRateLow、outstandingRateHigh、premiumLow、premiumHigh。 仅使用 parameters 中声明的业务字段。
- list_en 当前数据当前可能返回空列表；即使参数完整，若返回 total=0/list=[]，优先改用 warrantType=list（全市场权证列表）。
- list_en 组合将 issuers、types、symbol、sortType、sortField、moneyness、listingStartDate、listingEndDate、maturityStartDate、maturityEndDate、gearingRateLow、gearingRateHigh、outstandingRateLow、outstandingRateHigh、premiumLow、premiumHigh 全部定义为 required=true；由于本工具同时支持 issuer/list/profile，参数描述保留 warrantType=list_en 条件必填，选择 list_en 后以上字段必须全部传入。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，warrantType="issuer"`
- `market="HK"，warrantType="list"`
- `market="HK"，warrantType="list_en"`
- `market="HK"，warrantType="profile"`
[返回本工具集](#toolset-quote_derivatives_hk) · [返回入参目录](#parameters)
#### 5.4.3 `get_hk_warrant_trading_data` 港股窝轮与牛熊证交易数据
查询港股权证/窝轮/牛熊证成交统计、活跃榜和历史走势。
调用工具集：`quote_derivatives_hk`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_warrant_trading_data | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 权证、窝轮或牛熊证代码； |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `warrantTradeType` | `string` | 是 | 未声明 | 枚举："history"；"rank"；"statistics" | warrantTradeType 取值：history=成交统计历史走势，rank=成交活跃榜，statistics=成交统计。 |
| `type` | `string` | 条件必填 | 未声明 | 枚举："B"；"D" | 成交活跃榜类型；rank 组合必填：B=牛熊证，D=认股证。 必须传字符串 B 或 D，不设置默认值。 必填条件：warrantTradeType="rank"。 |
| `types` | `string[]` | 否 | 未声明 | 枚举："ALL"；"B"；"BE"；"BU"；"D"；"DC"；"DP" | 衍生品类型：ALL=全部，B=牛熊证，BE=熊证，BU=牛证，D=认股证，DC=认购权证，DP=认沽权证。 statistics 默认 ["ALL"]。 |
| `date` | `string` | 否 | 未声明 | 未声明 | 查询日期，格式 YYYY-MM-DD。 |
请求示例与补充说明
```json
{
"name": "quote_derivatives_hk",
"arguments": {
"endpoint": "get_hk_warrant_trading_data",
"params": {
"market": "HK",
"warrantTradeType": "history"
}
}
}
```
补充说明：
- warrantTradeType 用于选择查询类型。 固定必填参数：warrantTradeType。 按所选类型补充条件必填参数：type。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，warrantTradeType="history"`
- `market="HK"，warrantTradeType="rank"`
- `market="HK"，warrantTradeType="statistics"`
[返回本工具集](#toolset-quote_derivatives_hk) · [返回入参目录](#parameters)
### 5.5 美股期权工具集 `quote_us_options`
OPRA 期权链、报价、Greeks、成交、排行和概览。
[get_us_option_chain](#endpoint-get_us_option_chain) · [get_us_option_quote](#endpoint-get_us_option_quote) · [get_us_option_overview](#endpoint-get_us_option_overview) · [get_us_option_rankings](#endpoint-get_us_option_rankings)
#### 5.5.1 `get_us_option_chain` 美股期权链
查询美股期权到期日、期权链、合约列表、快照和 Greeks。
调用工具集：`quote_us_options`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_us_option_chain | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "US" | 枚举："US" | 市场代码，固定为 US（美股）；可省略，默认 US。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：market="US"，optionType="expiration"；或 market="US"，optionType="chain"；或 market="US"，optionType="symbols"；或 market="US"，optionType="snapshot"；或 market="US"，optionType="greeks"；或 market="US"，optionType="callput_volume"。 |
| `symbols` | `string[]` | 条件必填 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； 必填条件：market="US"，optionType="snapshot"。 |
| `optionType` | `string` | 是 | 未声明 | 枚举："expiration"；"chain"；"symbols"；"snapshot"；"greeks"；"callput_volume" | 期权数据类型：expiration、chain、symbols、snapshot、greeks、callput_volume。 |
| `root` | `string` | 是 | 未声明 | 未声明 | 期权标的物代码，不带 .us 后缀，例如 AAPL。 也可传 symbol=AAPL.us，归一为 root=AAPL。 |
| `expiration` | `string` | 条件必填 | 未声明 | 未声明 | 到期日，optionType=chain/symbols/snapshot/greeks 时必填，格式以期权到期日接口返回为准。 必填条件：optionType="chain"；或 optionType="symbols"；或 optionType="snapshot"；或 optionType="greeks"。 |
请求示例与补充说明
```json
{
"name": "quote_us_options",
"arguments": {
"endpoint": "get_us_option_chain",
"params": {
"market": "US",
"optionType": "expiration",
"root": "AAPL",
"symbol": "AAPL.us"
}
}
}
```
补充说明：
- optionType 用于选择查询类型。 固定必填参数：optionType、root。 按所选类型补充条件必填参数：expiration。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="US"，optionType="expiration"`
- `market="US"，optionType="chain"`
- `market="US"，optionType="symbols"`
- `market="US"，optionType="snapshot"`
- `market="US"，optionType="greeks"`
- `market="US"，optionType="callput_volume"`
[返回本工具集](#toolset-quote_us_options) · [返回入参目录](#parameters)
#### 5.5.2 `get_us_option_quote` 美股期权行情
查询美股期权合约快照、盘口、逐笔成交、K 线、分时、成交统计。
调用工具集：`quote_us_options`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_us_option_quote | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "US" | 枚举："US" | 市场代码，固定为 US（美股）；可省略，默认 US。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：market="US"，optionType="order"；或 market="US"，optionType="trade"；或 market="US"，optionType="kline"；或 market="US"，optionType="trend"；或 market="US"，optionType="statistics_overview"；或 market="US"，optionType="statistics_detail"；或 market="US"，optionType="status"；或 market="US"，optionType="batch_status"。 |
| `symbols` | `string[]` | 条件必填 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； 必填条件：market="US"，optionType="snapshot"；或 market="US"，optionType="batch_order"；或 market="US"，optionType="base_info"；或 market="US"，optionType="transaction_extended"。 |
| `optionType` | `string` | 是 | 未声明 | 枚举："snapshot"；"order"；"batch_order"；"trade"；"kline"；"trend"；"statistics_overview"；"statistics_detail"；"base_info"；"status"；"batch_status"；"transaction_extended" | 期权数据类型：snapshot=合约快照，order=盘口，trade=逐笔成交，kline=K线，trend=分时，transaction_extended=是否延长交易，batch_order，statistics_overview，statistics_detail，base_info，status，batch_status。 |
| `number` | `string` | 条件必填 | 未声明 | 未声明 | number 用于选择查询类型。 必填条件：market="US"，optionType="kline"。 |
| `type` | `string` | 条件必填 | 未声明 | 未声明 | type 用于选择查询类型。 必填条件：market="US"，optionType="kline"。 |
| `searchMode` | `string` | 条件必填 | 未声明 | 未声明 | searchMode 用于选择查询类型。 必填条件：market="US"，optionType="trend"。 |
| `trendType` | `string` | 条件必填 | 未声明 | 未声明 | trendType 用于选择查询类型。 必填条件：market="US"，optionType="trend"。 |
请求示例与补充说明
```json
{
"name": "quote_us_options",
"arguments": {
"endpoint": "get_us_option_quote",
"params": {
"market": "US",
"optionType": "snapshot",
"symbols": [
"AAPL.us"
]
}
}
}
```
补充说明：
- optionType 用于选择查询类型。 固定必填参数：optionType。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="US"，optionType="snapshot"`
- `market="US"，optionType="order"`
- `market="US"，optionType="batch_order"`
- `market="US"，optionType="trade"`
- `market="US"，optionType="kline"`
- `market="US"，optionType="trend"`
- `market="US"，optionType="statistics_overview"`
- `market="US"，optionType="statistics_detail"`
- `market="US"，optionType="base_info"`
- `market="US"，optionType="status"`
- `market="US"，optionType="batch_status"`
- `market="US"，optionType="transaction_extended"`
[返回本工具集](#toolset-quote_us_options) · [返回入参目录](#parameters)
#### 5.5.3 `get_us_option_overview` 美股期权市场概览
查询美股期权市场总览和 ETF 期权概览。
调用工具集：`quote_us_options`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_us_option_overview | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "US" | 枚举："US" | 市场代码，固定为 US（美股）；可省略，默认 US。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：market="US"，optionType="etf_latest"；或 market="US"，optionType="etf_line"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `optionType` | `string` | 是 | 未声明 | 枚举："latest"；"line"；"etf_latest"；"etf_line" | 期权数据类型：latest、line、etf_latest、etf_line。 |
请求示例与补充说明
```json
{
"name": "quote_us_options",
"arguments": {
"endpoint": "get_us_option_overview",
"params": {
"market": "US",
"optionType": "latest"
}
}
}
```
补充说明：
- optionType 用于选择查询类型。 固定必填参数：optionType。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="US"，optionType="latest"`
- `market="US"，optionType="line"`
- `market="US"，optionType="etf_latest"`
- `market="US"，optionType="etf_line"`
[返回本工具集](#toolset-quote_us_options) · [返回入参目录](#parameters)
#### 5.5.4 `get_us_option_rankings` 美股期权排行
查询美股期权排行榜。
调用工具集：`quote_us_options`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_us_option_rankings | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "US" | 枚举："US" | 市场代码，固定为 US（美股）；可省略，默认 US。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `rankType` | `string` | 是 | 未声明 | 枚举："list"；"statistics"；"top10" | 排行类型：list=排行榜列表，statistics=排行榜统计，top10=Top10 排行。 |
| `pageNum` | `number` | 否 | 未声明 | 最小值：1；最大值：100000 | 页码，默认 1。 |
| `pageSize` | `number` | 否 | 未声明 | 最小值：1；最大值：200 | 单页数量，默认 20。 |
| `sortField` | `string` | 否 | "changeRate" | 未声明 | 排序字段，默认 changeRate。 |
| `sortType` | `number` | 否 | 1 | 枚举：0；1 | 排序方式：0=升序，1=降序。 默认 1。 |
| `date` | `string` | 条件必填 | 未声明 | 未声明 | 查询日期，格式 YYYY-MM-DD；list/statistics 省略时按当前日期补齐。 必填条件：market="US"，rankType="list"；或 market="US"，rankType="statistics"。 |
| `roots` | `string` | 条件必填 | 未声明 | 未声明 | roots 用于选择查询类型。 必填条件：market="US"，rankType="top10"。 |
请求示例与补充说明
```json
{
"name": "quote_us_options",
"arguments": {
"endpoint": "get_us_option_rankings",
"params": {
"market": "US",
"rankType": "list",
"date": "2026-10-09"
}
}
}
```
补充说明：
- rankType 用于选择查询类型。 固定必填参数：rankType。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="US"，rankType="list"`
- `market="US"，rankType="statistics"`
- `market="US"，rankType="top10"`
[返回本工具集](#toolset-quote_us_options) · [返回入参目录](#parameters)
### 5.6 市场概况工具集 `market_overview`
市场统计与交易统计概览。
[get_market_statistics](#endpoint-get_market_statistics)
#### 5.6.1 `get_market_statistics` 市场涨跌统计
查询实时市场涨跌家数与涨跌幅分布；不支持按历史日期查询。
调用工具集：`market_overview`。业务参数位置：`arguments`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_market_statistics | 选择本端点。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）、JP（日股）。 |
请求示例与补充说明
```json
{
"name": "market_overview",
"arguments": {
"endpoint": "get_market_statistics",
"market": "HK"
}
}
```
补充说明：
- 仅需选择 market。 返回 columns、columnNames、rows 紧凑表，各列与中文释义按位置对应；marketName 说明每行的市场范围，time 为统计更新时间。 fall4-fall1 为下跌分档家数，fall 为下跌家数，flat 为平盘家数，rise 为上涨家数，rise1-rise4 为上涨分档家数；具体百分比区间见 columnNames。 全部市场与分板块分别展示，不能重复相加。
- 只查询当前市场统计，不支持历史日期；JP 入口不接受 timeMode。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"`
- `market="US"`
- `market="CN"`
- `market="JP"`
[返回本工具集](#toolset-market_overview) · [返回入参目录](#parameters)
### 5.7 市场排行工具集 `market_ranking`
市场排行工具集。各市场均需在 params 中指定 rankType（必填）：港股 get_hk_ranking → rankType: stock/industry/ipo/broker/market_premium；美股 get_us_ranking → rankType: stock/industry/ipo/etf；A股 get_cn_ranking → rankType: stock/industry/ipo；日股 get_jp_ranking → rankType: stock/hot_stock/industry。其余参数按 rankType 分支填写。
[get_hk_ranking](#endpoint-get_hk_ranking) · [get_us_ranking](#endpoint-get_us_ranking) · [get_cn_ranking](#endpoint-get_cn_ranking) · [get_jp_ranking](#endpoint-get_jp_ranking)
#### 5.7.1 `get_hk_ranking` 港股市场排行
查询港股证券、行业或概念、新股表现、经纪商持仓及A/H溢价排行。
调用工具集：`market_ranking`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ranking | 选择本端点。 |
| `arguments.params` | `object` | 是 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
##### 查询分支：`rankType=stock`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："stock" | 枚举含义：stock=证券排行。 |
| `marketBoard` | `string` | 否 | "MAIN" | 枚举："MAIN"；"GEM"；"NASD"；"ETS" | 交易市场/板块 枚举含义：MAIN=主板；GEM=创业板；NASD=NASDAQ AMX；ETS=扩充交易证券。 |
| `assetType` | `string` | 否 | "stock" | 枚举："stock"；"etf"；"trust"；"warrant"；"bond" | 证券分类 枚举含义：stock=股票；etf=ETF/信托产品；trust=信托产品；warrant=权证；bond=债券。 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："last"；"change"；"changeRate"；"volume"；"amount"；"amplitude"；"min5Change"；"min5ChangeRate"；"min5Volume"；"min5Amount"；"min5Amplitude"；"totalMarketValue"；"turnoverRate"；"bidAskRate"；"volumeRate"；"perTtm"；"week52High"；"week52Low"；"yearChangeRate" | 排序字段 枚举含义：last=最新价；change=涨跌额；changeRate=涨跌幅；volume=成交量；amount=成交额；amplitude=振幅；min5Change=五分钟涨跌额；min5ChangeRate=五分钟涨跌幅；min5Volume=五分钟成交量；min5Amount=五分钟成交额；min5Amplitude=五分钟振幅；totalMarketValue=总市值；turnoverRate=换手率；bidAskRate=委比；volumeRate=量比；perTtm=市盈率TTM；week52High=52周最高价；week52Low=52周最低价；yearChangeRate=年初至今涨跌幅。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0 | 时间模式 枚举含义：0=实时；1=延时。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
仅允许本分支表中列出的业务字段。
##### 查询分支：`rankType=industry`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："industry" | 枚举含义：industry=行业/概念排行。 |
| `conceptFlag` | `string` | 否 | "N" | 枚举："Y"；"N" | 板块分类 枚举含义：Y=概念；N=行业。 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："change"；"changeRate"；"last"；"volume"；"amount"；"amplitude"；"totalMarketValue"；"negotiableMarketValue"；"perTtm"；"pe"；"turnoverRate" | 排序字段 枚举含义：change=涨跌额；changeRate=涨跌幅；last=最新价；volume=成交量；amount=成交额；amplitude=振幅；totalMarketValue=总市值；negotiableMarketValue=流通市值；perTtm=市盈率TTM；pe=静态市盈率；turnoverRate=换手率。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
仅允许本分支表中列出的业务字段。
##### 查询分支：`rankType=ipo`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："ipo" | 枚举含义：ipo=新股表现排行。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式 枚举含义：0=实时；1=延时。 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："symbol"；"price"；"changeRate"；"listingDate"；"fistDayChangeRate"；"totalChangeRate"；"volume"；"amount"；"continuousRiseDays"；"yearChangeRate" | 排序字段 枚举含义：symbol=证券代码；price=当前价格；changeRate=涨跌幅；listingDate=上市日期；fistDayChangeRate=首日涨幅；totalChangeRate=累计涨幅；volume=成交量；amount=成交额；continuousRiseDays=连涨天数；yearChangeRate=年初至今涨跌幅。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
仅允许本分支表中列出的业务字段。
##### 查询分支：`rankType=broker`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："broker" | 枚举含义：broker=经纪商持仓排行。 |
| `date` | `string` | 否 | 未声明 | 格式：^\d{4}-\d{2}-\d{2}$ | 查询日期 |
| `price` | `number` | 否 | 未声明 | 未声明 | 计算获利比例的指定价格 |
| `symbol` | `string` | 是 | 未声明 | 最短长度：1 | 证券代码 |
| `sortField` | `string` | 否 | "marketCap" | 枚举："marketCap"；"marketCapVariation" | 排序字段 枚举含义：marketCap=当前总市值；marketCapVariation=市值变化量。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
仅允许本分支表中列出的业务字段。
##### 查询分支：`rankType=market_premium`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："market_premium" | 枚举含义：market_premium=A/H溢价排行。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `sortField` | `string` | 否 | "hkChange" | 枚举："hkChange"；"cnChange"；"hkChangeRate"；"cnChangeRate"；"ahPremiumRate"；"H" | 排序字段 枚举含义：hkChange=港股涨跌额；cnChange=A股涨跌额；hkChangeRate=港股涨跌幅；cnChangeRate=A股涨跌幅；ahPremiumRate=A/H溢价率。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
仅允许本分支表中列出的业务字段。
请求示例与补充说明
```json
{
"name": "market_ranking",
"arguments": {
"endpoint": "get_hk_ranking",
"params": {
"rankType": "stock"
}
}
}
```
补充说明：
- 按 rankType 选择 oneOf 分支。variants 的 fields 列出该类型允许的业务字段，overrides 覆盖 parameters 中的同名定义，其余字段不适用。sortField 的 enum 与 enumNames 按分支配套读取，不可跨排行类型复用。
- columns/columnNames/rows；total 仅在提供时存在。数值及单位保持业务口径。
[返回本工具集](#toolset-market_ranking) · [返回入参目录](#parameters)
#### 5.7.2 `get_us_ranking` 美股市场排行
查询美股证券、行业或概念、新股表现及ETF周期排行。
调用工具集：`market_ranking`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_us_ranking | 选择本端点。 |
| `arguments.params` | `object` | 是 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
##### 查询分支：`rankType=stock`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："stock" | 枚举含义：stock=证券排行。 |
| `marketBoard` | `string` | 否 | 未声明 | 枚举："Q"；"N"；"A"；"OTC" | 交易市场/板块 枚举含义：Q=纳斯达克；N=纽约证券交易所；A=NYSE MKT/AMEX；OTC=场外市场。 |
| `stockKind` | `string\|null` | 否 | null | 枚举："C"；"F"；"B"；"O" | 公司分类；B 不代表全部美股 枚举含义：C=中概股；F=知名美股；B=两者交集；O=其他。 |
| `sessionId` | `integer` | 否 | 1 | 枚举：-1；1；-2 | 交易时段 枚举含义：1=盘中；-1=盘前；-2=盘后。 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："changeRate"；"amplitude"；"amount"；"volume" | 排序字段 枚举含义：changeRate=涨跌幅；amplitude=振幅；amount=成交额；volume=成交量。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `assetType` | `string` | 否 | "stock" | 枚举："stock"；"adr"；"bond"；"warrant"；"depositary_receipt"；"convertible_bond" | 证券分类 枚举含义：stock=股票；adr=美国存托股票；bond=债券；warrant=权证；depositary_receipt=存托凭证；convertible_bond=可转换债券。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式 枚举含义：0=实时；1=延时。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
仅允许本分支表中列出的业务字段。
##### 查询分支：`rankType=industry`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："industry" | 枚举含义：industry=行业/概念排行。 |
| `conceptFlag` | `string` | 否 | "N" | 枚举："Y"；"N" | 板块分类 枚举含义：Y=概念；N=行业。 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："change"；"changeRate"；"last"；"volume"；"amount"；"amplitude"；"totalMarketValue"；"negotiableMarketValue"；"perTtm"；"pe"；"turnoverRate" | 排序字段 枚举含义：change=涨跌额；changeRate=涨跌幅；last=最新价；volume=成交量；amount=成交额；amplitude=振幅；totalMarketValue=总市值；negotiableMarketValue=流通市值；perTtm=市盈率TTM；pe=静态市盈率；turnoverRate=换手率。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
仅允许本分支表中列出的业务字段。
##### 查询分支：`rankType=ipo`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："ipo" | 枚举含义：ipo=新股表现排行。 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："changeRate"；"symbol"；"price"；"listingDate"；"fistDayChangeRate"；"totalChangeRate"；"volume"；"amount"；"sortField" | 排序字段 枚举含义：changeRate=涨跌幅；symbol=证券代码；price=当前价格；listingDate=上市日期；fistDayChangeRate=首日涨幅；totalChangeRate=累计涨幅；volume=成交量；amount=成交额。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
仅允许本分支表中列出的业务字段。
##### 查询分支：`rankType=etf`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："etf" | 枚举含义：etf=ETF周期排行。 |
| `types` | `integer[]` | 否 | [0] | 枚举：0；1；2；3；4；5；6；7；8；9；10；11；12；最少项数：1 | ETF周期列表 枚举含义：0=日；1=周；2=月；3=季；4=年；5=1分；6=5分；7=15分；8=30分；9=60分；10=120分；11=3分；12=240分。 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："change"；"changeRate" | 排序字段 枚举含义：change=涨跌额；changeRate=涨跌幅。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式 枚举含义：0=实时；1=延时。 |
仅允许本分支表中列出的业务字段。
请求示例与补充说明
```json
{
"name": "market_ranking",
"arguments": {
"endpoint": "get_us_ranking",
"params": {
"rankType": "stock",
"sortField": "volume",
"sortType": 1,
"pageSize": 20
}
}
}
```
补充说明：
- 按 rankType 选择 oneOf 分支。variants 的 fields 列出该类型允许的业务字段，overrides 覆盖 parameters 中的同名定义，其余字段不适用。sortField 的 enum 与 enumNames 按分支配套读取，不可跨排行类型复用。
- columns/columnNames/rows；total 仅在提供时存在。数值及单位保持业务口径。
[返回本工具集](#toolset-market_ranking) · [返回入参目录](#parameters)
#### 5.7.3 `get_cn_ranking` A股市场排行
查询A股证券、行业或概念及新股表现排行。
调用工具集：`market_ranking`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_cn_ranking | 选择本端点。 |
| `arguments.params` | `object` | 是 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
##### 查询分支：`rankType=stock`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："stock" | 枚举含义：stock=证券排行。 |
| `marketBoard` | `string` | 否 | 未声明 | 枚举："SH"；"SZ" | 交易市场/板块 枚举含义：SH=沪市；SZ=深市。 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："changeRate"；"amplitude"；"amount"；"volume" | 排序字段 枚举含义：changeRate=涨跌幅；amplitude=振幅；amount=成交额；volume=成交量。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `assetType` | `string` | 否 | "stock" | 枚举："stock"；"b_share" | 证券分类 枚举含义：stock=股票；b_share=B股。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式 枚举含义：0=实时；1=延时。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
仅允许本分支表中列出的业务字段。
##### 查询分支：`rankType=industry`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："industry" | 枚举含义：industry=行业/概念排行。 |
| `conceptFlag` | `string` | 否 | "N" | 枚举："Y"；"N" | 板块分类 枚举含义：Y=概念；N=行业。 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："changeRate"；"change"；"last"；"volume"；"amount"；"amplitude"；"totalMarketValue"；"negotiableMarketValue"；"perTtm"；"pe"；"turnoverRate" | 排序字段 枚举含义：changeRate=涨跌幅；change=涨跌额；last=最新价；volume=成交量；amount=成交额；amplitude=振幅；totalMarketValue=总市值；negotiableMarketValue=流通市值；perTtm=市盈率TTM；pe=静态市盈率；turnoverRate=换手率。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
仅允许本分支表中列出的业务字段。
##### 查询分支：`rankType=ipo`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："ipo" | 枚举含义：ipo=新股表现排行。 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："changeRate"；"symbol"；"price"；"listingDate"；"fistDayChangeRate"；"totalChangeRate"；"volume"；"amount" | 排序字段 枚举含义：changeRate=涨跌幅；symbol=证券代码；price=当前价格；listingDate=上市日期；fistDayChangeRate=首日涨幅；totalChangeRate=累计涨幅；volume=成交量；amount=成交额。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式 枚举含义：0=实时；1=延时。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
仅允许本分支表中列出的业务字段。
请求示例与补充说明
```json
{
"name": "market_ranking",
"arguments": {
"endpoint": "get_cn_ranking",
"params": {
"rankType": "stock"
}
}
}
```
补充说明：
- 按 rankType 选择 oneOf 分支。variants 的 fields 列出该类型允许的业务字段，overrides 覆盖 parameters 中的同名定义，其余字段不适用。sortField 的 enum 与 enumNames 按分支配套读取，不可跨排行类型复用。
- columns/columnNames/rows；total 仅在提供时存在。数值及单位保持业务口径。
[返回本工具集](#toolset-market_ranking) · [返回入参目录](#parameters)
#### 5.7.4 `get_jp_ranking` 日股市场排行
查询日股证券、热门股票及行业或概念排行。
调用工具集：`market_ranking`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_jp_ranking | 选择本端点。 |
| `arguments.params` | `object` | 是 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
##### 查询分支：`rankType=stock`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："stock" | 枚举含义：stock=证券排行。 |
| `marketBoard` | `string` | 否 | "ALL" | 枚举："ALL"；"MAIN"；"GEM"；"STANDARD" | 交易市场/板块 枚举含义：ALL=全部；MAIN=主板；GEM=创业板；STANDARD=标准版。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："change"；"changeRate"；"last"；"volume"；"amount"；"amplitude"；"turnoverRate"；"bidAskRate"；"volumeRate" | 排序字段 枚举含义：change=涨跌额；changeRate=涨跌幅；last=最新价；volume=成交量；amount=成交额；amplitude=振幅；turnoverRate=换手率；bidAskRate=委比；volumeRate=量比。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `state` | `string` | 否 | 未声明 | 枚举："all"；"P"；"T" | 交易状态 枚举含义：all=全部；P=停牌；T=交易中。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式 枚举含义：0=实时；1=延时。 |
| `assetType` | `string` | 否 | "stock" | 枚举："stock"；"etf"；"warrant"；"bond"；"trust" | 证券分类 枚举含义：stock=股票；etf=ETF；warrant=权证；bond=债券；trust=信托产品。 |
仅允许本分支表中列出的业务字段。
##### 查询分支：`rankType=hot_stock`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："hot_stock" | 枚举含义：hot_stock=热门股票排行。 |
| `marketBoard` | `string` | 否 | "ALL" | 枚举："ALL"；"MAIN"；"GEM"；"STANDARD" | 交易市场/板块 枚举含义：ALL=全部；MAIN=主板；GEM=创业板；STANDARD=标准版。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："change"；"changeRate"；"last"；"volume"；"amount"；"amplitude"；"turnoverRate"；"bidAskRate"；"volumeRate" | 排序字段 枚举含义：change=涨跌额；changeRate=涨跌幅；last=最新价；volume=成交量；amount=成交额；amplitude=振幅；turnoverRate=换手率；bidAskRate=委比；volumeRate=量比。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
| `state` | `string` | 否 | 未声明 | 枚举："all"；"P"；"T" | 交易状态 枚举含义：all=全部；P=停牌；T=交易中。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式 枚举含义：0=实时；1=延时。 |
| `assetType` | `string` | 否 | "stock" | 枚举："stock"；"etf"；"warrant"；"bond"；"trust" | 证券分类 枚举含义：stock=股票；etf=ETF；warrant=权证；bond=债券；trust=信托产品。 |
仅允许本分支表中列出的业务字段。
##### 查询分支：`rankType=industry`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `rankType` | `string` | 是 | 未声明 | 枚举："industry" | 枚举含义：industry=行业/概念排行。 |
| `conceptFlag` | `string` | 否 | "N" | 枚举："Y"；"N" | 板块分类 枚举含义：Y=概念；N=行业。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1；最大值：100000 | 页码 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1；最大值：200 | 单页数量 |
| `sortField` | `string` | 否 | "changeRate" | 枚举："change"；"changeRate"；"last"；"volume"；"amount"；"turnoverRate"；"amplitude" | 排序字段 枚举含义：change=涨跌额；changeRate=涨跌幅；last=最新价；volume=成交量；amount=成交额；turnoverRate=换手率；amplitude=振幅。 |
| `sortType` | `integer` | 否 | 1 | 枚举：0；1 | 排序方向 枚举含义：0=升序；1=降序。 |
仅允许本分支表中列出的业务字段。
请求示例与补充说明
```json
{
"name": "market_ranking",
"arguments": {
"endpoint": "get_jp_ranking",
"params": {
"rankType": "stock"
}
}
}
```
补充说明：
- 按 rankType 选择 oneOf 分支。variants 的 fields 列出该类型允许的业务字段，overrides 覆盖 parameters 中的同名定义，其余字段不适用。sortField 的 enum 与 enumNames 按分支配套读取，不可跨排行类型复用。
- columns/columnNames/rows；total 仅在提供时存在。数值及单位保持业务口径。
[返回本工具集](#toolset-market_ranking) · [返回入参目录](#parameters)
### 5.8 资金流工具集 `market_flow`
资金流向、资金分布与近 N 日资金流。
[get_capital_flow](#endpoint-get_capital_flow)
#### 5.8.1 `get_capital_flow` 证券资金流向
查询指定证券的当日资金流向、近60日资金流向或资金分布。
调用工具集：`market_flow`。业务参数位置：`arguments`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_capital_flow | 选择本端点。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）、JP（日股）。 |
| `flowType` | `string` | 是 | 未声明 | 枚举："current"；"daily"；"distribution" | flowType 取值：current=当日资金流向，daily=近60日资金流向，distribution=资金分布。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 证券、指数或板块代码，例如 00700.hk、AAPL.us、000001.sh、6758.jp。 |
请求示例与补充说明
```json
{
"name": "market_flow",
"arguments": {
"endpoint": "get_capital_flow",
"market": "HK",
"flowType": "current",
"symbol": "00700.hk"
}
}
```
补充说明：
- 使用 market 和对应的 rankType、flowType、costType、industryType 或 indexType 选择组合；
- flowType 用于选择资金流数据类型，必须明确指定。
- 优先使用 marketBoard、rankType、flowType、costType、industryType、indexType 等语义参数。
- 实时单票报价请使用 quote_spot。
- 常用场景：主力资金、资金净流入、近 N 日资金流、资金成交分布、指数资金分布。
- 资金流类型：current 为当日资金流向，daily 为近60日资金流向，distribution 为资金分布。
- 近 N 日资金流用 flowType=daily，资金分布用 flowType=distribution。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，flowType="current"`
- `market="HK"，flowType="daily"`
- `market="HK"，flowType="distribution"`
- `market="US"，flowType="current"`
- `market="US"，flowType="daily"`
- `market="US"，flowType="distribution"`
- `market="CN"，flowType="current"`
- `market="CN"，flowType="daily"`
- `market="CN"，flowType="distribution"`
- `market="JP"，flowType="current"`
- `market="JP"，flowType="daily"`
- `market="JP"，flowType="distribution"`
[返回本工具集](#toolset-market_flow) · [返回入参目录](#parameters)
### 5.9 行业与指数工具集 `market_structure`
行业列表、行业成分、指数列表、指数成分与指数映射。
[get_industry_data](#endpoint-get_industry_data) · [get_index_data](#endpoint-get_index_data) · [get_market_microstructure](#endpoint-get_market_microstructure)
#### 5.9.1 `get_industry_data` 行业与概念板块数据
查询行业列表、行业排行、行业成分股、所属行业板块。
调用工具集：`market_structure`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_industry_data | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）、JP（日股）。 |
| `industryType` | `string` | 是 | 未声明 | 枚举："list"；"rank"；"constituent"；"belong_quote" | industryType 取值：list=行业列表，rank=行业排行，constituent=行业成分股，belong_quote=所属行业板块行情。 适用范围：constituent 仅适用于 market=HK/US/JP；belong_quote 仅适用于 market=JP。 |
| `conceptFlag` | `string` | 否 | "N" | 枚举："Y"；"N" | 板块标识：Y=概念板块，N=行业板块。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 行业、指数或股票代码；查询成分股或日股所属行业行情时必填。 必填条件：industryType="constituent"；或 market="JP"，industryType="belong_quote"。 |
| `sortField` | `string` | 否 | "changeRate" | 未声明 | 排序字段，例如 changeRate=涨跌幅，amount=成交额，volume=成交量，last=最新价。 |
| `sortType` | `number` | 否 | 1 | 枚举：0；1 | 排序方式：0=升序，1=降序。 |
| `timeMode` | `number` | 否 | 0 | 枚举：0；1 | 时间模式：0=实时，1=延时。 |
| `pageNum` | `number` | 否 | 1 | 最小值：1；最大值：100000 | 页码，从 1 开始。 |
| `pageSize` | `number` | 否 | 20 | 最小值：1；最大值：200 | 单页数量。 |
请求示例与补充说明
```json
{
"name": "market_structure",
"arguments": {
"endpoint": "get_industry_data",
"params": {
"market": "HK",
"industryType": "list"
}
}
}
```
补充说明：
- 使用 market 和对应的 rankType、flowType、costType、industryType 或 indexType 选择组合；
- 优先使用 marketBoard、rankType、flowType、costType、industryType、indexType 等语义参数。
- 实时单票报价请使用 quote_spot。
- timeMode 仅在 JP + industryType=belong_quote 的下游分支声明；其他分支不能据参数名推断提供延时数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，industryType="list"`
- `market="HK"，industryType="rank"`
- `market="HK"，industryType="constituent"`
- `market="US"，industryType="list"`
- `market="US"，industryType="rank"`
- `market="US"，industryType="constituent"`
- `market="CN"，industryType="list"`
- `market="CN"，industryType="rank"`
- `market="JP"，industryType="list"`
- `market="JP"，industryType="rank"`
- `market="JP"，industryType="constituent"`
- `market="JP"，industryType="belong_quote"`
[返回本工具集](#toolset-market_structure) · [返回入参目录](#parameters)
#### 5.9.2 `get_index_data` 指数数据
查询指数列表、指数行情、指数成分股、指数映射、指数资金分布。
调用工具集：`market_structure`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_index_data | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `indexType` | `string` | 是 | 未声明 | 枚举："list"；"quote"；"constituent"；"mapping"；"capital_distribution" | indexType 取值：list=指数列表，quote=指数行情，constituent=指数成分股，mapping=指数映射，capital_distribution=指数资金分布。 适用范围：list 仅适用于 market=HK/CN；mapping 仅适用于 market=HK；capital_distribution 仅适用于 market=HK。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 指数代码；查询成分股、指数映射或资金分布时必填。 必填条件：indexType="constituent"；或 indexType="mapping"；或 indexType="capital_distribution"。 |
| `symbols` | `string[]` | 条件必填 | 未声明 | 未声明 | 指数代码列表，indexType=quote 使用；例如 ["0000100"]。 必填条件：market="HK"，indexType="quote"；或 market="US"，indexType="quote"；或 market="CN"，indexType="quote"。 |
| `indexSeries` | `string` | 否 | 未声明 | 未声明 | 指数系列/类型。 HK 可用 C=中证、H=恒生、S=标普、T=总回报；CN 不传默认全部。 |
| `date` | `string` | 否 | 未声明 | 未声明 | 查询日期，格式 YYYY-MM-DD，例如 2026-07-28；指数列表默认今天。 |
| `typeMode` | `number` | 否 | 1 | 枚举：1；2 | HK 指数列表代码模式：1=交易所原始代码，2=自定义英文代码。 |
| `sortField` | `string` | 否 | "changeRate" | 未声明 | 排序字段，例如 changeRate=涨跌幅，amplitude=振幅，amount=成交额。 |
| `sortType` | `number` | 否 | 1 | 枚举：0；1 | 排序方式：0=升序，1=降序。 |
| `timeMode` | `number` | 否 | 0 | 枚举：0；1 | 时间模式：0=实时，1=延时。 |
| `pageNum` | `number` | 否 | 1 | 最小值：1；最大值：100000 | 页码，从 1 开始。 |
| `pageSize` | `number` | 否 | 20 | 最小值：1；最大值：200 | 单页数量。 |
请求示例与补充说明
```json
{
"name": "market_structure",
"arguments": {
"endpoint": "get_index_data",
"params": {
"market": "HK",
"indexType": "list"
}
}
}
```
补充说明：
- 使用 market 和对应的 rankType、flowType、costType、industryType 或 indexType 选择组合；
- 优先使用 marketBoard、rankType、flowType、costType、industryType、indexType 等语义参数。
- 实时单票报价请使用 quote_spot。
- timeMode 仅在 HK/US/CN + indexType=quote 的下游分支声明。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，indexType="list"`
- `market="HK"，indexType="quote"`
- `market="HK"，indexType="constituent"`
- `market="HK"，indexType="mapping"`
- `market="HK"，indexType="capital_distribution"`
- `market="US"，indexType="quote"`
- `market="US"，indexType="constituent"`
- `market="CN"，indexType="list"`
- `market="CN"，indexType="quote"`
- `market="CN"，indexType="constituent"`
[返回本工具集](#toolset-market_structure) · [返回入参目录](#parameters)
#### 5.9.3 `get_market_microstructure` 市场微观结构
查询市场微观结构数据，如价差、多市场溢价、双柜台、经纪席位。
调用工具集：`market_structure`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_market_microstructure | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：market="HK"，dataType="broker_list"。 |
| `symbols` | `string[]` | 条件必填 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； 必填条件：market="HK"，dataType="market_premium"。 |
| `dataType` | `string` | 是 | 未声明 | 枚举："spread"；"market_premium"；"double_counter"；"broker_list" | 资料类型：spread=价差数据，market_premium=多市场行情溢价，double_counter=双柜台股票列表，broker_list=证券经纪席位。 |
| `date` | `string` | 条件必填 | 未声明 | 未声明 | 双柜台列表查询日期；double_counter 组合必填，格式 YYYY-MM-DD。 必填条件：dataType="double_counter"。 |
请求示例与补充说明
```json
{
"name": "market_structure",
"arguments": {
"endpoint": "get_market_microstructure",
"params": {
"market": "HK",
"dataType": "spread"
}
}
}
```
补充说明：
- dataType 用于选择查询类型。 固定必填参数：dataType。 按所选类型补充条件必填参数：date。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，dataType="spread"`
- `market="HK"，dataType="market_premium"`
- `market="HK"，dataType="double_counter"`
- `market="HK"，dataType="broker_list"`
[返回本工具集](#toolset-market_structure) · [返回入参目录](#parameters)
### 5.10 筹码成本工具集 `market_position_cost`
筹码成本区间与筹码移动分布。
[get_position_cost](#endpoint-get_position_cost)
#### 5.10.1 `get_position_cost` 筹码成本分布
查询筹码成本区间和筹码移动分布。
调用工具集：`market_position_cost`。业务参数位置：`arguments`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_position_cost | 选择本端点。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US" | 市场代码：HK（港股）、US（美股）。 |
| `costType` | `string` | 是 | 未声明 | 枚举："range"；"distribution" | costType 取值：range=查询指定价格获利比例，distribution=查询筹码移动分布。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 证券代码，例如 00700.hk、SPY.US。 |
| `date` | `string` | 否 | 未声明 | 未声明 | 查询日期，格式 YYYY-MM-DD，例如 2026-07-28；不传默认今天。 |
| `price` | `number` | 条件必填 | 未声明 | 未声明 | 指定价格。 必填条件：costType="range"。 |
| `high` | `number` | 条件必填 | 未声明 | 未声明 | 最高价。 必填条件：costType="distribution"。 |
| `low` | `number` | 条件必填 | 未声明 | 未声明 | 最低价。 必填条件：costType="distribution"。 |
请求示例与补充说明
```json
{
"name": "market_position_cost",
"arguments": {
"endpoint": "get_position_cost",
"market": "HK",
"costType": "range",
"symbol": "00700.hk",
"price": 1
}
}
```
补充说明：
- 使用 market 和对应的 rankType、flowType、costType、industryType 或 indexType 选择组合；
- 优先使用 marketBoard、rankType、flowType、costType、industryType、indexType 等语义参数。
- 实时单票报价请使用 quote_spot。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，costType="range"`
- `market="HK"，costType="distribution"`
- `market="US"，costType="range"`
- `market="US"，costType="distribution"`
[返回本工具集](#toolset-market_position_cost) · [返回入参目录](#parameters)
### 5.11 公司资料工具集 `f10_profile`
公司基础资料、公司概况、关联资料和高管资料；不提供公告全文、新闻资讯或研报搜索。
[get_company_profile](#endpoint-get_company_profile) · [get_company_management](#endpoint-get_company_management) · [get_company_extra_profile](#endpoint-get_company_extra_profile)
#### 5.11.1 `get_company_profile` 公司综合资料
查询公司基础资料、公司资料和关联资料。
调用工具集：`f10_profile`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_company_profile | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 单个证券代码。 |
请求示例与补充说明
```json
{
"name": "f10_profile",
"arguments": {
"endpoint": "get_company_profile",
"params": {
"market": "HK",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- 公司资料工具返回结构化 F10 信息，不提供新闻、公告或研报检索。 固定必填参数：symbol。 仅使用 parameters 中声明的业务字段。
- A 股简介来源未提供可核验的独立更新日期、披露日期和 URL 时，profileUpdatedAt、sourcePublishedAt、sourceUrl 返回 null，profileFreshness=unverified；periodEndDate 仅是财务期末，不证明简介已更新。
- 公司资料工具返回结构化 F10 信息，不提供新闻、公告或研报检索。
- 常用场景：公司简介、主营业务、注册地址、行业、上市信息、关联资料。
- 按 market 自动查询该市场可用的公司资料，并合并去重结果；使用 symbol 指定证券。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"`
- `market="US"`
- `market="CN"`
[返回本工具集](#toolset-f10_profile) · [返回入参目录](#parameters)
#### 5.11.2 `get_company_management` 公司高管
查询公司高管。
调用工具集：`f10_profile`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_company_management | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：market="HK"；或 market="US"；或 market="CN"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
请求示例与补充说明
```json
{
"name": "f10_profile",
"arguments": {
"endpoint": "get_company_management",
"params": {
"market": "HK",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- 公司资料工具返回结构化 F10 信息，不提供新闻、公告或研报检索。 仅使用 parameters 中声明的业务字段。
- 公司资料工具返回结构化 F10 信息，不提供新闻、公告或研报检索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"`
- `market="US"`
- `market="CN"`
[返回本工具集](#toolset-f10_profile) · [返回入参目录](#parameters)
#### 5.11.3 `get_company_extra_profile` 公司扩展资料
查询公司扩展资料或特殊证券资料，如 A 股扩展行情、港股并行交易。
调用工具集：`f10_profile`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_company_extra_profile | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 条件必填 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； 必填条件：market="CN"，dataType="extend_all"。 |
| `dataType` | `string` | 是 | 未声明 | 枚举："parallel"；"extend_all" | 资料类型：parallel=港股并行交易，extend_all=A股扩展行情。 适用范围：parallel 仅适用于 market=HK；extend_all 仅适用于 market=CN。 |
请求示例与补充说明
```json
{
"name": "f10_profile",
"arguments": {
"endpoint": "get_company_extra_profile",
"params": {
"market": "HK",
"dataType": "parallel",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- dataType 用于选择查询类型。 固定必填参数：dataType。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，dataType="parallel"`
- `market="CN"，dataType="extend_all"`
[返回本工具集](#toolset-f10_profile) · [返回入参目录](#parameters)
### 5.12 财务报表工具集 `f10_financials`
利润表、资产负债表、现金流量表与财务指标；不提供年报公告 PDF、公告全文或研报搜索。
[get_financial_statement](#endpoint-get_financial_statement) · [get_financial_indicator](#endpoint-get_financial_indicator)
#### 5.12.1 `get_financial_statement` 财务报表
查询利润表、资产负债表、现金流量表。
调用工具集：`f10_financials`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_financial_statement | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 组合必填 | 未声明 | 未声明 | 证券代码，例如 00700.hk。symbol 或 symbols 至少提供一项；同一请求的证券须属于指定 market。 |
| `symbols` | `string[]` | 组合必填 | 未声明 | 未声明 | 批量证券代码，例如 ["00700.hk","00388.hk"]。symbol 或 symbols 至少提供一项；同一请求的证券须属于指定 market。 |
| `statementType` | `string` | 是 | 未声明 | 枚举："income"；"balance"；"cash" | 报表类型：income=利润表，balance=资产负债表，cash=现金流量表。 |
| `reportType` | `string\|integer` | 否 | 未声明 | 枚举："F"；"I"；"P"；"FY"；"I1"；"I2"；"Q1"；"Q2"；"Q3"；"Q4"；1；6；9；12；99 | 报告期筛选。 港股：F、I、P、Q1、Q2、Q3、Q4；美股：FY、I1、I2、Q1、Q2、Q3、Q4，Q6/Q9 分别归一为 Q2/Q3；A股：1、6、9、12、99。 |
| `startDate` | `string` | 否 | 未声明 | 未声明 | 报告日期下界，格式 YYYY-MM-DD。 显式传入任一日期边界时严格使用调用方日期范围，不为 reportSize 自动扩展。 |
| `endDate` | `string` | 否 | 未声明 | 未声明 | 报告日期上界，格式 YYYY-MM-DD，不能早于 startDate。 显式传入任一日期边界时严格使用调用方日期范围。 |
| `sort` | `string` | 否 | 未声明 | 枚举："desc"；"asc"；"DESC"；"ASC" | 按报告日期排序，默认 desc。 reportSize 在排序后按行生效；未传日期的 HK/CN 升序查询受 30 年窗口约束，dataCoverage 标记为 limited。 |
| `reportSize` | `integer` | 否 | 未声明 | 最小值：1；最大值：1000 | 筛选、排序后最多返回的行数，范围 1-1000。 |
请求示例与补充说明
```json
{
"name": "f10_financials",
"arguments": {
"endpoint": "get_financial_statement",
"params": {
"market": "HK",
"statementType": "income",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- 公开请求字段为 market、symbol/symbols、statementType、reportType、startDate、endDate、sort、reportSize。symbol 或 symbols 至少提供一项。metric 已不属于三表的公开参数；需要关键指标时查询 get_financial_indicator 的独立契约。
- reportSize 为筛选、排序后的返回行数上限（1～1000），默认按日期降序；US 三表按 periodEndDate 排序，其他市场按来源 reportDate 排序。同日多个报告类型各占一行；returnedRowCount 等于 rows.length。
- 三表返回 columns、columnNames、rows 紧凑表；批量证券归一化、去重后分别取数，symbolResults/symbolErrors 说明各证券结果。
- dataCoverage=complete/limited/unknown 表示候选记录获取范围；仅凭返回条数或空结果不能认定完整历史或某期不存在。
- US 的 endDate 用于派生 periodEndDate；财年与报告类型可核验时生成 fiscalPeriodKey。sourceReportType 保留原码；Q6/Q9 归一为 Q2/Q3。缺少 coverMonths 时仅按已确认原码补值，不自动拆分累计数。
- 财报日期按市场、报表和来源字段含义解释。US reportDate 为供应商标注的披露日，可能缺失或与期末相同；不能将 reportDate 或 endDate 当作首次公开时刻，也不能据此推导修订版本。
- 币种码 110/502/142 分别显示为港币/美元/人民币。HK 三表补充已确认的会计准则；CN standardCode=2 显示为中国2007版会计准则。未知单位、倍率和准则不推算。
- 现金流净额保留原始正负号。各市场资本支出的范围不同，当前不统一生成资本支出或自由现金流；财务记录不自动关联公告 URL 或修订 ID。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，statementType="income"`
- `market="HK"，statementType="balance"`
- `market="HK"，statementType="cash"`
- `market="US"，statementType="income"`
- `market="US"，statementType="balance"`
- `market="US"，statementType="cash"`
- `market="CN"，statementType="income"`
- `market="CN"，statementType="balance"`
- `market="CN"，statementType="cash"`
[返回本工具集](#toolset-f10_financials) · [返回入参目录](#parameters)
#### 5.12.2 `get_financial_indicator` 关键财务指标
查询关键财务指标。
调用工具集：`f10_financials`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_financial_indicator | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 组合必填 | 未声明 | 未声明 | 证券代码，例如 00700.hk。symbol 或 symbols 至少提供一项；同一请求的证券须属于指定 market。 |
| `symbols` | `string[]` | 组合必填 | 未声明 | 未声明 | 批量证券代码，例如 ["00700.hk","00388.hk"]。symbol 或 symbols 至少提供一项；同一请求的证券须属于指定 market。 |
| `reportType` | `string\|integer` | 否 | 未声明 | 枚举："F"；"I"；"P"；"FY"；"I1"；"I2"；"Q1"；"Q2"；"Q3"；"Q4"；1；6；9；12；99 | 报告期筛选。 港股：F、I、P、Q1、Q2、Q3、Q4；美股：FY、I1、I2、Q1、Q2、Q3、Q4，Q6/Q9 分别归一为 Q2/Q3；A股：1、6、9、12、99。 |
| `metric` | `string` | 否 | 未声明 | 枚举："net_profit"；"parent_net_profit"；"deducted_parent_net_profit"；"depreciation_amortization"；"ebitda"；"currentRatio"；"currentRatioYoY"；"quickRatio"；"quickRatioYoY"；"returnOnEquity"；"returnOnEquityYoY"；"returnOnTotalAssets"；"returnOnTotalAssetsYoY"；"grossProfitMargin"；"grossProfitMarginYoY"；"netIncomeRatio"；"netIncomeRatioYoY"；"netAssetsPS"；"netAssetsPSYoY"；"BasicEPS"；"BasicEPSYOY"；"dilutedeps"；"dilutedepsYoY"；"eps"；"epsYOY"；"epsTTM"；"epsTTMYoY"；"capitalReservePS"；"capitalReservePSYoY"；"retainedEarningPS"；"retainedEarningPSYoY"；"netCashFlowOperPS"；"netCashFlowOperPSYoY"；"shfcfPS"；"shfcfPSYoY"；"ebitPS"；"ebitPSYoY"；"OperIncomePS"；"OperIncomePSYoY"；"netCashFlowPS"；"netCashFlowPSYoY"；"operatingIncome"；"operatingIncomeYoY"；"operatingProfit"；"operatingProfitYoY"；"netProfit"；"netProfitYoY"；"pe"；"peYoY"；"totalAssets"；"totalAssetsYoY"；"totalLiabilities"；"totalLiabilitiesYoY"；"debtAssetRatio"；"debtAssetRatioYoY"；"pb"；"pbYoY"；"netCashFromOperating"；"netCashFromOperatingYoY"；"netCashFromInvesting"；"netCashFromInvestingYoY"；"netCashFromFinancing"；"netCashFromFinancingYoY"；"netProfitParentCom"；"minorityProfit" | 可选关键指标；net_profit、parent_net_profit、deducted_parent_net_profit 分别表示净利润、归母净利润、扣非归母净利润，不互相回退。 depreciation_amortization 和 ebitda 应通过 get_financial_statement 对应报表查询；没有来源时明确返回 METRIC_UNSUPPORTED。 |
请求示例与补充说明
```json
{
"name": "f10_financials",
"arguments": {
"endpoint": "get_financial_indicator",
"params": {
"market": "HK",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- symbol 或 symbols 至少提供一项。metric 为此端点的可选字段；省略时返回指标表，取值和可用市场以本表为准，不套用三大报表的字段别名。
- 采用 columns、columnNames、rows 紧凑表。数值 0 为有效值；指标缺失保留 null，不能按零值计算。
- 指标可用性需结合 resultStatus、emptyReason、metricAvailability 及 valueStatus 判断；有报告期记录不保证指标存在。US 独立关键指标保留已确认字段及中文名，字段值为 null 时仍保留列。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"`
- `market="US"`
- `market="CN"`
[返回本工具集](#toolset-f10_financials) · [返回入参目录](#parameters)
### 5.13 公司经营治理工具集 `f10_business_governance`
主营构成、公司行动、分红、拆股、股东大会、回购与股本结构；这是结构化事件数据，不是上市公司公告全文搜索。
[get_business_segment](#endpoint-get_business_segment) · [get_company_action](#endpoint-get_company_action)
#### 5.13.1 `get_business_segment` 主营构成与业务分部
查询主营构成/业务分部，支持按报告期、类别、日期区间和排序方向筛选。
调用工具集：`f10_business_governance`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_business_segment | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：market="HK"；或 market="US"；或 market="CN"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `startDate` | `string` | 否 | 未声明 | 未声明 | 开始日期，格式 YYYY-MM-DD；与 endDate 一起限定报告日期区间。 |
| `endDate` | `string` | 否 | 未声明 | 未声明 | 结束日期，格式 YYYY-MM-DD；不能早于 startDate。 |
| `sort` | `string` | 否 | 未声明 | 枚举："desc"；"asc"；"DESC"；"ASC" | 按报告日期排序：desc/DESC=降序，asc/ASC=升序。 |
| `reportType` | `string\|integer` | 否 | 未声明 | 枚举："F"；"I1"；"I2"；"Q1"；"Q2"；"Q3"；"Q4"；"T1"；"T2"；"T3"；"T4"；"I"；"P"；"Q5"；"Q6"；1；6；9；12；99 | 报告期筛选。 美股：F、I1、I2、Q1、Q2、Q3、Q4、T1、T2、T3、T4；港股：F、I、P、Q1、Q2、Q3、Q4、Q5、Q6；A股：1、6、9、12、99。 |
| `segmentType` | `string\|integer` | 否 | 未声明 | 枚举："B"；"G"；1000；1100；1200 | 分部类别。 港股/美股：B=按业务，G=按地区；A股：1000=行业，1100=产品，1200=地区。 省略时返回所有类别。 |
请求示例与补充说明
```json
{
"name": "f10_business_governance",
"arguments": {
"endpoint": "get_business_segment",
"params": {
"market": "HK",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
- CN 主营构成中的 currency=142 或字符串 "142" 映射为 CNY。US 分部按同证券资产负债表的唯一匹配补充 periodEndDate/fiscalPeriodKey；无法确认时保留 null 和 warning，该补查增加一次 F10 请求。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"`
- `market="US"`
- `market="CN"`
[返回本工具集](#toolset-f10_business_governance) · [返回入参目录](#parameters)
#### 5.13.2 `get_company_action` 公司行动
查询证券的结构化公司行动，如分红、拆股、股东大会、回购和股本结构。
调用工具集：`f10_business_governance`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_company_action | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：market="HK"，actionType="meeting"；或 market="HK"，actionType="hold_change"；或 market="HK"，actionType="repurchase"；或 market="US"，actionType="dividends"；或 market="US"，actionType="splits"；或 market="US"，actionType="meeting"；或 market="US"，actionType="hold_change"；或 market="CN"，actionType="dividends"；或 market="CN"，actionType="meeting"；或 market="CN"，actionType="repurchase"；或 market="CN"，actionType="share_structure"。 |
| `actionType` | `string` | 是 | 未声明 | 枚举："dividends"；"splits"；"meeting"；"hold_change"；"repurchase"；"share_structure" | actionType 取值：dividends、splits、meeting、hold_change、repurchase、share_structure。 适用范围：splits 仅适用于 market=HK/US；hold_change 仅适用于 market=HK/US；repurchase 仅适用于 market=HK/CN；share_structure 仅适用于 market=CN。 |
请求示例与补充说明
```json
{
"name": "f10_business_governance",
"arguments": {
"endpoint": "get_company_action",
"params": {
"market": "HK",
"actionType": "dividends",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 公司行动是结构化事件数据，不返回公告全文；A股当前只覆盖分红、股东大会、回购和股本结构等已提供事件。 actionType 用于选择查询类型。 固定必填参数：actionType。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 公司行动是结构化事件数据，不返回公告全文；A股当前只覆盖分红、股东大会、回购和股本结构等已提供事件。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，actionType="dividends"`
- `market="HK"，actionType="splits"`
- `market="HK"，actionType="meeting"`
- `market="HK"，actionType="hold_change"`
- `market="HK"，actionType="repurchase"`
- `market="US"，actionType="dividends"`
- `market="US"，actionType="splits"`
- `market="US"，actionType="meeting"`
- `market="US"，actionType="hold_change"`
- `market="CN"，actionType="dividends"`
- `market="CN"，actionType="meeting"`
- `market="CN"，actionType="repurchase"`
- `market="CN"，actionType="share_structure"`
[返回本工具集](#toolset-f10_business_governance) · [返回入参目录](#parameters)
### 5.14 股东结构工具集 `shareholding_structure`
主要股东、十大股东、当前持股与持股变动。
[get_shareholders](#endpoint-get_shareholders) · [get_shareholding_change](#endpoint-get_shareholding_change)
#### 5.14.1 `get_shareholders` 股东与持股结构
查询主要股东、十大股东、当前持股、股东权益明细等。
调用工具集：`shareholding_structure`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_shareholders | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：market="HK"，holdingType="major"；或 market="HK"，holdingType="current"；或 market="US"，holdingType="major"；或 market="CN"，holdingType="topten"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `holdingType` | `string` | 是 | 未声明 | 枚举："major"；"current"；"detail"；"topten" | 持股数据类型：major、current、detail、topten。 适用范围：major 仅适用于 market=HK/US；current 仅适用于 market=HK；detail 仅适用于 market=HK；topten 仅适用于 market=CN。 |
请求示例与补充说明
```json
{
"name": "shareholding_structure",
"arguments": {
"endpoint": "get_shareholders",
"params": {
"market": "HK",
"holdingType": "major",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- holdingType 用于选择查询类型。 固定必填参数：holdingType。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，holdingType="major"`
- `market="HK"，holdingType="current"`
- `market="HK"，holdingType="detail"`
- `market="US"，holdingType="major"`
- `market="CN"，holdingType="topten"`
[返回本工具集](#toolset-shareholding_structure) · [返回入参目录](#parameters)
#### 5.14.2 `get_shareholding_change` 股本与持股变动
查询股本变动、高管持股变动等。
调用工具集：`shareholding_structure`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_shareholding_change | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：market="HK"；或 market="US"，holdingType="hold_change"；或 market="US"，holdingType="manager"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `holdingType` | `string` | 条件必填 | 未声明 | 未声明 | holdingType 用于选择查询类型。 必填条件：market="US"。 |
请求示例与补充说明
```json
{
"name": "shareholding_structure",
"arguments": {
"endpoint": "get_shareholding_change",
"params": {
"market": "HK",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- 公司行动是结构化事件数据，不返回公告全文；A股当前只覆盖分红、股东大会、回购和股本结构等已提供事件。 holdingType 用于选择查询类型。 仅使用 parameters 中声明的业务字段。
- 公司行动是结构化事件数据，不返回公告全文；A股当前只覆盖分红、股东大会、回购和股本结构等已提供事件。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"`
- `market="US"，holdingType="hold_change"`
- `market="US"，holdingType="manager"`
[返回本工具集](#toolset-shareholding_structure) · [返回入参目录](#parameters)
### 5.15 机构持股工具集 `shareholding_institution`
机构持股明细与机构持股统计。
[get_institution_holding](#endpoint-get_institution_holding)
#### 5.15.1 `get_institution_holding` 美股机构持股
查询机构持股明细或统计。
调用工具集：`shareholding_institution`。业务参数位置：`arguments`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_institution_holding | 选择本端点。 |
| `market` | `string` | 否 | "US" | 枚举："US" | 市场代码，固定为 US（美股）；可省略，默认 US。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 证券代码，需带 .US 或 .us 后缀，例如 AAPL.US。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量证券代码列表，需带 .US 或 .us 后缀，例如 ["BABA.US", "AAPL.us"]。 |
| `holdingType` | `string` | 是 | 未声明 | 枚举："detail"；"statistics" | 持股数据类型：detail=机构持股明细，statistics=机构持股统计。 |
请求示例与补充说明
```json
{
"name": "shareholding_institution",
"arguments": {
"endpoint": "get_institution_holding",
"market": "US",
"holdingType": "detail",
"symbol": "AAPL.us"
}
}
```
补充说明：
- holdingType 用于选择查询类型。 固定必填参数：market、symbol、holdingType。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="US"，holdingType="detail"`
- `market="US"，holdingType="statistics"`
[返回本工具集](#toolset-shareholding_institution) · [返回入参目录](#parameters)
### 5.16 券商持股与沽空工具集 `shareholding_fund_broker`
券商持股与沽空数据。
[get_broker_holding](#endpoint-get_broker_holding) · [get_short_sell](#endpoint-get_short_sell)
#### 5.16.1 `get_broker_holding` 港股券商持股
查询港股经纪商持股比例、持股详情、经纪商持仓排行。
调用工具集：`shareholding_fund_broker`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_broker_holding | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 港股代码，例如 00700.hk；ratio/detail/statistics/rank/f10_ratio 都需要。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `holdingType` | `string` | 是 | 未声明 | 枚举："ratio"；"detail"；"statistics"；"rank"；"f10_ratio" | 持股数据类型：ratio=持股比例，detail=持股详情，statistics=经纪商成交统计，rank=经纪商排行，f10_ratio=F10券商持股比例。 |
| `brokerId` | `string` | 条件必填 | 未声明 | 未声明 | 经纪商编号；detail 组合必填，格式为 Cxxxxx，例如 C12345。 必填条件：holdingType="detail"。 |
| `type` | `string` | 条件必填 | 未声明 | 枚举："B"；"S" | 成交方向；statistics 组合必填：B=净买入，S=净卖出。 必填条件：holdingType="statistics"。 |
| `size` | `integer` | 条件必填 | 未声明 | 未声明 | 统计返回数量；statistics 组合必填，例如 10。 必填条件：holdingType="statistics"。 |
| `sortField` | `string` | 条件必填 | 未声明 | 枚举："marketCap"；"marketCapVariation" | 排行字段；rank 组合必填：marketCap=当前总市值，marketCapVariation=市值变化量。 必填条件：holdingType="rank"。 |
| `date` | `string` | 条件必填 | 未声明 | 未声明 | 查询日期/时间。 默认日期格式为 YYYY-MM-DD；K线分钟级、逐笔、分时等需要精确时刻的场景使用 YYYY-MM-DD HH:mm:ss。 必填条件：market="HK"，holdingType="detail"。 |
| `number` | `string` | 条件必填 | 未声明 | 未声明 | number 用于选择查询类型。 必填条件：market="HK"，holdingType="detail"。 |
请求示例与补充说明
```json
{
"name": "shareholding_fund_broker",
"arguments": {
"endpoint": "get_broker_holding",
"params": {
"market": "HK",
"holdingType": "ratio",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- holdingType 用于选择查询类型。 固定必填参数：holdingType、symbol。 按所选类型补充条件必填参数：brokerId、type、size、sortField。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，holdingType="ratio"`
- `market="HK"，holdingType="detail"`
- `market="HK"，holdingType="statistics"`
- `market="HK"，holdingType="rank"`
- `market="HK"，holdingType="f10_ratio"`
[返回本工具集](#toolset-shareholding_fund_broker) · [返回入参目录](#parameters)
#### 5.16.2 `get_short_sell` 每日沽空数据
查询每日沽空。
调用工具集：`shareholding_fund_broker`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_short_sell | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US" | 市场代码：HK（港股）、US（美股）。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：market="HK"；或 market="US"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
请求示例与补充说明
```json
{
"name": "shareholding_fund_broker",
"arguments": {
"endpoint": "get_short_sell",
"params": {
"market": "HK",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"`
- `market="US"`
[返回本工具集](#toolset-shareholding_fund_broker) · [返回入参目录](#parameters)
### 5.17 基金与 ETF 工具集 `fund_data`
全球基金搜索、资料、净值、业绩、风险、持仓、配置、费率、经理、分红、排行、筛选与国家代码解析。
[search_funds](#endpoint-search_funds) · [get_fund_profile](#endpoint-get_fund_profile) · [get_fund_managers](#endpoint-get_fund_managers) · [get_fund_distributions](#endpoint-get_fund_distributions) · [get_fund_terms](#endpoint-get_fund_terms) · [get_fund_nav](#endpoint-get_fund_nav) · [get_fund_performance](#endpoint-get_fund_performance) · [compare_funds](#endpoint-compare_funds) · [get_fund_risk](#endpoint-get_fund_risk) · [rank_funds](#endpoint-rank_funds) · [screen_funds](#endpoint-screen_funds) · [get_fund_holdings](#endpoint-get_fund_holdings) · [get_fund_exposure](#endpoint-get_fund_exposure) · [get_fund_benchmark](#endpoint-get_fund_benchmark) · [get_fund_sales_markets](#endpoint-get_fund_sales_markets) · [get_country_code](#endpoint-get_country_code)
#### 5.17.1 `search_funds` 全球基金搜索
没有稳定基金标识时，按名称、Ticker 或证券标识搜索全球基金；也可列出分类、管理人和份额类别。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：search_funds | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `mode` | `string` | 否 | "search" | 枚举："search"；"categories"；"providers"；"share_classes" | 查询模式；share_classes 模式必须传 fund_id。 |
| `query` | `string` | 否 | 未声明 | 未声明 | 搜索基金名称、ISIN、Ticker、CUSIP 或 SEDOL；普通文本至少 2 个字符。 |
| `category` | `string` | 否 | 未声明 | 未声明 | 基金分类代码或名称。 |
| `provider_id` | `string` | 否 | 未声明 | 未声明 | 基金管理公司标识。 |
| `currency` | `string` | 否 | 未声明 | 未声明 | 基金计价币种。 |
| `sales_market` | `string` | 否 | 未声明 | 未声明 | 注册销售市场，支持 ISO3、ISO2 或国家名称。 |
| `fund_id` | `string` | 条件必填 | 未声明 | 未声明 | 基金实体标识；mode=share_classes 时必填。 必填条件：mode="share_classes"。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "search_funds",
"params": {
"mode": "search",
"query": "Vanguard"
}
}
}
```
补充说明：
- 没有稳定基金标识时，按名称、Ticker 或证券标识搜索全球基金；也可列出分类、管理人和份额类别。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.2 `get_fund_profile` 基金基本资料
按 fund_id 或 fund_class_id 查询基金基本资料；operation=size 查询资产规模历史。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_fund_profile | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_id` | `string` | 二选一 | 未声明 | 未声明 | 基金实体标识（例如 FS...）；与 fund_class_id 二选一且只传一个。 |
| `fund_class_id` | `string` | 二选一 | 未声明 | 未声明 | 基金份额类别标识（例如 F0...）；与 fund_id 二选一且只传一个。 |
| `operation` | `string` | 否 | "default" | 枚举："default"；"size" | 查询内容：default=基本资料，size=资产规模历史。 |
| `start_date` | `string` | 否 | 未声明 | 未声明 | 起始日期，格式 YYYY-MM-DD；operation=size 时可按日期范围过滤；start_date 与 end_date 必须成对提供。 |
| `end_date` | `string` | 否 | 未声明 | 未声明 | 结束日期，格式 YYYY-MM-DD；operation=size 时可按日期范围过滤；start_date 与 end_date 必须成对提供。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_fund_profile",
"params": {
"fund_id": ""
}
}
}
```
补充说明：
- 按 fund_id 或 fund_class_id 查询基金基本资料；operation=size 查询资产规模历史。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.3 `get_fund_managers` 基金经理
按基金标识查询基金经理；operation 选择当前记录、任职历史、履历或教育经历。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_fund_managers | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_id` | `string` | 二选一 | 未声明 | 未声明 | 基金实体标识（例如 FS...）；与 fund_class_id 二选一且只传一个。 |
| `fund_class_id` | `string` | 二选一 | 未声明 | 未声明 | 基金份额类别标识（例如 F0...）；与 fund_id 二选一且只传一个。 |
| `operation` | `string` | 否 | "current" | 枚举："current"；"history"；"bio"；"education" | 查询内容：current=当前经理，history=任职历史，bio=履历，education=教育经历。 |
| `start_date` | `string` | 条件必填 | 未声明 | 未声明 | 起始日期，格式 YYYY-MM-DD；operation=history 时必填。 必填条件：operation="history"。 |
| `end_date` | `string` | 条件必填 | 未声明 | 未声明 | 结束日期，格式 YYYY-MM-DD；operation=history 时必填。 必填条件：operation="history"。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_fund_managers",
"params": {
"fund_id": ""
}
}
}
```
补充说明：
- 按基金标识查询基金经理；operation 选择当前记录、任职历史、履历或教育经历。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.4 `get_fund_distributions` 基金分红与收益分配
按基金标识和必填起止日期查询分红及收益分配历史。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_fund_distributions | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_id` | `string` | 二选一 | 未声明 | 未声明 | 基金实体标识（例如 FS...）；与 fund_class_id 二选一且只传一个。 |
| `fund_class_id` | `string` | 二选一 | 未声明 | 未声明 | 基金份额类别标识（例如 F0...）；与 fund_id 二选一且只传一个。 |
| `start_date` | `string` | 是 | 未声明 | 未声明 | 分红起始日期，格式 YYYY-MM-DD，查询范围最多 3650 天。 |
| `end_date` | `string` | 是 | 未声明 | 未声明 | 分红结束日期，格式 YYYY-MM-DD，查询范围最多 3650 天。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_fund_distributions",
"params": {
"start_date": "2026-01-01",
"end_date": "2026-09-30",
"fund_id": ""
}
}
}
```
补充说明：
- 按基金标识和必填起止日期查询分红及收益分配历史。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.5 `get_fund_terms` 基金费率与申购条件
按基金标识查询费率、投资者限制或申购信息；使用 kind 选择内容。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_fund_terms | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_id` | `string` | 二选一 | 未声明 | 未声明 | 基金实体标识（例如 FS...）；与 fund_class_id 二选一且只传一个。 |
| `fund_class_id` | `string` | 二选一 | 未声明 | 未声明 | 基金份额类别标识（例如 F0...）；与 fund_id 二选一且只传一个。 |
| `kind` | `string` | 否 | "fees" | 枚举："fees"；"constraints"；"purchase" | 条款类型：fees=费率，constraints=投资者限制，purchase=申购信息。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_fund_terms",
"params": {
"fund_id": ""
}
}
}
```
补充说明：
- 按基金标识查询费率、投资者限制或申购信息；使用 kind 选择内容。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.6 `get_fund_nav` 基金净值
按基金标识查询最新单位净值；operation=history 时按起止日期查询历史净值。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_fund_nav | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_id` | `string` | 二选一 | 未声明 | 未声明 | 基金实体标识（例如 FS...）；与 fund_class_id 二选一且只传一个。 |
| `fund_class_id` | `string` | 二选一 | 未声明 | 未声明 | 基金份额类别标识（例如 F0...）；与 fund_id 二选一且只传一个。 |
| `operation` | `string` | 否 | "latest" | 枚举："latest"；"history" | 查询内容：latest=最新净值，history=历史净值。 |
| `start_date` | `string` | 条件必填 | 未声明 | 未声明 | 起始日期，格式 YYYY-MM-DD；operation=history 时必填。 必填条件：operation="history"。 |
| `end_date` | `string` | 条件必填 | 未声明 | 未声明 | 结束日期，格式 YYYY-MM-DD；operation=history 时必填。 必填条件：operation="history"。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_fund_nav",
"params": {
"fund_id": ""
}
}
}
```
补充说明：
- 按基金标识查询最新单位净值；operation=history 时按起止日期查询历史净值。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.7 `get_fund_performance` 基金业绩表现
按基金标识查询数据库区间业绩；operation=custom 时按起止日期计算收益。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_fund_performance | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_id` | `string` | 二选一 | 未声明 | 未声明 | 基金实体标识（例如 FS...）；与 fund_class_id 二选一且只传一个。 |
| `fund_class_id` | `string` | 二选一 | 未声明 | 未声明 | 基金份额类别标识（例如 F0...）；与 fund_id 二选一且只传一个。 |
| `operation` | `string` | 否 | "latest" | 枚举："latest"；"custom" | 查询内容：latest=最新区间业绩，custom=自定义区间收益。 |
| `start_date` | `string` | 条件必填 | 未声明 | 未声明 | 起始日期，格式 YYYY-MM-DD；operation=custom 时必填。 必填条件：operation="custom"。 |
| `end_date` | `string` | 条件必填 | 未声明 | 未声明 | 结束日期，格式 YYYY-MM-DD；operation=custom 时必填。 必填条件：operation="custom"。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_fund_performance",
"params": {
"fund_id": ""
}
}
}
```
补充说明：
- 按基金标识查询数据库区间业绩；operation=custom 时按起止日期计算收益。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.8 `compare_funds` 基金资料对比
使用 fund_ids 和 fund_class_ids 比较 2 至 10 个基金或份额类别的基本资料。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：compare_funds | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_ids` | `string[]` | 组合必填 | 未声明 | 未声明 | 基金实体标识列表；与 fund_class_ids 合计 2-10 个，不能重复。 |
| `fund_class_ids` | `string[]` | 组合必填 | 未声明 | 未声明 | 基金份额类别标识列表；与 fund_ids 合计 2-10 个，不能重复。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "compare_funds",
"params": {
"fund_ids": [
"<第一个基金fund_id>",
"<第二个基金fund_id>"
]
}
}
}
```
补充说明：
- 使用 fund_ids 和 fund_class_ids 比较 2 至 10 个基金或份额类别的基本资料。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.9 `get_fund_risk` 基金风险与评级
按基金标识查询风险指标、基金评级或债券组合统计；使用 operation 选择内容。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_fund_risk | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_id` | `string` | 二选一 | 未声明 | 未声明 | 基金实体标识（例如 FS...）；与 fund_class_id 二选一且只传一个。 |
| `fund_class_id` | `string` | 二选一 | 未声明 | 未声明 | 基金份额类别标识（例如 F0...）；与 fund_id 二选一且只传一个。 |
| `operation` | `string` | 否 | "default" | 枚举："default"；"rating"；"debt" | 查询内容：default=风险指标，rating=基金评级，debt=债券组合统计。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_fund_risk",
"params": {
"fund_id": ""
}
}
}
```
补充说明：
- 按基金标识查询风险指标、基金评级或债券组合统计；使用 operation 选择内容。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.10 `rank_funds` 基金排行
按受控业绩或分类排名字段对基金份额类别排行，可按分类、管理人、币种或销售市场过滤。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：rank_funds | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `rank_field` | `string` | 否 | "return_1y" | 枚举："return_1d"；"return_1w"；"return_1m"；"return_3m"；"return_6m"；"return_ytd"；"return_1y"；"return_3y"；"return_5y"；"return_10y"；"rank_1y"；"rank_3y" | 排行字段。 |
| `category` | `string` | 否 | 未声明 | 未声明 | 基金分类代码或名称。 |
| `provider_id` | `string` | 否 | 未声明 | 未声明 | 基金管理公司标识。 |
| `currency` | `string` | 否 | 未声明 | 未声明 | 基金计价币种。 |
| `sales_market` | `string` | 否 | 未声明 | 未声明 | 注册销售市场国家代码。 |
| `min_return_1y` | `number` | 否 | 未声明 | 未声明 | 一年期最低收益率，按百分数填写，例如 5.0 表示 5%。 |
| `max_fee` | `number` | 否 | 未声明 | 未声明 | 实际管理费率上限，例如 1.5。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "rank_funds",
"params": {}
}
}
```
补充说明：
- 按受控业绩或分类排名字段对基金份额类别排行，可按分类、管理人、币种或销售市场过滤。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.11 `screen_funds` 基金筛选
按分类、管理人、币种、销售市场、收益率和费率筛选基金份额类别。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：screen_funds | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `rank_field` | `string` | 否 | "return_1y" | 枚举："return_1d"；"return_1w"；"return_1m"；"return_3m"；"return_6m"；"return_ytd"；"return_1y"；"return_3y"；"return_5y"；"return_10y"；"rank_1y"；"rank_3y" | 排行字段。 |
| `category` | `string` | 否 | 未声明 | 未声明 | 基金分类代码或名称。 |
| `provider_id` | `string` | 否 | 未声明 | 未声明 | 基金管理公司标识。 |
| `currency` | `string` | 否 | 未声明 | 未声明 | 基金计价币种。 |
| `sales_market` | `string` | 否 | 未声明 | 未声明 | 注册销售市场国家代码。 |
| `min_return_1y` | `number` | 否 | 未声明 | 未声明 | 一年期最低收益率，按百分数填写，例如 5.0 表示 5%。 |
| `max_fee` | `number` | 否 | 未声明 | 未声明 | 实际管理费率上限，例如 1.5。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "screen_funds",
"params": {}
}
}
```
补充说明：
- 按分类、管理人、币种、销售市场、收益率和费率筛选基金份额类别。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.12 `get_fund_holdings` 基金持仓
按基金标识查询最新完整持仓、前十大持仓或指定日期范围的历史持仓。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_fund_holdings | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_id` | `string` | 二选一 | 未声明 | 未声明 | 基金实体标识（例如 FS...）；与 fund_class_id 二选一且只传一个。 |
| `fund_class_id` | `string` | 二选一 | 未声明 | 未声明 | 基金份额类别标识（例如 F0...）；与 fund_id 二选一且只传一个。 |
| `operation` | `string` | 否 | "default" | 枚举："default"；"top"；"history" | 查询内容：default=最新完整持仓，top=前十大持仓，history=历史持仓。 |
| `start_date` | `string` | 条件必填 | 未声明 | 未声明 | 起始日期，格式 YYYY-MM-DD；operation=history 时必填。 必填条件：operation="history"。 |
| `end_date` | `string` | 条件必填 | 未声明 | 未声明 | 结束日期，格式 YYYY-MM-DD；operation=history 时必填。 必填条件：operation="history"。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_fund_holdings",
"params": {
"fund_id": ""
}
}
}
```
补充说明：
- 按基金标识查询最新完整持仓、前十大持仓或指定日期范围的历史持仓。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.13 `get_fund_exposure` 基金资产配置
按基金标识查询最新资产、行业或国家地区配置；使用 operation 选择口径。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_fund_exposure | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_id` | `string` | 二选一 | 未声明 | 未声明 | 基金实体标识（例如 FS...）；与 fund_class_id 二选一且只传一个。 |
| `fund_class_id` | `string` | 二选一 | 未声明 | 未声明 | 基金份额类别标识（例如 F0...）；与 fund_id 二选一且只传一个。 |
| `operation` | `string` | 否 | "asset" | 枚举："asset"；"sector"；"country" | 配置类型：asset=资产配置，sector=行业配置，country=国家地区配置。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_fund_exposure",
"params": {
"fund_id": ""
}
}
}
```
补充说明：
- 按基金标识查询最新资产、行业或国家地区配置；使用 operation 选择口径。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.14 `get_fund_benchmark` 基金业绩基准
按基金标识查询关联的业绩比较基准。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_fund_benchmark | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_id` | `string` | 二选一 | 未声明 | 未声明 | 基金实体标识（例如 FS...）；与 fund_class_id 二选一且只传一个。 |
| `fund_class_id` | `string` | 二选一 | 未声明 | 未声明 | 基金份额类别标识（例如 F0...）；与 fund_id 二选一且只传一个。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_fund_benchmark",
"params": {
"fund_id": ""
}
}
}
```
补充说明：
- 按基金标识查询关联的业绩比较基准。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.15 `get_fund_sales_markets` 基金销售市场
按基金标识查询份额类别获准销售的国家或市场。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_fund_sales_markets | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `fund_id` | `string` | 二选一 | 未声明 | 未声明 | 基金实体标识（例如 FS...）；与 fund_class_id 二选一且只传一个。 |
| `fund_class_id` | `string` | 二选一 | 未声明 | 未声明 | 基金份额类别标识（例如 F0...）；与 fund_id 二选一且只传一个。 |
| `page` | `integer` | 否 | 0 | 最小值：0 | 页码，从 0 开始。 |
| `page_size` | `integer` | 否 | 50 | 最小值：1；最大值：200 | 每页记录数。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_fund_sales_markets",
"params": {
"fund_id": ""
}
}
}
```
补充说明：
- 按基金标识查询份额类别获准销售的国家或市场。 已知 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要重复调用 search_funds；只有名称、Ticker、ISIN、CUSIP 或 SEDOL 时才先搜索。
- fund_id 与 fund_class_id 的接口通常要求二选一；先用 search_funds 获取稳定标识。
- 分页使用 page（从 0 开始）和 page_size（最大 200）。
- 基金数据按全球基金实体或份额类别标识查询，不按证券交易市场组合。
- 已经取得 fund_id 或 fund_class_id 时直接调用目标 endpoint，不要再次搜索。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
#### 5.17.16 `get_country_code` 国家地区代码解析
将中文或英文国家地区名称、ISO2、ISO3 或常用别名解析为规范国家代码。
调用工具集：`fund_data`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_country_code | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `countryName` | `string` | 是 | 未声明 | 未声明 | 国家或地区中文名、英文名、ISO2、ISO3 或常用别名，例如 美国、United States、US、USA；最长 128 个字符。 |
请求示例与补充说明
```json
{
"name": "fund_data",
"arguments": {
"endpoint": "get_country_code",
"params": {
"countryName": "美国"
}
}
}
```
补充说明：
- 直接传必填字符串 countryName；返回规范的 ISO2、ISO3、中英文名称。 用于给 sales_market 等国家字段取规范值，不需要先搜索基金，也不使用 market、symbol、fund_id 或 fund_class_id。
- 可输入美国、United States、US、USA 等名称、代码或受支持别名。
- 国家代码解析是基金工具集中的辅助能力，不要求基金标识。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fund_data) · [返回入参目录](#parameters)
### 5.18 互联互通工具集 `stock_connect`
港股通、沪深港通余额、净流入、排行与持股比例。
[get_stock_connect_data](#endpoint-get_stock_connect_data) · [get_hk_stock_connect_data](#endpoint-get_hk_stock_connect_data) · [get_cn_stock_connect_data](#endpoint-get_cn_stock_connect_data)
#### 5.18.1 `get_stock_connect_data` 沪深港通综合数据
查询沪深港通综合数据。
调用工具集：`stock_connect`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_stock_connect_data | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"CN" | 市场代码：HK（港股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 证券代码；cumulative_net_turnover_in、quote_info、shareholding_ratio 必填。 必填条件：market="HK"，connectType="cumulative_net_turnover_in"；或 market="HK"，connectType="shareholding_ratio"；或 market="CN"，connectType="quote_info"；或 market="CN"，connectType="shareholding_ratio"；或 connectType="cumulative_net_turnover_in"；或 connectType="quote_info"；或 connectType="shareholding_ratio"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `connectType` | `string` | 是 | 未声明 | 枚举："minute_flow"；"balance"；"cumulative_net_turnover_in"；"cumulative_net_flow"；"index_quote"；"net_turnover"；"rank_change_rate"；"rank_net_turnover_in"；"rank_shareholdings"；"rank_traded"；"shareholding_ratio"；"turnover_flow"；"quote_info" | connectType 取值：balance=额度余额，net_turnover=净买入，shareholding_ratio=持股比例，rank_change_rate=涨跌幅排行，minute_flow，cumulative_net_turnover_in，cumulative_net_flow，index_quote，rank_net_turnover_in，rank_shareholdings，rank_traded，turnover_flow，quote_info。 适用范围：minute_flow 仅适用于 market=HK；cumulative_net_turnover_in 仅适用于 market=HK；index_quote 仅适用于 market=HK；rank_traded 仅适用于 market=HK；turnover_flow 仅适用于 market=HK；quote_info 仅适用于 market=CN。 |
| `marketBoard` | `string` | 条件必填 | 未声明 | 枚举："ALL"；"SH"；"SZ" | 沪深板块：ALL=全部，SH=沪，SZ=深。 省略时按 ALL 查询；cumulative_net_flow 只支持 SH/SZ，必须显式指定。 注意这与顶层 market 不是一回事——market 选的是港股通还是沪深股通，marketBoard 选的是沪深两地哪个板块。 必填条件：connectType="cumulative_net_flow"。 |
| `date` | `string` | 否 | 未声明 | 未声明 | 查询日期，未传时对需要日期的类型按当前日期查询。 |
| `direction` | `string` | 条件必填 | 未声明 | 枚举："NB"；"SB" | 资金流向：NB=北向，SB=南向；minute_flow、rank_traded、turnover_flow 必填。 必填条件：connectType="minute_flow"；或 connectType="rank_traded"；或 connectType="turnover_flow"。 |
请求示例与补充说明
```json
{
"name": "stock_connect",
"arguments": {
"endpoint": "get_stock_connect_data",
"params": {
"market": "HK",
"connectType": "minute_flow",
"direction": "NB"
}
}
}
```
补充说明：
- connectType 用于选择查询类型。 固定必填参数：connectType。 按所选类型补充条件必填参数：marketBoard、symbol、direction。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，connectType="minute_flow"`
- `market="HK"，connectType="balance"`
- `market="HK"，connectType="cumulative_net_turnover_in"`
- `market="HK"，connectType="cumulative_net_flow"`
- `market="HK"，connectType="index_quote"`
- `market="HK"，connectType="net_turnover"`
- `market="HK"，connectType="rank_change_rate"`
- `market="HK"，connectType="rank_net_turnover_in"`
- `market="HK"，connectType="rank_shareholdings"`
- `market="HK"，connectType="rank_traded"`
- `market="HK"，connectType="shareholding_ratio"`
- `market="HK"，connectType="turnover_flow"`
- `market="CN"，connectType="balance"`
- `market="CN"，connectType="cumulative_net_flow"`
- `market="CN"，connectType="net_turnover"`
- `market="CN"，connectType="quote_info"`
- `market="CN"，connectType="rank_change_rate"`
- `market="CN"，connectType="rank_net_turnover_in"`
- `market="CN"，connectType="rank_shareholdings"`
- `market="CN"，connectType="shareholding_ratio"`
[返回本工具集](#toolset-stock_connect) · [返回入参目录](#parameters)
#### 5.18.2 `get_hk_stock_connect_data` 港股通数据
查询港股通/北向相关数据。
调用工具集：`stock_connect`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_stock_connect_data | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"CN" | 市场代码：HK（港股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 证券代码；cumulative_net_turnover_in、quote_info、shareholding_ratio 必填。 必填条件：market="HK"，connectType="cumulative_net_turnover_in"；或 market="HK"，connectType="shareholding_ratio"；或 connectType="cumulative_net_turnover_in"；或 connectType="quote_info"；或 connectType="shareholding_ratio"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `connectType` | `string` | 是 | 未声明 | 枚举："minute_flow"；"balance"；"cumulative_net_turnover_in"；"cumulative_net_flow"；"index_quote"；"net_turnover"；"rank_change_rate"；"rank_net_turnover_in"；"rank_shareholdings"；"rank_traded"；"shareholding_ratio"；"turnover_flow" | connectType 取值：balance=额度余额，net_turnover=净买入，shareholding_ratio=持股比例，rank_change_rate=涨跌幅排行，minute_flow，cumulative_net_turnover_in，cumulative_net_flow，index_quote，rank_net_turnover_in，rank_shareholdings，rank_traded，turnover_flow。 |
| `marketBoard` | `string` | 条件必填 | 未声明 | 枚举："ALL"；"SH"；"SZ" | 沪深板块：ALL=全部，SH=沪，SZ=深。 省略时按 ALL 查询；cumulative_net_flow 只支持 SH/SZ，必须显式指定。 注意这与顶层 market 不是一回事——market 选的是港股通还是沪深股通，marketBoard 选的是沪深两地哪个板块。 必填条件：connectType="cumulative_net_flow"。 |
| `date` | `string` | 否 | 未声明 | 未声明 | 查询日期，未传时对需要日期的类型按当前日期查询。 |
| `direction` | `string` | 条件必填 | 未声明 | 枚举："NB"；"SB" | 资金流向：NB=北向，SB=南向；minute_flow、rank_traded、turnover_flow 必填。 必填条件：connectType="minute_flow"；或 connectType="rank_traded"；或 connectType="turnover_flow"。 |
请求示例与补充说明
```json
{
"name": "stock_connect",
"arguments": {
"endpoint": "get_hk_stock_connect_data",
"params": {
"market": "HK",
"connectType": "minute_flow",
"direction": "NB"
}
}
}
```
补充说明：
- connectType 用于选择查询类型。 固定必填参数：connectType。 按所选类型补充条件必填参数：marketBoard、symbol、direction。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，connectType="minute_flow"`
- `market="HK"，connectType="balance"`
- `market="HK"，connectType="cumulative_net_turnover_in"`
- `market="HK"，connectType="cumulative_net_flow"`
- `market="HK"，connectType="index_quote"`
- `market="HK"，connectType="net_turnover"`
- `market="HK"，connectType="rank_change_rate"`
- `market="HK"，connectType="rank_net_turnover_in"`
- `market="HK"，connectType="rank_shareholdings"`
- `market="HK"，connectType="rank_traded"`
- `market="HK"，connectType="shareholding_ratio"`
- `market="HK"，connectType="turnover_flow"`
[返回本工具集](#toolset-stock_connect) · [返回入参目录](#parameters)
#### 5.18.3 `get_cn_stock_connect_data` 沪深股通数据
查询 A 股沪深股通/南向相关数据。
调用工具集：`stock_connect`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_cn_stock_connect_data | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"CN" | 市场代码：HK（港股）、CN（A股/沪深市场）。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 证券代码；cumulative_net_turnover_in、quote_info、shareholding_ratio 必填。 必填条件：market="CN"，connectType="quote_info"；或 market="CN"，connectType="shareholding_ratio"；或 connectType="cumulative_net_turnover_in"；或 connectType="quote_info"；或 connectType="shareholding_ratio"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `connectType` | `string` | 是 | 未声明 | 枚举："balance"；"cumulative_net_flow"；"net_turnover"；"quote_info"；"rank_change_rate"；"rank_net_turnover_in"；"rank_shareholdings"；"shareholding_ratio" | connectType 取值：balance=额度余额，net_turnover=净买入，shareholding_ratio=持股比例，rank_change_rate=涨跌幅排行，cumulative_net_flow，quote_info，rank_net_turnover_in，rank_shareholdings。 |
| `marketBoard` | `string` | 条件必填 | 未声明 | 枚举："ALL"；"SH"；"SZ" | 沪深板块：ALL=全部，SH=沪，SZ=深。 省略时按 ALL 查询；cumulative_net_flow 只支持 SH/SZ，必须显式指定。 注意这与顶层 market 不是一回事——market 选的是港股通还是沪深股通，marketBoard 选的是沪深两地哪个板块。 必填条件：connectType="cumulative_net_flow"。 |
| `date` | `string` | 否 | 未声明 | 未声明 | 查询日期，未传时对需要日期的类型按当前日期查询。 |
| `direction` | `string` | 条件必填 | 未声明 | 枚举："NB"；"SB" | 资金流向：NB=北向，SB=南向；minute_flow、rank_traded、turnover_flow 必填。 必填条件：connectType="minute_flow"；或 connectType="rank_traded"；或 connectType="turnover_flow"。 |
请求示例与补充说明
```json
{
"name": "stock_connect",
"arguments": {
"endpoint": "get_cn_stock_connect_data",
"params": {
"market": "CN",
"connectType": "balance"
}
}
}
```
补充说明：
- connectType 用于选择查询类型。 固定必填参数：connectType。 按所选类型补充条件必填参数：marketBoard、symbol、direction。 仅使用 parameters 中声明的业务字段。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="CN"，connectType="balance"`
- `market="CN"，connectType="cumulative_net_flow"`
- `market="CN"，connectType="net_turnover"`
- `market="CN"，connectType="quote_info"`
- `market="CN"，connectType="rank_change_rate"`
- `market="CN"，connectType="rank_net_turnover_in"`
- `market="CN"，connectType="rank_shareholdings"`
- `market="CN"，connectType="shareholding_ratio"`
[返回本工具集](#toolset-stock_connect) · [返回入参目录](#parameters)
### 5.19 新股 IPO 工具集 `ipo`
IPO 日历、新股列表、发行详情、承销商、基石投资者、保证金与公告；公告仅限 IPO/招股/递表场景，不是已上市公司公告搜索。
[get_hk_ipo_calendar](#endpoint-get_hk_ipo_calendar) · [get_hk_ipo_list](#endpoint-get_hk_ipo_list) · [get_hk_ipo_detail](#endpoint-get_hk_ipo_detail) · [get_ipo_profile](#endpoint-get_ipo_profile) · [get_hk_ipo_company_profile](#endpoint-get_hk_ipo_company_profile) · [get_hk_ipo_underwriter](#endpoint-get_hk_ipo_underwriter) · [get_hk_ipo_cornerstone_investor](#endpoint-get_hk_ipo_cornerstone_investor) · [get_hk_ipo_margin_info](#endpoint-get_hk_ipo_margin_info) · [get_hk_ipo_rankings](#endpoint-get_hk_ipo_rankings) · [get_hk_ipo_notice](#endpoint-get_hk_ipo_notice) · [get_us_ipo_list](#endpoint-get_us_ipo_list) · [get_us_ipo_detail](#endpoint-get_us_ipo_detail) · [get_us_ipo_underwriter](#endpoint-get_us_ipo_underwriter) · [get_hk_ipo_subscription_tools](#endpoint-get_hk_ipo_subscription_tools) · [get_hk_ipo_market_data](#endpoint-get_hk_ipo_market_data) · [get_us_ipo_market_data](#endpoint-get_us_ipo_market_data) · [search_ipo_content](#endpoint-search_ipo_content) · [get_ipo_news](#endpoint-get_ipo_news) · [get_ipo_topic](#endpoint-get_ipo_topic) · [get_ipo_course](#endpoint-get_ipo_course) · [get_ipo_tags](#endpoint-get_ipo_tags)
#### 5.19.1 `get_hk_ipo_calendar` 港股新股日历
查询港股 IPO 日历。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ipo_calendar | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | 未声明 | 枚举："calendar"；"calendar_detail" | IPO 数据类型：calendar=IPO日历，calendar_detail。 |
| `startDate` | `string` | 条件必填 | 未声明 | 未声明 | 开始日期，格式 YYYY-MM-DD，例如 2026-07-01。 用于历史区间、财报周期、基金净值、资金流等查询。 必填条件：market="HK"，ipoType="calendar"。 |
| `endDate` | `string` | 条件必填 | 未声明 | 未声明 | 结束日期，格式 YYYY-MM-DD，例如 2026-07-28。 通常和 startDate 搭配使用。 必填条件：market="HK"，ipoType="calendar"。 |
| `date` | `string` | 条件必填 | 未声明 | 未声明 | 查询日期/时间。 默认日期格式为 YYYY-MM-DD；K线分钟级、逐笔、分时等需要精确时刻的场景使用 YYYY-MM-DD HH:mm:ss。 必填条件：market="HK"，ipoType="calendar_detail"。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_hk_ipo_calendar",
"params": {
"market": "HK",
"ipoType": "calendar",
"startDate": "2026-10-09",
"endDate": "2026-10-09"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoType 用于选择查询类型。 固定必填参数：ipoType。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，ipoType="calendar"`
- `market="HK"，ipoType="calendar_detail"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.2 `get_hk_ipo_list` 港股新股列表
查询港股新股列表、今日打新、待上市、已上市、递表数据。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ipo_list | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | 未声明 | 枚举："make_new"；"today"；"to_be_listed"；"listed"；"table"；"table_detail" | IPO 数据类型：listed=已上市，make_new，today，to_be_listed，table，table_detail。 |
| `name` | `string` | 条件必填 | 未声明 | 未声明 | 递表公司名称；ipoType=table_detail 时必填。 必填条件：ipoType="table_detail"。 |
| `status` | `integer` | 条件必填 | 未声明 | 枚举：0；1；2；3；4；5；6；7；8 | 递表市场状态；ipoType=table 时必填。 0=未开盘，1=盘前竞价，2=等待开盘，3=交易中，4=午间休市，5=收盘竞价，6=已收盘，7=休市中，8=盘后交易。 必填条件：ipoType="table"。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_hk_ipo_list",
"params": {
"market": "HK",
"ipoType": "make_new"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoType 用于选择查询类型。 固定必填参数：ipoType。 按所选类型补充条件必填参数：name、status。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，ipoType="make_new"`
- `market="HK"，ipoType="today"`
- `market="HK"，ipoType="to_be_listed"`
- `market="HK"，ipoType="listed"`
- `market="HK"，ipoType="table"`
- `market="HK"，ipoType="table_detail"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.3 `get_hk_ipo_detail` 港股招股详情与配售结果
查询港股 IPO 招股详情和配售结果。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ipo_detail | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | 未声明 | 枚举："offering"；"public_offering"；"company_info"；"allocation_top"；"allocation_bottom" | IPO 数据类型：offering=招股详情，public_offering，company_info，allocation_top，allocation_bottom。 |
| `code` | `string` | 是 | 未声明 | 未声明 | 港股 IPO 股票 ID 或新股代码；详情类接口请传 code，不使用 symbol。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_hk_ipo_detail",
"params": {
"market": "HK",
"ipoType": "offering",
"code": "<新股列表返回的code>"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoType 用于选择查询类型。 固定必填参数：ipoType、code。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，ipoType="offering"`
- `market="HK"，ipoType="public_offering"`
- `market="HK"，ipoType="company_info"`
- `market="HK"，ipoType="allocation_top"`
- `market="HK"，ipoType="allocation_bottom"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.4 `get_ipo_profile` 港股新股综合资料
查询港股 IPO 个股资料，合并招股详情和公司概况。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_ipo_profile | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | "profile" | 枚举："profile" | IPO 数据类型：profile。 |
| `code` | `string` | 是 | 未声明 | 未声明 | 港股 IPO 股票 ID 或新股代码。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_ipo_profile",
"params": {
"market": "HK",
"ipoType": "profile",
"code": "<新股列表返回的code>"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 公司资料工具返回结构化 F10 信息，不提供新闻、公告或研报检索。 ipoType 用于选择查询类型。 固定必填参数：code。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 公司资料工具返回结构化 F10 信息，不提供新闻、公告或研报检索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，ipoType="profile"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.5 `get_hk_ipo_company_profile` 港股新股公司概况
查询港股 IPO 公司概况。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ipo_company_profile | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | 未声明 | 枚举："company_profile"；"company_profile_new" | IPO 数据类型：company_profile、company_profile_new。 |
| `code` | `string` | 是 | 未声明 | 未声明 | 港股 IPO 股票 ID 或新股代码；公司概况接口请传 code，不使用 symbol。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_hk_ipo_company_profile",
"params": {
"market": "HK",
"ipoType": "company_profile",
"code": "<新股列表返回的code>"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 公司资料工具返回结构化 F10 信息，不提供新闻、公告或研报检索。 ipoType 用于选择查询类型。 固定必填参数：ipoType、code。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 公司资料工具返回结构化 F10 信息，不提供新闻、公告或研报检索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，ipoType="company_profile"`
- `market="HK"，ipoType="company_profile_new"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.6 `get_hk_ipo_underwriter` 港股新股承销商与保荐人
查询港股 IPO 承销商和保荐人。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ipo_underwriter | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | 未声明 | 枚举："underwriter_list"；"sponsor_list" | IPO 数据类型：underwriter_list、sponsor_list。 |
| `sponsor` | `string` | 条件必填 | 未声明 | 未声明 | 保荐人名称；ipoType=sponsor_list 时必填。 必填条件：ipoType="sponsor_list"。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_hk_ipo_underwriter",
"params": {
"market": "HK",
"ipoType": "underwriter_list"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoType 用于选择查询类型。 固定必填参数：ipoType。 按所选类型补充条件必填参数：sponsor。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，ipoType="underwriter_list"`
- `market="HK"，ipoType="sponsor_list"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.7 `get_hk_ipo_cornerstone_investor` 港股新股基石投资者
查询港股 IPO 基石投资者。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ipo_cornerstone_investor | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | 未声明 | 枚举："cornerstone_list" | IPO 数据类型：cornerstone_list。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_hk_ipo_cornerstone_investor",
"params": {
"market": "HK",
"ipoType": "cornerstone_list"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoType 用于选择查询类型。 固定必填参数：ipoType。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，ipoType="cornerstone_list"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.8 `get_hk_ipo_margin_info` 港股新股认购与孖展
查询港股 IPO 认购倍数、认购金额和保证金信息。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ipo_margin_info | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | 未声明 | 枚举："margin"；"margin_step"；"broker_info"；"multiple" | IPO 数据类型：margin=保证金，margin_step，broker_info，multiple。 |
| `code` | `string` | 条件必填 | 未声明 | 未声明 | 港股 IPO 股票 ID 或新股代码；margin、margin_step、broker_info 必填，详情类接口请传 code，不使用 symbol。 必填条件：ipoType="margin"；或 ipoType="margin_step"；或 ipoType="broker_info"。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_hk_ipo_margin_info",
"params": {
"market": "HK",
"ipoType": "margin",
"code": "<新股列表返回的code>"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoType 用于选择查询类型。 固定必填参数：ipoType。 按所选类型补充条件必填参数：code。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，ipoType="margin"`
- `market="HK"，ipoType="margin_step"`
- `market="HK"，ipoType="broker_info"`
- `market="HK"，ipoType="multiple"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.9 `get_hk_ipo_rankings` 港股新股排行
查询港股 IPO 热门认购、首日回报、保荐人、承销商、基石投资者等排行榜。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ipo_rankings | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `rankType` | `string` | 是 | 未声明 | 枚举："popular"；"first_day_return"；"sponsor"；"underwriter"；"cornerstone" | 排行类型：popular=热门认购，first_day_return=首日回报，sponsor=保荐人排行，underwriter=承销商排行，cornerstone=基石投资者排行。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_hk_ipo_rankings",
"params": {
"market": "HK",
"rankType": "popular"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 rankType 用于选择查询类型。 固定必填参数：rankType。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，rankType="popular"`
- `market="HK"，rankType="first_day_return"`
- `market="HK"，rankType="sponsor"`
- `market="HK"，rankType="underwriter"`
- `market="HK"，rankType="cornerstone"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.10 `get_hk_ipo_notice` 港股招股与递表公告
查询或下载港股 IPO 招股书公告、递表公告；仅限港股 IPO 场景，不是已上市公司公告搜索。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ipo_notice | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | 未声明 | 枚举："prospectus"；"table_notice" | IPO 数据类型：prospectus=招股书公告，table_notice。 |
| `code` | `string` | 是 | 未声明 | 未声明 | 港股 IPO 股票 ID 或新股代码；公告详情类接口请传 code，不使用 symbol。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_hk_ipo_notice",
"params": {
"market": "HK",
"ipoType": "prospectus",
"code": "<新股列表返回的code>"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoType 用于选择查询类型。 固定必填参数：ipoType、code。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，ipoType="prospectus"`
- `market="HK"，ipoType="table_notice"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.11 `get_us_ipo_list` 美股新股列表
查询美股新股待上市、已上市、新股走势和 PE TTM 列表。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_us_ipo_list | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "US" | 枚举："US" | 市场代码，固定为 US（美股）；可省略，默认 US。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | 未声明 | 枚举："to_be_listed"；"listed"；"trend"；"pe_ttm" | IPO 数据类型：listed=已上市，to_be_listed，trend，pe_ttm。 |
| `dateType` | `string` | 条件必填 | 未声明 | 枚举："30"；"90"；"180"；"365" | 美股 IPO 时间范围，单位为天；取值必须是 30、90、180、365。 必填条件：ipoType="trend"；或 ipoType="pe_ttm"。 |
| `date` | `string` | 条件必填 | 未声明 | 未声明 | 查询日期/时间。 默认日期格式为 YYYY-MM-DD；K线分钟级、逐笔、分时等需要精确时刻的场景使用 YYYY-MM-DD HH:mm:ss。 必填条件：market="US"，ipoType="to_be_listed"；或 market="US"，ipoType="listed"。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_us_ipo_list",
"params": {
"market": "US",
"ipoType": "to_be_listed",
"date": "2026-10-09"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoType 用于选择查询类型。 固定必填参数：ipoType。 按所选类型补充条件必填参数：dateType。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="US"，ipoType="to_be_listed"`
- `market="US"，ipoType="listed"`
- `market="US"，ipoType="trend"`
- `market="US"，ipoType="pe_ttm"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.12 `get_us_ipo_detail` 美股新股详情
查询美股 IPO 新股详情。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_us_ipo_detail | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "US" | 枚举："US" | 市场代码，固定为 US（美股）；可省略，默认 US。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：market="US"，ipoType="stock_details"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | 未声明 | 枚举："stock_details" | IPO 数据类型：stock_details。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_us_ipo_detail",
"params": {
"market": "US",
"ipoType": "stock_details",
"symbol": "AAPL.us"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoType 用于选择查询类型。 固定必填参数：ipoType。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="US"，ipoType="stock_details"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.13 `get_us_ipo_underwriter` 美股新股承销商
查询美股 IPO 承销商表现和承销商详情。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_us_ipo_underwriter | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "US" | 枚举："US" | 市场代码，固定为 US（美股）；可省略，默认 US。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoType` | `string` | 是 | 未声明 | 枚举："underwriter_performance"；"underwriter_detail" | IPO 数据类型：underwriter_performance、underwriter_detail。 |
| `dateType` | `string` | 是 | 未声明 | 枚举："30"；"90"；"180"；"365" | 美股 IPO 时间范围，单位为天；取值必须是 30、90、180、365。 |
| `underwriterName` | `object\|string` | 否 | 未声明 | 未声明 | 承销商英文名称筛选。 ipoType=underwriter_performance 时必须传 object 类型；ipoType=underwriter_detail 时传 string 类型。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_us_ipo_underwriter",
"params": {
"market": "US",
"ipoType": "underwriter_performance",
"dateType": "30"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoType 用于选择查询类型。 固定必填参数：ipoType、dateType。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="US"，ipoType="underwriter_performance"`
- `market="US"，ipoType="underwriter_detail"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.14 `get_hk_ipo_subscription_tools` 港股打新辅助工具
查询港股 IPO 打新计算、认购数量、券商、认购方式和中签手数等辅助数据。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ipo_subscription_tools | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoUtilityType` | `string` | 是 | 未声明 | 枚举："compute"；"h5_compute"；"amount_list"；"broker_list"；"lot"；"new_stock_list"；"subscription_list"；"subscription_dates" | ipoUtilityType 取值：compute=打新计算，h5_compute=H5打新计算，amount_list=认购数量，broker_list=券商列表，lot=中签手数，new_stock_list=新股列表，subscription_list=认购方式，subscription_dates=认购开始结束日期。 |
| `code` | `string` | 条件必填 | 未声明 | 未声明 | 新股代码，string 类型；compute、h5_compute、amount_list、broker_list、lot 必填。 必填条件：ipoUtilityType="compute"；或 ipoUtilityType="h5_compute"；或 ipoUtilityType="amount_list"；或 ipoUtilityType="broker_list"；或 ipoUtilityType="lot"。 |
| `brokerId` | `integer\|string` | 条件必填 | 未声明 | 未声明 | 券商 ID。 compute/new_stock_list 要求整数。 必填条件：ipoUtilityType="compute"；或 ipoUtilityType="new_stock_list"；或 ipoUtilityType="subscription_list"。 |
| `mode` | `integer` | 条件必填 | 未声明 | 枚举：1；2 | 认购方式；compute 必填：1=现金认购，2=银行融资认购。 必填条件：ipoUtilityType="compute"。 |
| `quantity` | `integer` | 条件必填 | 未声明 | 未声明 | 认购数量、申购手数，integer 类型；compute、h5_compute 必填。 必填条件：ipoUtilityType="compute"；或 ipoUtilityType="h5_compute"。 |
| `lot` | `integer` | 条件必填 | 未声明 | 未声明 | 中签手数，integer 类型，不能大于 quantity；compute、h5_compute 必填。 必填条件：ipoUtilityType="compute"；或 ipoUtilityType="h5_compute"。 |
| `financingLeverage` | `integer` | 条件必填 | 未声明 | 未声明 | 杠杆倍数，integer 类型，范围 1-50；h5_compute 必填。 必填条件：ipoUtilityType="h5_compute"。 |
| `financingRate` | `number` | 条件必填 | 未声明 | 未声明 | 融资利率，number 类型，范围 0-10，支持两位小数；h5_compute 必填。 必填条件：ipoUtilityType="h5_compute"。 |
| `flag` | `string` | 条件必填 | 未声明 | 未声明 | 日期范围标记；subscription_dates 必填，例如 before、this、after。 必填条件：ipoUtilityType="subscription_dates"。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_hk_ipo_subscription_tools",
"params": {
"market": "HK",
"ipoUtilityType": "compute",
"code": "<新股列表返回的code>",
"brokerId": "<券商列表返回的brokerId>",
"mode": 1,
"quantity": 1,
"lot": 1
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 打新计算接口 compute、h5_compute 目前仅支持查询 2020-2021 年上市的股票；其他上市年份可能无法计算出结果。 已确认 h5_compute 在字段和类型满足要求后仍可能返回“打新计算失败”，需服务方确认融资利率/杠杆的隐含业务校验或后端实现。 ipoUtilityType 用于选择查询类型。 固定必填参数：ipoUtilityType。 按所选类型补充条件必填参数：code、brokerId、mode、quantity、lot、financingLeverage、financingRate、flag。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 已确认 h5_compute 在字段和类型满足要求后仍可能返回“打新计算失败”，需服务方确认融资利率/杠杆的隐含业务校验或后端实现。
- 打新计算接口 compute、h5_compute 目前仅支持查询 2020-2021 年上市的股票；其他上市年份可能无法计算出结果。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，ipoUtilityType="compute"`
- `market="HK"，ipoUtilityType="h5_compute"`
- `market="HK"，ipoUtilityType="amount_list"`
- `market="HK"，ipoUtilityType="broker_list"`
- `market="HK"，ipoUtilityType="lot"`
- `market="HK"，ipoUtilityType="new_stock_list"`
- `market="HK"，ipoUtilityType="subscription_list"`
- `market="HK"，ipoUtilityType="subscription_dates"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.15 `get_hk_ipo_market_data` 港股新股市场统计
查询港股 IPO 市场概况、行业统计和行业表现。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_hk_ipo_market_data | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoMarketType` | `string` | 是 | 未声明 | 枚举："market_info"；"industry_info"；"industry_performance"；"industry_name" | IPO 市场数据类型：market_info=市场概况，industry_info=行业统计，industry_performance=行业表现，industry_name=按行业代码查询行业名称。 |
| `code` | `string` | 条件必填 | 未声明 | 未声明 | 行业代码或行业 ID；ipoMarketType=industry_name 时必填。 必填条件：ipoMarketType="industry_name"。 |
| `date` | `string` | 否 | 未声明 | 未声明 | 查询日期，格式 YYYY-MM-DD； |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_hk_ipo_market_data",
"params": {
"market": "HK",
"ipoMarketType": "market_info"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoMarketType 用于选择查询类型。 固定必填参数：ipoMarketType。 按所选类型补充条件必填参数：code。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，ipoMarketType="market_info"`
- `market="HK"，ipoMarketType="industry_info"`
- `market="HK"，ipoMarketType="industry_performance"`
- `market="HK"，ipoMarketType="industry_name"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.16 `get_us_ipo_market_data` 美股新股市场统计
查询美股 IPO 市场概况和行业表现。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_us_ipo_market_data | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "US" | 枚举："US" | 市场代码，固定为 US（美股）；可省略，默认 US。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `ipoMarketType` | `string` | 是 | 未声明 | 枚举："us_market_info"；"us_industry_performance" | IPO 市场数据类型：us_market_info=美股 IPO 市场概况，us_industry_performance=美股 IPO 行业表现。 |
| `code` | `string` | 条件必填 | 未声明 | 未声明 | 行业代码或行业 ID；ipoMarketType=industry_name 时必填。 必填条件：ipoMarketType="industry_name"。 |
| `date` | `string` | 否 | 未声明 | 未声明 | 查询日期，格式 YYYY-MM-DD； |
| `dateType` | `string` | 条件必填 | 未声明 | 枚举："30"；"90"；"180"；"365" | 美股 IPO 时间范围，单位为天；取值必须是 30、90、180、365。 必填条件：ipoMarketType="us_market_info"。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_us_ipo_market_data",
"params": {
"market": "US",
"ipoMarketType": "us_market_info",
"dateType": "30"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 ipoMarketType 用于选择查询类型。 固定必填参数：ipoMarketType。 按所选类型补充条件必填参数：code、dateType。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="US"，ipoMarketType="us_market_info"`
- `market="US"，ipoMarketType="us_industry_performance"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.17 `search_ipo_content` 新股内容搜索
搜索新股资讯或内容。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：search_ipo_content | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `contentType` | `string` | 是 | 未声明 | 枚举："async_search"；"search" | 内容类型：async_search=异步搜索，search=搜索资讯。 |
| `match` | `string` | 条件必填 | 未声明 | 未声明 | 关键词匹配，搜索资讯标题包含 match 字段值的资讯，string 类型。 new_stock_info 组合必须传入关键词，否则会返回空列表。 必填条件：contentType="new_stock_info"。 |
| `id` | `integer` | 条件必填 | 未声明 | 未声明 | 资讯 ID，必须为整数；detail、relate、h5_relate 必填。 必填条件：contentType="detail"；或 contentType="relate"；或 contentType="h5_relate"。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "search_ipo_content",
"params": {
"market": "HK",
"contentType": "async_search",
"match": "新股"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 async_search 只接收 match 字段；此前传 keyword 会导致请求字段不符合 接口。 若仍返回 HTTP 400，需服务方确认实现。 contentType 用于选择查询类型。 固定必填参数：contentType。 按所选类型补充条件必填参数：match、id。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- async_search 只接收 match 字段；此前传 keyword 会导致请求字段不符合 接口。 若仍返回 HTTP 400，需服务方确认实现。
- 返回原始业务字段，适合查询明细数据。
- contentType=async_search 时须提供 match；不能以 keyword 替代。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，contentType="async_search"`
- `market="HK"，contentType="search"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.18 `get_ipo_news` 新股资讯
查询新股资讯列表、详情、热门、排行、推荐和相关资讯；仅限 IPO/新股内容，不是已上市公司通用新闻。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_ipo_news | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `contentType` | `string` | 是 | 未声明 | 枚举："new_stock_info"；"list"；"detail"；"hot"；"day_rank"；"week_rank"；"refer"；"relate"；"h5_relate" | 内容类型：new_stock_info=新股相关资讯，list=资讯列表，detail=资讯详情，hot=热门资讯，day_rank=日榜，week_rank=周榜，refer=推荐资讯，relate=PC相关资讯，h5_relate=H5相关资讯。 |
| `match` | `string` | 条件必填 | 未声明 | 未声明 | 关键词匹配，搜索资讯标题包含 match 字段值的资讯，string 类型。 new_stock_info 组合必须传入关键词，否则会返回空列表。 必填条件：contentType="new_stock_info"。 |
| `id` | `integer` | 条件必填 | 未声明 | 未声明 | 资讯 ID，必须为整数；detail、relate、h5_relate 必填。 必填条件：contentType="detail"；或 contentType="relate"；或 contentType="h5_relate"。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_ipo_news",
"params": {
"market": "HK",
"contentType": "new_stock_info",
"match": "新股"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 contentType 用于选择查询类型。 固定必填参数：contentType。 按所选类型补充条件必填参数：match、id。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，contentType="new_stock_info"`
- `market="HK"，contentType="list"`
- `market="HK"，contentType="detail"`
- `market="HK"，contentType="hot"`
- `market="HK"，contentType="day_rank"`
- `market="HK"，contentType="week_rank"`
- `market="HK"，contentType="refer"`
- `market="HK"，contentType="relate"`
- `market="HK"，contentType="h5_relate"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.19 `get_ipo_topic` 新股专题
查询新股专题列表、置顶专题、专题详情和专题关联资讯。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_ipo_topic | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `topicType` | `string` | 是 | 未声明 | 枚举："top"；"list"；"detail"；"info" | topicType 取值：top=置顶专题，list=专题列表，detail=专题详情，info=专题关联资讯。 |
| `id` | `integer` | 条件必填 | 未声明 | 未声明 | 专题 ID，必须为整数；topicType=detail 时必填。 必填条件：topicType="detail"。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_ipo_topic",
"params": {
"market": "HK",
"topicType": "top"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 topicType 用于选择查询类型。 固定必填参数：topicType。 按所选类型补充条件必填参数：id。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，topicType="top"`
- `market="HK"，topicType="list"`
- `market="HK"，topicType="detail"`
- `market="HK"，topicType="info"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.20 `get_ipo_course` 打新课堂
查询打新课堂课程列表、热门、排行、推荐、相关课程和课程详情。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_ipo_course | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `courseType` | `string` | 是 | 未声明 | 枚举："search"；"hot"；"month_rank"；"refer"；"relate"；"h5_relate"；"detail"；"total_rank" | courseType 取值：search=课程列表，hot=热门课程，month_rank=月榜，refer=推荐课程，relate=PC相关课程，h5_relate=H5相关课程，detail=课程详情，total_rank=总榜。 |
| `keyword` | `string` | 否 | 未声明 | 未声明 | 课程搜索关键词。 |
| `id` | `integer` | 条件必填 | 未声明 | 未声明 | 课程 ID，必须为整数；detail、relate、h5_relate 必填。 必填条件：courseType="detail"；或 courseType="relate"；或 courseType="h5_relate"。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_ipo_course",
"params": {
"market": "HK",
"courseType": "search"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 courseType 用于选择查询类型。 固定必填参数：courseType。 按所选类型补充条件必填参数：id。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，courseType="search"`
- `market="HK"，courseType="hot"`
- `market="HK"，courseType="month_rank"`
- `market="HK"，courseType="refer"`
- `market="HK"，courseType="relate"`
- `market="HK"，courseType="h5_relate"`
- `market="HK"，courseType="detail"`
- `market="HK"，courseType="total_rank"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
#### 5.19.21 `get_ipo_tags` 新股内容标签
查询新股内容标签和有数据标签。
调用工具集：`ipo`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_ipo_tags | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | "HK" | 枚举："HK" | 市场代码，固定为 HK（港股）；可省略，默认 HK。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `tagType` | `string` | 是 | 未声明 | 枚举："exist_data"；"list" | tagType 取值：exist_data=获取有数据的标签，list=获取标签列表。 |
| `tagCategory` | `number` | 否 | 10 | 枚举：10；11；20；21 | 标签分类维度：10=港股资讯分类，11=港股资讯来源，20=港股课程分类，21=港股课程来源。 省略时按 10 查询。 |
请求示例与补充说明
```json
{
"name": "ipo",
"arguments": {
"endpoint": "get_ipo_tags",
"params": {
"market": "HK",
"tagType": "exist_data"
}
}
}
```
补充说明：
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。 tagType 用于选择查询类型。 固定必填参数：tagType。 仅使用 parameters 中声明的业务字段。
- IPO/新股公告和资讯仅限发行、招股、递表或新股内容场景，不等同于已上市公司公告、新闻或研报搜索。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"，tagType="exist_data"`
- `market="HK"，tagType="list"`
[返回本工具集](#toolset-ipo) · [返回入参目录](#parameters)
### 5.20 债券基础工具集 `bond_basic`
债券搜索、债券资料、债券快照、扩展行情与买卖盘。
[search_bond](#endpoint-search_bond) · [get_bond_profile](#endpoint-get_bond_profile) · [get_bond_quote](#endpoint-get_bond_quote) · [get_bond_orderbook](#endpoint-get_bond_orderbook)
#### 5.20.1 `search_bond` 债券搜索
搜索债券。
调用工具集：`bond_basic`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：search_bond | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | 未声明 | 枚举："GLOBAL" | 市场代码，固定为 GLOBAL（债券）；可省略，默认 GLOBAL。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `bondType` | `string` | 否 | 未声明 | 未声明 | 债券数据类型；本工具只有一种查询类型时可省略。 |
| `keyword` | `string` | 是 | 未声明 | 未声明 | 债券名称、ISIN 或关键词。 |
请求示例与补充说明
```json
{
"name": "bond_basic",
"arguments": {
"endpoint": "search_bond",
"params": {
"keyword": "US91282CHZ77"
}
}
}
```
补充说明：
- 仅使用 parameters 中声明的业务字段。
- 债券能力：market=GLOBAL。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-bond_basic) · [返回入参目录](#parameters)
#### 5.20.2 `get_bond_profile` 债券基础资料
查询债券资料、债券码表、机构债券池。
调用工具集：`bond_basic`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_bond_profile | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | 未声明 | 枚举："GLOBAL" | 市场代码，固定为 GLOBAL（债券）；可省略，默认 GLOBAL。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 条件必填 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； 必填条件：bondType="info"。 |
| `bondType` | `string` | 是 | 未声明 | 枚举："info"；"codes"；"agent_pool" | bondType 取值：info、codes、agent_pool。 |
请求示例与补充说明
```json
{
"name": "bond_basic",
"arguments": {
"endpoint": "get_bond_profile",
"params": {
"bondType": "info",
"symbols": [
"US91282CHZ77"
]
}
}
}
```
补充说明：
- bondType 用于选择查询类型。 固定必填参数：bondType。 仅使用 parameters 中声明的业务字段。
- 债券能力：market=GLOBAL。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `bondType="info"`
- `bondType="codes"`
- `bondType="agent_pool"`
[返回本工具集](#toolset-bond_basic) · [返回入参目录](#parameters)
#### 5.20.3 `get_bond_quote` 债券行情与收益率快照
查询债券快照、扩展行情和收益率快照。
调用工具集：`bond_basic`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_bond_quote | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | 未声明 | 枚举："GLOBAL" | 市场代码，固定为 GLOBAL（债券）；可省略，默认 GLOBAL。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `bondType` | `string` | 是 | 未声明 | 枚举："snapshot"；"extend"；"yield_snapshot" | bondType 取值：snapshot、extend、yield_snapshot。 |
请求示例与补充说明
```json
{
"name": "bond_basic",
"arguments": {
"endpoint": "get_bond_quote",
"params": {
"bondType": "snapshot",
"symbols": [
"US91282CHZ77"
]
}
}
}
```
补充说明：
- bondType 用于选择查询类型。 固定必填参数：bondType。 仅使用 parameters 中声明的业务字段。
- 债券能力：market=GLOBAL。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `bondType="snapshot"`
- `bondType="extend"`
- `bondType="yield_snapshot"`
[返回本工具集](#toolset-bond_basic) · [返回入参目录](#parameters)
#### 5.20.4 `get_bond_orderbook` 债券买卖盘
查询债券买卖盘。
调用工具集：`bond_basic`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_bond_orderbook | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | 未声明 | 枚举："GLOBAL" | 市场代码，固定为 GLOBAL（债券）；可省略，默认 GLOBAL。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `bondType` | `string` | 否 | 未声明 | 未声明 | 债券数据类型；本工具只有一种查询类型时可省略。 |
请求示例与补充说明
```json
{
"name": "bond_basic",
"arguments": {
"endpoint": "get_bond_orderbook",
"params": {
"symbol": "US91282CHZ77"
}
}
}
```
补充说明：
- 仅使用 parameters 中声明的业务字段。
- 债券能力：market=GLOBAL。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-bond_basic) · [返回入参目录](#parameters)
### 5.21 债券分析工具集 `bond_analytics`
债券排行、走势图、收益率和交易状态。
[get_bond_rankings](#endpoint-get_bond_rankings) · [get_bond_chart](#endpoint-get_bond_chart) · [get_bond_yield](#endpoint-get_bond_yield) · [get_bond_trading_status](#endpoint-get_bond_trading_status)
#### 5.21.1 `get_bond_rankings` 债券排行
查询债券排行榜、简易排行榜、债券 ETF 排行榜。
调用工具集：`bond_analytics`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_bond_rankings | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | 未声明 | 枚举："GLOBAL" | 市场代码，固定为 GLOBAL（债券）；可省略，默认 GLOBAL。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `bondType` | `string` | 是 | 未声明 | 枚举："rank"；"rank_simple"；"etf_rank" | bondType 取值：rank、rank_simple、etf_rank。 |
请求示例与补充说明
```json
{
"name": "bond_analytics",
"arguments": {
"endpoint": "get_bond_rankings",
"params": {
"bondType": "rank"
}
}
}
```
补充说明：
- bondType 用于选择查询类型。 固定必填参数：bondType。 仅使用 parameters 中声明的业务字段。
- 债券能力：market=GLOBAL。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `bondType="rank"`
- `bondType="rank_simple"`
- `bondType="etf_rank"`
[返回本工具集](#toolset-bond_analytics) · [返回入参目录](#parameters)
#### 5.21.2 `get_bond_chart` 债券与收益率走势
查询债券历史走势图、分时图、收益率 K 线、收益率分时和国债收益率列表。
调用工具集：`bond_analytics`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_bond_chart | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | 未声明 | 枚举："GLOBAL" | 市场代码，固定为 GLOBAL（债券）；可省略，默认 GLOBAL。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：bondType="history"；或 bondType="trend"；或 bondType="yield_kline"；或 bondType="yield_trend"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `bondType` | `string` | 是 | 未声明 | 枚举："history"；"trend"；"yield_kline"；"yield_trend"；"treasury_yield" | bondType 取值：history、trend、yield_kline、yield_trend、treasury_yield。 |
| `type` | `integer` | 条件必填 | 未声明 | 未声明 | 收益率 K 线类型；yield_kline 组合必填，整数枚举由 接口 定义。 必填条件：bondType="yield_kline"。 |
请求示例与补充说明
```json
{
"name": "bond_analytics",
"arguments": {
"endpoint": "get_bond_chart",
"params": {
"bondType": "history",
"symbol": "US91282CHZ77"
}
}
}
```
补充说明：
- bondType 用于选择查询类型。 固定必填参数：bondType。 按所选类型补充条件必填参数：type。 仅使用 parameters 中声明的业务字段。
- 债券能力：market=GLOBAL。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `bondType="history"`
- `bondType="trend"`
- `bondType="yield_kline"`
- `bondType="yield_trend"`
- `bondType="treasury_yield"`
[返回本工具集](#toolset-bond_analytics) · [返回入参目录](#parameters)
#### 5.21.3 `get_bond_yield` 债券收益率数据
查询债券收益率码表、收益率快照、收益率 K 线和收益率分时。
调用工具集：`bond_analytics`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_bond_yield | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | 未声明 | 枚举："GLOBAL" | 市场代码，固定为 GLOBAL（债券）；可省略，默认 GLOBAL。 |
| `symbol` | `string` | 条件必填 | 未声明 | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 必填条件：bondType="kline"；或 bondType="trend"。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `bondType` | `string` | 是 | 未声明 | 枚举："codes"；"snapshot"；"kline"；"trend" | bondType 取值：codes、snapshot、kline、trend。 |
| `type` | `integer` | 条件必填 | 未声明 | 未声明 | 收益率 K 线类型；kline 组合必填，整数枚举由 接口 定义。 必填条件：bondType="kline"。 |
请求示例与补充说明
```json
{
"name": "bond_analytics",
"arguments": {
"endpoint": "get_bond_yield",
"params": {
"bondType": "codes"
}
}
}
```
补充说明：
- bondType 用于选择查询类型。 固定必填参数：bondType。 按所选类型补充条件必填参数：type。 仅使用 parameters 中声明的业务字段。
- 债券能力：market=GLOBAL。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `bondType="codes"`
- `bondType="snapshot"`
- `bondType="kline"`
- `bondType="trend"`
[返回本工具集](#toolset-bond_analytics) · [返回入参目录](#parameters)
#### 5.21.4 `get_bond_trading_status` 债券市场交易状态
查询债券市场和债券收益率市场交易状态。
调用工具集：`bond_analytics`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_bond_trading_status | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 否 | 未声明 | 枚举："GLOBAL" | 市场代码，固定为 GLOBAL（债券）；可省略，默认 GLOBAL。 |
| `symbol` | `string` | 否 | "US91282CHZ77" | 未声明 | 单个证券、基金、债券、期权或 IPO 代码。 |
| `symbols` | `string[]` | 否 | 未声明 | 未声明 | 批量代码列表，例如 ["00700.hk", "AAPL.us"]； |
| `bondType` | `string` | 是 | 未声明 | 枚举："bond"；"yield" | bondType 取值：bond、yield。 |
请求示例与补充说明
```json
{
"name": "bond_analytics",
"arguments": {
"endpoint": "get_bond_trading_status",
"params": {
"bondType": "bond"
}
}
}
```
补充说明：
- bondType 用于选择查询类型。 固定必填参数：bondType。 仅使用 parameters 中声明的业务字段。
- 债券能力：market=GLOBAL。
- 返回原始业务字段，适合查询明细数据。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `bondType="bond"`
- `bondType="yield"`
[返回本工具集](#toolset-bond_analytics) · [返回入参目录](#parameters)
### 5.22 FIU 新闻资讯工具集 `fiu_news`
新闻搜索、个股相关新闻、最新新闻、新闻详情、相关新闻和摘要素材。
[news_search](#endpoint-news_search) · [news_by_symbol](#endpoint-news_by_symbol) · [news_latest](#endpoint-news_latest) · [news_get](#endpoint-news_get) · [news_related](#endpoint-news_related) · [news_digest](#endpoint-news_digest)
#### 5.22.1 `news_search` 新闻搜索
搜索新闻列表。
调用工具集：`fiu_news`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：news_search | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `query` | `string` | 是 | 未声明 | 未声明 | 语义检索文本；适合自然语言意图查询，会转换为 embedding 后按语义相似度搜索。 |
| `from` | `string` | 否 | 未声明 | 未声明 | 开始日期，格式 YYYY-MM-DD；默认最近 30 天。 |
| `to` | `string` | 否 | 未声明 | 未声明 | 结束日期，格式 YYYY-MM-DD；默认今天。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 股票/标的代码，不带交易所后缀；例如 000957.SZ 传 000957。 |
| `limit` | `integer` | 否 | 10 | 最小值：1；最大值：50 | 返回条数。 |
请求示例与补充说明
```json
{
"name": "fiu_news",
"arguments": {
"endpoint": "news_search",
"params": {
"query": "人工智能芯片行业动态"
}
}
}
```
补充说明：
- symbol 可使用带或不带常见交易所后缀的证券代码。
- 仅使用 parameters 中列出的业务字段；symbol 可传 000957 或 000957.SZ，常见市场后缀会被自动规范化。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fiu_news) · [返回入参目录](#parameters)
#### 5.22.2 `news_by_symbol` 个股相关新闻
按证券代码查询相关新闻；默认按相关性排序，也可按发布时间排序或仅返回主体相关内容。
调用工具集：`fiu_news`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：news_by_symbol | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 股票/标的代码；例如 NVDA。 |
| `days` | `integer` | 否 | 7 | 最小值：1；最大值：90 | 查询最近多少天。 |
| `limit` | `integer` | 否 | 10 | 最小值：1；最大值：50 | 返回条数。 |
| `sortBy` | `string` | 否 | "relevance" | 枚举："relevance"；"time" | 排序方式：relevance=相关性优先，time=发布时间倒序。 |
| `relevanceMode` | `string` | 否 | "related" | 枚举："related"；"primary" | 相关性范围：related=保留全部关联新闻并重排，primary=仅返回主体相关或直接提及的新闻。 |
请求示例与补充说明
```json
{
"name": "fiu_news",
"arguments": {
"endpoint": "news_by_symbol",
"params": {
"symbol": "NVDA"
}
}
}
```
补充说明：
- symbol 可使用带或不带常见交易所后缀的证券代码。
- sortBy=relevance 时，items 中可返回 relevanceScore、relevanceLevel、relevanceEvidence、rankingVersion；relevanceLevel 取值为 primary、direct_mention、related、market_context。
- 仅使用 parameters 中列出的业务字段；symbol 可传 000957 或 000957.SZ，常见市场后缀会被自动规范化。
- 响应顶层保留 items、message、rankingVersion；primary 模式没有直接相关新闻时 items 为空，并通过 message 说明原因。
- 常用场景：需要公司自身消息时使用 relevanceMode=primary；需要保留大盘综述等弱关联新闻时使用 relevanceMode=related。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fiu_news) · [返回入参目录](#parameters)
#### 5.22.3 `news_latest` 最新新闻
查询最近一段时间内的最新新闻，按创建时间倒序。
调用工具集：`fiu_news`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：news_latest | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `hours` | `integer` | 否 | 24 | 最小值：1；最大值：168 | 查询最近多少小时的新闻。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 股票/标的代码，不带交易所后缀；例如 000957.SZ 传 000957。 |
| `limit` | `integer` | 否 | 10 | 最小值：1；最大值：50 | 返回条数。 |
请求示例与补充说明
```json
{
"name": "fiu_news",
"arguments": {
"endpoint": "news_latest",
"params": {}
}
}
```
补充说明：
- symbol 可使用带或不带常见交易所后缀的证券代码。
- 仅使用 parameters 中列出的业务字段；symbol 可传 000957 或 000957.SZ，常见市场后缀会被自动规范化。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fiu_news) · [返回入参目录](#parameters)
#### 5.22.4 `news_get` 新闻详情
按新闻 ID 查询单篇新闻详情。
调用工具集：`fiu_news`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：news_get | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `id` | `string` | 是 | 未声明 | 未声明 | 新闻 ID，对应新闻列表返回的 id 字段。 |
| `include_content` | `boolean` | 否 | true | 未声明 | 是否返回正文 content。 |
请求示例与补充说明
```json
{
"name": "fiu_news",
"arguments": {
"endpoint": "news_get",
"params": {
"id": "<新闻列表返回的id>"
}
}
}
```
补充说明：
- symbol 可使用带或不带常见交易所后缀的证券代码。
- 仅使用 parameters 中列出的业务字段；symbol 可传 000957 或 000957.SZ，常见市场后缀会被自动规范化。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fiu_news) · [返回入参目录](#parameters)
#### 5.22.5 `news_related` 相关新闻
按新闻 ID 查询相关新闻。
调用工具集：`fiu_news`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：news_related | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `id` | `string` | 是 | 未声明 | 未声明 | 新闻 ID，对应新闻列表返回的 id 字段。 |
| `limit` | `integer` | 否 | 10 | 最小值：1；最大值：50 | 返回条数。 |
请求示例与补充说明
```json
{
"name": "fiu_news",
"arguments": {
"endpoint": "news_related",
"params": {
"id": "<新闻列表返回的id>"
}
}
}
```
补充说明：
- symbol 可使用带或不带常见交易所后缀的证券代码。
- 仅使用 parameters 中列出的业务字段；symbol 可传 000957 或 000957.SZ，常见市场后缀会被自动规范化。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fiu_news) · [返回入参目录](#parameters)
#### 5.22.6 `news_digest` 新闻摘要素材
查询适合 AI 摘要的新闻素材，返回 content_preview 而不是完整正文。
调用工具集：`fiu_news`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：news_digest | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 股票/标的代码，不带交易所后缀；例如 000957.SZ 传 000957。 |
| `days` | `integer` | 否 | 7 | 最小值：1；最大值：30 | 查询最近多少天。 |
| `limit` | `integer` | 否 | 10 | 最小值：1；最大值：20 | 返回条数。 |
请求示例与补充说明
```json
{
"name": "fiu_news",
"arguments": {
"endpoint": "news_digest",
"params": {}
}
}
```
补充说明：
- symbol 可使用带或不带常见交易所后缀的证券代码。
- 仅使用 parameters 中列出的业务字段；symbol 可传 000957 或 000957.SZ，常见市场后缀会被自动规范化。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-fiu_news) · [返回入参目录](#parameters)
### 5.23 财经日历工具集 `financial_calendar`
按标题关键词、日期和事件类型查询全球财经日历，并获取事件详情。
[search_financial_calendar](#endpoint-search_financial_calendar) · [get_financial_event_detail](#endpoint-get_financial_event_detail)
#### 5.23.1 `search_financial_calendar` 财经日历搜索
按标题关键词模糊搜索财经日历，并可按日期、国家、市场、事件类型和重要等级筛选。
调用工具集：`financial_calendar`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：search_financial_calendar | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `date` | `string` | 是 | 未声明 | 未声明 | 查询开始日期，格式 YYYY-MM-DD。 |
| `keyword` | `string` | 是 | 未声明 | 最短长度：1 | 财经日历标题模糊搜索关键词，必须是非空字符串。 |
| `endDate` | `string` | 否 | 未声明 | 未声明 | 可选结束日期，格式 YYYY-MM-DD；传入后 direction 和 limit 不再控制日期窗口。 |
| `direction` | `integer` | 否 | -1 | 枚举：-1；1 | 未传 endDate 时的加载方向：-1=向未来加载，1=向历史加载。 |
| `limit` | `integer` | 否 | 7 | 最小值：1；最大值：35 | 未传 endDate 时返回有数据日期的上限。 |
| `countryTypes` | `string[]` | 否 | 未声明 | 枚举："1"；"2"；"3"；"4"；"5"；"6"；"7"；"8"；"9"；"10"；"11" | 国家类型列表：1中国、2美国、3新加坡、4日本、5韩国、6加拿大、7澳大利亚、8德国、9英国、10法国、11其他。 |
| `eventTypes` | `integer[]` | 否 | 未声明 | 枚举：1；2；3；4 | 事件类型列表：1=经济数据，2=事件，3=权息，4=休市。 |
| `markets` | `string[]` | 否 | 未声明 | 枚举："SG"；"BJ"；"US"；"MY"；"CA"；"HK"；"AU"；"JP"；"SH"；"SZ" | 市场代码列表，例如 ["US", "HK", "SH"]。 |
| `importanceLevels` | `integer[]` | 否 | 未声明 | 枚举：1；2；3 | 重要等级列表：1、2、3 星。 |
请求示例与补充说明
```json
{
"name": "financial_calendar",
"arguments": {
"endpoint": "search_financial_calendar",
"params": {
"keyword": "非农",
"date": "2026-10-09"
}
}
}
```
补充说明：
- keyword 与 date 必填。 查询有明确结束日期时传 endDate；滚动查询时省略 endDate，并使用 direction 与 limit。
- 这是全球事件日历，不使用证券行情的 market 组合；多市场筛选字段名为 markets。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-financial_calendar) · [返回入参目录](#parameters)
#### 5.23.2 `get_financial_event_detail` 财经事件详情
按财经日历事件 ID 查询单条事件详情。
调用工具集：`financial_calendar`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_financial_event_detail | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `id` | `string` | 是 | 未声明 | 未声明 | 财经日历列表返回的事件 ID。 |
请求示例与补充说明
```json
{
"name": "financial_calendar",
"arguments": {
"endpoint": "get_financial_event_detail",
"params": {
"id": "<财经日历返回的id>"
}
}
}
```
补充说明：
- id 必须来自财经日历搜索结果。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-financial_calendar) · [返回入参目录](#parameters)
### 5.24 宏观经济工具集 `macro_economics`
查询精选宏观数据。
[get_macro_overview](#endpoint-get_macro_overview)
#### 5.24.1 `get_macro_overview` 宏观经济数据
精选宏观数据。
调用工具集：`macro_economics`。业务参数位置：`arguments`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_macro_overview | 选择本端点。 |
| `titleId` | `integer` | 是 | 未声明 | 枚举：10；20；30；40；50；60；70；80；90；100；110 | 精选宏观数据标题 ID：10=央行/中国央行资产负债表规模（美元），20=央行/中国货币供应量 M2 同比，30=央行/中国贷款市场报价利率（LPR），40=物价/中国工业生产者出厂价格（PPI），50=就业/中国城镇调查失业率，60=未分类/中国固定资产投资完成额（累计），70=消费/中国社会消费品零售，80=GDP/中国 GDP，90=贸易/中国贸易余额（美元计），100=物价/中国 CPI，110=消费/中国制造业 PMI。 |
请求示例与补充说明
```json
{
"name": "macro_economics",
"arguments": {
"endpoint": "get_macro_overview",
"titleId": 10
}
}
```
补充说明：
- titleId 必填，仅支持参数描述列出的 11 个值。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- ``
[返回本工具集](#toolset-macro_economics) · [返回入参目录](#parameters)
### 5.25 上市公司公告工具集 `company_announcements`
查询港股、美股和 A 股上市公司公告，并将附件地址或正文合并到公告记录。
[get_company_announcements](#endpoint-get_company_announcements)
#### 5.25.1 `get_company_announcements` 上市公司公告与附件
按市场查询上市公司公告，并在每条公告中合并附件地址或正文。
调用工具集：`company_announcements`。业务参数位置：`arguments`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_company_announcements | 选择本端点。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN" | 市场代码：HK（港股）、US（美股）、CN（A股/沪深市场）。 |
| `symbols` | `string[]` | 是 | 未声明 | 最少项数：1 | 证券代码列表，例如 ["00700.hk"]、["AAPL.us"]、["600519.sh"]。 |
| `startDate` | `string` | 否 | 未声明 | 未声明 | 公告开始日期，格式 YYYY-MM-DD。 |
| `endDate` | `string` | 否 | 未声明 | 未声明 | 公告结束日期，格式 YYYY-MM-DD。 |
请求示例与补充说明
```json
{
"name": "company_announcements",
"arguments": {
"endpoint": "get_company_announcements",
"market": "HK",
"symbols": [
"00700.hk"
]
}
}
```
补充说明：
- market、symbols 必填。 返回公告列表并合并每条公告的附件地址或正文；重复公告只处理一次。 附件获取失败不会使整页失败，相关记录会返回 attachmentStatus=error。 A 股公告的 noticeId 和 attachmentUrls 只属于公告记录；time 保留原值，缺少时区与披露时间精度证明，不能当作财务值的 publishedAt，也不能据此推断财务行的来源或修订关系。
- 仅附件失败时保留公告列表并标记该条失败；公告列表调用失败时整个请求失败。
- 统一返回原公告字段，并增加 attachmentUrls、content、attachmentStatus；港股单个或多个附件都归一为 attachmentUrls 数组。
有效组合（仅列选择分支的字段，其余必填项仍按参数表补齐）：
- `market="HK"`
- `market="US"`
- `market="CN"`
[返回本工具集](#toolset-company_announcements) · [返回入参目录](#parameters)
### 5.26 参考数据工具集 `reference`
ISIN、SEDOL、CIK、货币、交易代码、证券状态、交易时段与代码映射；不提供公告、资讯、研报或披露全文搜索。
[get_reference_data](#endpoint-get_reference_data) · [get_trading_status](#endpoint-get_trading_status) · [get_symbol_mapping](#endpoint-get_symbol_mapping) · [get_market_hours](#endpoint-get_market_hours)
#### 5.26.1 `get_reference_data` 证券参考数据
查询 ISIN、SEDOL、CIK、ADR、货币、交易码表、基础码表、权证关联表、债券码表等参考数据；不提供公告、资讯、研报或披露全文搜索。
调用工具集：`reference`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_reference_data | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"GLOBAL" | 市场代码：HK=港股，CN=A股，US=美股，JP=日股，GLOBAL=债券。 |
| `referenceType` | `string` | 是 | 未声明 | 枚举："isin"；"sedol"；"trade_symbol"；"warrant_related"；"currency"；"basic_symbol"；"cik"；"adr"；"bond_codes"；"yield_codes" | referenceType 选择业务分支；字段适用范围见 parameterBranches。 |
##### 查询分支：`market="HK"，referenceType="isin"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `isin` | `string` | 否 | 未声明 | 未声明 | 非必填，国际证券识别码 |
| `language` | `string` | 否 | 未声明 | 枚举："简体"；"繁体"；"英文" | Only supports one of: 简体, 繁体, 英文. Default: 简体 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="HK"，referenceType="sedol"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `sedol` | `string` | 否 | 未声明 | 未声明 | 非必填，英国及爱尔兰市场常用证券识别码 |
| `language` | `string` | 否 | 未声明 | 枚举："简体"；"繁体"；"英文" | Only supports one of: 简体, 繁体, 英文. Default: 简体 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="HK"，referenceType="trade_symbol"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `secType` | `string` | 否 | 未声明 | 未声明 | 非必填字段，varchar(6) |
| `listBoard` | `string` | 否 | 未声明 | 枚举："MAIN"；"GEM" | 非必填，可选：MAIN（主板）、GEM（创业板） |
| `hsceFlag` | `string` | 否 | 未声明 | 未声明 | 非必填，Y=是，N=否 |
| `hsccFlag` | `string` | 否 | 未声明 | 未声明 | 非必填，Y=是，N=否 |
| `hsiFlag` | `string` | 否 | 未声明 | 未声明 | 非必填，Y=是，N=否 |
| `hkToSzFlag` | `string` | 否 | 未声明 | 未声明 | 非必填，Y=是，N=否 |
| `hkToShFlag` | `string` | 否 | 未声明 | 未声明 | 非必填，Y=是，N=否 |
| `isin` | `string` | 否 | 未声明 | 未声明 | 非必填，国际证券识别码 |
| `lotSize` | `integer` | 否 | 未声明 | 未声明 | 非必填，证券每手交易单位 |
| `tradeDate` | `string` | 否 | 未声明 | 未声明 | 非必填，日期时间格式 |
| `updateTime` | `string` | 否 | 未声明 | 未声明 | 非必填，日期时间格式 |
| `language` | `string` | 否 | 未声明 | 枚举："简体"；"繁体"；"英文" | Only supports one of: 简体, 繁体, 英文. Default: 简体 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="HK"，referenceType="warrant_related"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `warrantCode` | `string` | 否 | 未声明 | 未声明 | 非必填 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `language` | `string` | 否 | 未声明 | 枚举："简体"；"繁体"；"英文" | Only supports one of: 简体, 繁体, 英文. Default: 简体 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="HK"，referenceType="currency"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `currency` | `string` | 是 | 未声明 | 枚举："AED"；"AFN"；"ALL"；"AMD"；"ANG"；"AOA"；"ARS"；"AUD"；"AWG"；"AZN"；"BAM"；"BBD"；"BDT"；"BGN"；"BHD"；"BIF"；"BMD"；"BND"；"BOB"；"BOV"；"BRL"；"BSD"；"BTN"；"BWP"；"BYN"；"BZD"；"CAD"；"CDF"；"CHF"；"CLF"；"CLP"；"CNH"；"CNY"；"COP"；"COU"；"CRC"；"CUC"；"CUP"；"CVE"；"CZK"；"DJF"；"DKK"；"DOP"；"DZD"；"EGP"；"ERN"；"ETB"；"EUR"；"FJD"；"FKP"；"GBP"；"GBX"；"GEL"；"GHS"；"GIP"；"GMD"；"GNF"；"GTQ"；"GYD"；"HKD"；"HNL"；"HRK"；"HTG"；"HUF"；"IDR"；"ILS"；"ILX"；"INR"；"IQD"；"IRR"；"ISK"；"JMD"；"JOD"；"JPY"；"KES"；"KGS"；"KHR"；"KMF"；"KPW"；"KRW"；"KWD"；"KYD"；"KZT"；"LAK"；"LBP"；"LKR"；"LRD"；"LSL"；"LYD"；"MAD"；"MDL"；"MGA"；"MKD"；"MMK"；"MNT"；"MOP"；"MRU"；"MUR"；"MVR"；"MWK"；"MXN"；"MXV"；"MYR"；"MZN"；"NAD"；"NGN"；"NIO"；"NOK"；"NPR"；"NZD"；"OMR"；"PAB"；"PEN"；"PGK"；"PHP"；"PKR"；"PLN"；"PYG"；"QAR"；"RON"；"RSD"；"RUB"；"RWF"；"SAR"；"SBD"；"SCR"；"SDG"；"SEK"；"SGD"；"SHP"；"SLL"；"SOS"；"SRD"；"SSP"；"STD"；"SYP"；"SZL"；"THB"；"TJS"；"TMT"；"TND"；"TOP"；"TRY"；"TTD"；"TWD"；"TZS"；"UAH"；"UGX"；"USD"；"UYU"；"UZS"；"VES"；"VND"；"VUV"；"WST"；"XAF"；"XAG"；"XAU"；"XCD"；"XDR"；"XOF"；"XPD"；"XPF"；"XPT"；"YER"；"ZAR"；"ZMW"；"ZWL" | 货币标识；仅接受该分支声明的类型，不从证券市场推断缺失币种。 |
| `startDate` | `string` | 否 | 未声明 | 未声明 | 非必填，格式 yyyy-MM-dd，用于筛选日期范围起点 |
| `endDate` | `string` | 否 | 未声明 | 未声明 | 非必填，格式 yyyy-MM-dd，用于筛选日期范围终点 |
| `sort` | `string` | 否 | 未声明 | 枚举："desc"；"asc"；"DESC"；"ASC" | 非必填，desc=倒序，asc=正序，默认 desc |
| `language` | `string` | 否 | 未声明 | 枚举："简体"；"繁体"；"英文" | Only supports one of: 简体, 繁体, 英文. Default: 简体 |
##### 查询分支：`market="HK"，referenceType="basic_symbol"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `listMarket` | `string` | 否 | 未声明 | 未声明 | 非必填字段，varchar(10) |
| `listBoard` | `string` | 否 | 未声明 | 枚举："MAIN"；"GEM" | 非必填，可选：MAIN（主板）、GEM（创业板） |
| `hkexInstrumentType` | `string` | 否 | 未声明 | 未声明 | 非必填字段，varchar(6) |
| `fiuInstrumentType` | `string` | 否 | 未声明 | 未声明 | 示例值：1 |
| `aShareCode` | `string` | 否 | 未声明 | 未声明 | 非必填，用于按A股代码筛选 |
| `hsiFlag` | `string` | 否 | 未声明 | 未声明 | 非必填，Y=是，N=否 |
| `hsceFlag` | `string` | 否 | 未声明 | 未声明 | 非必填，Y=是，N=否 |
| `hsccFlag` | `string` | 否 | 未声明 | 未声明 | 非必填，Y=是，N=否 |
| `hkToShFlag` | `string` | 否 | 未声明 | 未声明 | 非必填，Y=是，N=否 |
| `hkToSzFlag` | `string` | 否 | 未声明 | 未声明 | 非必填，Y=是，N=否 |
| `companyReportKind` | `string` | 否 | 未声明 | 未声明 | 非必填字段，varchar(2) |
| `language` | `string` | 否 | 未声明 | 枚举："简体"；"繁体"；"英文" | Only supports one of: 简体, 繁体, 英文. Default: 简体 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="US"，referenceType="cik"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `cik` | `string` | 否 | 未声明 | 未声明 | 通过CIK码查找 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。
##### 查询分支：`market="US"，referenceType="isin"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `isin` | `string` | 否 | 未声明 | 未声明 | 非必填，国际证券识别码 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="US"，referenceType="sedol"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `sedol` | `string` | 否 | 未声明 | 未声明 | 非必填，英国及爱尔兰市场常用证券识别码 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="US"，referenceType="adr"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="US"，referenceType="trade_symbol"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `cqs` | `string` | 否 | 未声明 | 未声明 | 非必填，varchar(32)类型 |
| `isin` | `string` | 否 | 未声明 | 未声明 | 非必填，国际证券识别码 |
| `exchange` | `string` | 否 | 未声明 | 枚举："Q"；"G"；"S"；"N"；"A"；"P"；"Z"；"V" | 非必填，varchar(4)类型，由NASDAQ提供，标识股票的上市市场或市场等级 Q=Nasdaq全球精选市场 G=Nasdaq全球市场 S=Nasdaq资本市场 N=NYSE纽约交易所 A=NYSE MKT（AMEX）- 纽约证券交易所美国交易所 P=NYSE Arca - 纽约证券交易所Arca板 Z=BATS交易所 V=Investor's Exchange，LLC - 投资者交易所 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="US"，referenceType="warrant_related"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `warrantCode` | `string` | 否 | 未声明 | 未声明 | 非必填 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="US"，referenceType="currency"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `currency` | `string` | 是 | 未声明 | 枚举："AED"；"AFN"；"ALL"；"AMD"；"ANG"；"AOA"；"ARS"；"AUD"；"AWG"；"AZN"；"BAM"；"BBD"；"BDT"；"BGN"；"BHD"；"BIF"；"BMD"；"BND"；"BOB"；"BOV"；"BRL"；"BSD"；"BTN"；"BWP"；"BYN"；"BZD"；"CAD"；"CDF"；"CHF"；"CLF"；"CLP"；"CNH"；"CNY"；"COP"；"COU"；"CRC"；"CUC"；"CUP"；"CVE"；"CZK"；"DJF"；"DKK"；"DOP"；"DZD"；"EGP"；"ERN"；"ETB"；"EUR"；"FJD"；"FKP"；"GBP"；"GBX"；"GEL"；"GHS"；"GIP"；"GMD"；"GNF"；"GTQ"；"GYD"；"HKD"；"HNL"；"HRK"；"HTG"；"HUF"；"IDR"；"ILS"；"ILX"；"INR"；"IQD"；"IRR"；"ISK"；"JMD"；"JOD"；"JPY"；"KES"；"KGS"；"KHR"；"KMF"；"KPW"；"KRW"；"KWD"；"KYD"；"KZT"；"LAK"；"LBP"；"LKR"；"LRD"；"LSL"；"LYD"；"MAD"；"MDL"；"MGA"；"MKD"；"MMK"；"MNT"；"MOP"；"MRU"；"MUR"；"MVR"；"MWK"；"MXN"；"MXV"；"MYR"；"MZN"；"NAD"；"NGN"；"NIO"；"NOK"；"NPR"；"NZD"；"OMR"；"PAB"；"PEN"；"PGK"；"PHP"；"PKR"；"PLN"；"PYG"；"QAR"；"RON"；"RSD"；"RUB"；"RWF"；"SAR"；"SBD"；"SCR"；"SDG"；"SEK"；"SGD"；"SHP"；"SLL"；"SOS"；"SRD"；"SSP"；"STD"；"SYP"；"SZL"；"THB"；"TJS"；"TMT"；"TND"；"TOP"；"TRY"；"TTD"；"TWD"；"TZS"；"UAH"；"UGX"；"USD"；"UYU"；"UZS"；"VES"；"VND"；"VUV"；"WST"；"XAF"；"XAG"；"XAU"；"XCD"；"XDR"；"XOF"；"XPD"；"XPF"；"XPT"；"YER"；"ZAR"；"ZMW"；"ZWL" | 货币标识；仅接受该分支声明的类型，不从证券市场推断缺失币种。 |
| `startDate` | `string` | 否 | 未声明 | 未声明 | 非必填，格式 yyyy-MM-dd，用于筛选日期范围起点 |
| `endDate` | `string` | 否 | 未声明 | 未声明 | 非必填，格式 yyyy-MM-dd，用于筛选日期范围终点 |
| `sort` | `string` | 否 | 未声明 | 枚举："desc"；"asc"；"DESC"；"ASC" | 非必填，desc=倒序，asc=正序，默认 desc |
##### 查询分支：`market="CN"，referenceType="isin"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `isin` | `string` | 否 | 未声明 | 未声明 | 非必填，国际证券识别码 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="CN"，referenceType="sedol"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `sedol` | `string` | 否 | 未声明 | 未声明 | 非必填，英国及爱尔兰市场常用证券识别码 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。
##### 查询分支：`market="CN"，referenceType="currency"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `currency` | `string` | 是 | 未声明 | 枚举："AED"；"AFN"；"ALL"；"AMD"；"ANG"；"AOA"；"ARS"；"AUD"；"AWG"；"AZN"；"BAM"；"BBD"；"BDT"；"BGN"；"BHD"；"BIF"；"BMD"；"BND"；"BOB"；"BOV"；"BRL"；"BSD"；"BTN"；"BWP"；"BYN"；"BZD"；"CAD"；"CDF"；"CHF"；"CLF"；"CLP"；"CNH"；"CNY"；"COP"；"COU"；"CRC"；"CUC"；"CUP"；"CVE"；"CZK"；"DJF"；"DKK"；"DOP"；"DZD"；"EGP"；"ERN"；"ETB"；"EUR"；"FJD"；"FKP"；"GBP"；"GBX"；"GEL"；"GHS"；"GIP"；"GMD"；"GNF"；"GTQ"；"GYD"；"HKD"；"HNL"；"HRK"；"HTG"；"HUF"；"IDR"；"ILS"；"ILX"；"INR"；"IQD"；"IRR"；"ISK"；"JMD"；"JOD"；"JPY"；"KES"；"KGS"；"KHR"；"KMF"；"KPW"；"KRW"；"KWD"；"KYD"；"KZT"；"LAK"；"LBP"；"LKR"；"LRD"；"LSL"；"LYD"；"MAD"；"MDL"；"MGA"；"MKD"；"MMK"；"MNT"；"MOP"；"MRU"；"MUR"；"MVR"；"MWK"；"MXN"；"MXV"；"MYR"；"MZN"；"NAD"；"NGN"；"NIO"；"NOK"；"NPR"；"NZD"；"OMR"；"PAB"；"PEN"；"PGK"；"PHP"；"PKR"；"PLN"；"PYG"；"QAR"；"RON"；"RSD"；"RUB"；"RWF"；"SAR"；"SBD"；"SCR"；"SDG"；"SEK"；"SGD"；"SHP"；"SLL"；"SOS"；"SRD"；"SSP"；"STD"；"SYP"；"SZL"；"THB"；"TJS"；"TMT"；"TND"；"TOP"；"TRY"；"TTD"；"TWD"；"TZS"；"UAH"；"UGX"；"USD"；"UYU"；"UZS"；"VES"；"VND"；"VUV"；"WST"；"XAF"；"XAG"；"XAU"；"XCD"；"XDR"；"XOF"；"XPD"；"XPF"；"XPT"；"YER"；"ZAR"；"ZMW"；"ZWL" | 货币标识；仅接受该分支声明的类型，不从证券市场推断缺失币种。 |
| `startDate` | `string` | 否 | 未声明 | 未声明 | 非必填，格式 yyyy-MM-dd，用于筛选日期范围起点 |
| `endDate` | `string` | 否 | 未声明 | 未声明 | 非必填，格式 yyyy-MM-dd，用于筛选日期范围终点 |
| `sort` | `string` | 否 | 未声明 | 枚举："desc"；"asc"；"DESC"；"ASC" | 非必填，desc=倒序，asc=正序，默认 desc |
##### 查询分支：`market="CN"，referenceType="basic_symbol"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `listMarket` | `string` | 否 | 未声明 | 枚举："上海证券交易所"；"深圳证券交易所" | 非必填，可取值：上海证券交易所、深圳证券交易所，示例值：深圳证券交易所 |
| `listBoard` | `string` | 否 | 未声明 | 枚举："主板"；"创业板"；"科创板"；"深交所退市整理板"；"上交所风险警示板" | 非必填，可选：主板、创业板、科创板、深交所退市整理板、上交所风险警示板 |
| `fiuInstrumentType` | `integer` | 否 | 未声明 | 未声明 | 示例值：1 |
| `hkShareCode` | `string` | 否 | 未声明 | 未声明 | 非必填，用于按港股代码筛选 |
| `hsiFlag` | `string` | 否 | 未声明 | 枚举："Y"；"N" | 非必填，Y=是，N=否 |
| `hsToHkFlag` | `integer` | 否 | 未声明 | 枚举："Y"；"N" | 非必填，Y=是、N=否 |
| `companyReportKind` | `integer` | 否 | 未声明 | 枚举：0；1；2；3 | 非必填，0=一般企业，1=银行，2=保险，3=证券 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="GLOBAL"，referenceType="bond_codes"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `country` | `string` | 否 | 未声明 | 枚举："CHN"；"HKG"；"USA"；"all" | 债券风险所在地（Country of Risk），不传或传 all 表示全部。 |
| `currency` | `string` | 否 | 未声明 | 枚举："CNY"；"EUR"；"GBP"；"HKD"；"USD"；"all" | 货币标识；仅接受该分支声明的类型，不从证券市场推断缺失币种。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1 | 页码，从 1 开始。 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1 | 每页记录数，正整数，默认 20。 |
| `region` | `integer` | 否 | 未声明 | 枚举：1；2；3 | 地区：1 表示美洲地区，2 表示亚太地区，3 表示欧非中东。 |
| `state` | `integer` | 否 | 未声明 | 未声明 | 当前债券状态。 |
| `subtype` | `integer` | 否 | 未声明 | 枚举：1；2；3；4 | 债券子类型。 |
| `type` | `integer` | 否 | 未声明 | 枚举：1；2；3 | 债券类型 |
##### 查询分支：`market="GLOBAL"，referenceType="yield_codes"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `country` | `string` | 否 | 未声明 | 枚举："CHN"；"HKG"；"USA"；"all" | 债券风险所在地（Country of Risk），不传或传 all 表示全部。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1 | 页码，从 1 开始。 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1 | 每页记录数，正整数，默认 20。 |
| `region` | `integer` | 否 | 未声明 | 枚举：1；2；3 | 地区：1 表示美洲地区，2 表示亚太地区，3 表示欧非中东。 |
请求示例与补充说明
```json
{
"name": "reference",
"arguments": {
"endpoint": "get_reference_data",
"params": {
"market": "HK",
"referenceType": "isin",
"symbol": "00700.hk"
}
}
}
```
补充说明：
- 按 market 与 referenceType 选择分支；仅传该分支声明的参数。ISIN/SEDOL 仅回显请求或来源值全空时为 empty，不能据此认定该证券没有标识。
- GLOBAL + bond_codes 默认 pageNum=1、pageSize=20。导航按当前请求、实际 list 长度和一致总数重算，sourcePagination 保留原始分页。
- 后续空页的总数被下游清零时，同筛选条件回查首页；确认越界返回 PAGE_OUT_OF_RANGE，无法确认返回 PAGE_EMPTY_UNCONFIRMED、total/pages=null。首页核验异常仍作为错误返回。
- 本工具集按完整响应交付，预算为 128,000 字符；超出时返回 RESPONSE_TOO_LARGE，请缩小 pageSize 或批量证券数。
- 分支 market="HK"，referenceType="basic_symbol"；响应 dataType：object[]
- 分支 market="HK"，referenceType="basic_symbol"；响应 fieldTypes：{"tradingStatus":"string|null","fiuInstrumentType":"string|null","companyReportKind":"string|null","listMarket":"string|null","tradingCurrency":"string|null"}
- 分支 market="HK"，referenceType="basic_symbol"；响应 semantics：listMarket 保留来源代码或名称；原码不能跨市场比较，币种 null 不推断。
- 分支 market="CN"，referenceType="basic_symbol"；响应 dataType：object[]
- 分支 market="CN"，referenceType="basic_symbol"；响应 fieldTypes：{"tradingStatus":"number|null","fiuInstrumentType":"number|null","companyReportKind":"number|null","listMarket":"string|null","tradingCurrency":"string|null"}
- 分支 market="CN"，referenceType="basic_symbol"；响应 semantics：listMarket 保留来源代码或名称；原码不能跨市场比较，币种 null 不推断。
[返回本工具集](#toolset-reference) · [返回入参目录](#parameters)
#### 5.26.2 `get_trading_status` 证券与交易状态
查询交易日期、交易时段、除权事件、证券状态、退市列表等状态类数据。
调用工具集：`reference`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_trading_status | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP"；"GLOBAL" | 市场代码：HK=港股，CN=A股，US=美股，JP=日股，GLOBAL=债券。 |
| `statusType` | `string` | 是 | 未声明 | 枚举："trade_date"；"session"；"exright"；"security"；"delisted"；"current"；"bond_session"；"yield_session" | statusType 选择业务分支；字段适用范围见 parameterBranches。 |
##### 查询分支：`market="HK"，statusType="trade_date"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `date` | `string` | 否 | 未声明 | 未声明 | 锚定日期，YYYY-MM-DD；交易日历不传时按市场当前日期查询。 |
| `filterStatus` | `string` | 否 | "Y" | 枚举："Y"；"N"；"H"；"ALL" | 交易日状态：Y=交易日，N=非交易日，H=半日交易（仅港股），ALL=不筛选状态。 |
| `orderMode` | `integer` | 否 | 1 | 枚举：0；1 | 查询方向：0=以 date 为结束点向前查询，1=以 date 为起点向后查询，包含锚定日。 |
| `stockConnect` | `string` | 否 | 未声明 | 枚举："NB"；"SB" | 日历范围：NB=北向，SB=南向；不传使用本市场日历。 通道休市不代表交易所休市。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1 | 页码，从 1 开始。 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1 | 每页记录数，正整数，默认 20。 |
##### 查询分支：`market="HK"，statusType="session"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `board` | `string` | 否 | 未声明 | 枚举："MAIN"；"GEM"；"NASD"；"ETS" | 市场类别筛选：MAIN=主板、GEM=创业板、NASD=NASDAQ AMX市场、ETS=扩充交易证券；不传返回全部类别。 不是交易时段 ID，不支持 symbol/symbols 筛选。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式：0=实时，1=延时。 |
##### 查询分支：`market="HK"，statusType="exright"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。
##### 查询分支：`market="HK"，statusType="security"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 本地精确筛选停复牌列表；未命中不表示正常交易。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1000 | 本地按代码筛选停复牌列表；一次查询。 |
##### 查询分支：`market="US"，statusType="trade_date"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `date` | `string` | 否 | 未声明 | 未声明 | 锚定日期，YYYY-MM-DD；交易日历不传时按市场当前日期查询。 |
| `orderMode` | `integer` | 否 | 0 | 枚举：0；1 | 查询方向：0=以 date 为结束点向前查询，1=以 date 为起点向后查询，包含锚定日。 |
| `filterStatus` | `string` | 否 | "Y" | 枚举："Y"；"N"；"ALL" | 交易日状态：Y=交易日，N=非交易日，H=半日交易（仅港股），ALL=不筛选状态。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1 | 页码，从 1 开始。 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1 | 每页记录数，正整数，默认 20。 |
##### 查询分支：`market="US"，statusType="session"`
此分支无需额外业务参数。
##### 查询分支：`market="US"，statusType="exright"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。
##### 查询分支：`market="US"，statusType="delisted"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `date` | `integer` | 否 | 未声明 | 未声明 | 锚定日期，YYYY-MM-DD；交易日历不传时按市场当前日期查询。 |
| `exchange` | `string` | 否 | 未声明 | 枚举："Q"；"N"；"A"；"OTC" | 美股退市列表的市场类别：Q、N、A、OTC；对应 market，不是组合市场 US。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1000 | 证券代码数组；只支持单证券的分支最多传 1 个。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单证券查询写法，与 symbols 二选一。 |
##### 查询分支：`market="US"，statusType="security"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1000 | 证券代码数组；只支持单证券的分支最多传 1 个。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单证券查询写法，与 symbols 二选一。 |
至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。
##### 查询分支：`market="CN"，statusType="trade_date"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `date` | `string` | 否 | 未声明 | 未声明 | 锚定日期，YYYY-MM-DD；交易日历不传时按市场当前日期查询。 |
| `orderMode` | `integer` | 否 | 0 | 枚举：0；1 | 查询方向：0=以 date 为结束点向前查询，1=以 date 为起点向后查询，包含锚定日。 |
| `filterStatus` | `string` | 否 | "Y" | 枚举："Y"；"N"；"ALL" | 交易日状态：Y=交易日，N=非交易日，H=半日交易（仅港股），ALL=不筛选状态。 |
| `stockConnect` | `string` | 否 | 未声明 | 枚举："NB"；"SB" | 日历范围：NB=北向，SB=南向；不传使用本市场日历。 通道休市不代表交易所休市。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1 | 页码，从 1 开始。 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1 | 每页记录数，正整数，默认 20。 |
##### 查询分支：`market="CN"，statusType="session"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `board` | `string` | 否 | "1" | 枚举："1"；"3"；"6" | 主板1，创业板3，科创板6，不填默认所有 |
##### 查询分支：`market="CN"，statusType="exright"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。
##### 查询分支：`market="CN"，statusType="current"`
此分支无需额外业务参数。
##### 查询分支：`market="CN"，statusType="security"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1000 | 证券代码数组；只支持单证券的分支最多传 1 个。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单证券查询写法，与 symbols 二选一。 |
至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。
##### 查询分支：`market="JP"，statusType="trade_date"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `date` | `string` | 否 | 未声明 | 未声明 | 锚定日期，YYYY-MM-DD；交易日历不传时按市场当前日期查询。 |
| `filterStatus` | `string` | 否 | "ALL" | 枚举："Y"；"N"；"ALL" | 交易日状态：Y=交易日，N=非交易日，H=半日交易（仅港股），ALL=不筛选状态。 |
| `orderMode` | `integer` | 否 | 0 | 枚举：0；1 | 查询方向：0=以 date 为结束点向前查询，1=以 date 为起点向后查询，包含锚定日。 |
| `pageNum` | `integer` | 否 | 1 | 最小值：1 | 页码，从 1 开始。 |
| `pageSize` | `integer` | 否 | 20 | 最小值：1 | 每页记录数，正整数，默认 20。 |
##### 查询分支：`market="JP"，statusType="session"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `board` | `string` | 否 | 未声明 | 未声明 | 股票代码 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式：0=实时，1=延时。 |
##### 查询分支：`market="JP"，statusType="security"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。
##### 查询分支：`market="GLOBAL"，statusType="bond_session"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | "US91282CHZ77" | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="GLOBAL"，statusType="yield_session"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | "US91282CHZ77" | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
请求示例与补充说明
```json
{
"name": "reference",
"arguments": {
"endpoint": "get_trading_status",
"params": {
"market": "CN",
"statusType": "security",
"symbols": [
"600519.sh"
]
}
}
}
```
补充说明：
- CN/US 的 statusType=security 支持 symbol 或 symbols，二者互斥且至少提供一项。来源为静态证券基础资料，statusBasis=basic_info；不据此承诺实时可交易状态。
- securityStatus/marketStatus 保留来源原码，0 也是有效原值；未确认的中文码义为 null。statusAvailability=available 仅表示获得原码，missing 表示缺少有效值。
- 证券状态查询按有效结果计算 coverage/missingSymbols；全缺失为 empty/REFERENCE_VALUE_UNAVAILABLE。缺项不能证明证券不存在。
- 交易日历使用 date 锚定查询；stockConnect 表示通道日历，不能等同于交易所日历。US delisted 的交易所筛选字段是 exchange，market 固定为 US。
- 不同市场的 session.status、securityStatus、marketStatus 含义不同，不能混用；交易时段码义与字段定义见各分支响应约定。
- 本工具集按完整响应交付，预算为 128,000 字符；超出时返回 RESPONSE_TOO_LARGE，请缩小 pageSize 或批量证券数。
- 分支 market="HK"，statusType="session"；响应 dataType：object[]
- 分支 market="HK"，statusType="session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","market":"下游市场类别代码：主板、创业板及供应商定义的其他证券市场类别；不是请求的 HK 市场代码，也不是交易时段 ID。","marketName":"下游市场类别中文含义，沿用供应商定义；未知码为 null。","subId":"交易时段 ID；与 market 市场类别分别解释。","subIdName":"交易时段中文含义；未知码为 null。","controlFlag":"控制标识原码。","controlFlagName":"控制标识中文含义；未知码为 null。"}
- 分支 market="HK"，statusType="session"；响应 valueMappings：{"status":{"0":"未知","10":"暂停","20":"开盘前","30":"开盘","40":"收盘前","50":"收盘","100":"当天闭市"},"market":{"MAIN":"主板","GEM":"创业板","NASD":"NASDAQ AMX市场","ETS":"扩充交易证券"},"subId":{"0":"当天闭市","1":"订单输入","2":"订单对盘","3":"持续交易","4":"订单对盘","5":"订单输入","7":"暂停","100":"未开市","101":"不可取消","102":"交易所干预","103":"收市","104":"订单取消","105":"参考定价","106":"不可取消","107":"随机收盘","108":"随机对盘"},"controlFlag":{"0":"自动","1":"手动（表示这一天的正常日程无效）"}}
- 分支 market="HK"，statusType="session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
- 分支 market="US"，statusType="session"；响应 dataType：object
- 分支 market="US"，statusType="session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"当前美东时间；不是交易时段边界或行情更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。当前美东时间；不是交易时段边界或行情更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
- 分支 market="US"，statusType="session"；响应 valueMappings：{"status":{"0":"休市中","1":"盘中交易","3":"已收盘","-1":"盘前交易","-2":"盘后交易"}}
- 分支 market="US"，statusType="session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
- 分支 market="US"，statusType="security"；响应 dataType：object[]
- 分支 market="US"，statusType="security"；响应 statusBasis：basic_info
- 分支 market="US"，statusType="security"；响应 sourceEndpoint：/v1/stock/basic/info
- 分支 market="US"，statusType="security"；响应 semantics：证券状态来源于静态基础资料；securityStatus/marketStatus 保留原码，字典及更新时间尚未确认，不能用于实时可交易判断。
- 分支 market="US"，statusType="security"；响应 fieldDescriptions：{"symbol":"来源证券代码","canonicalSymbol":"归一化股票代码","name":"证券名称","nameCn":"中文名称","nameEn":"英文名称","securityStatus":"证券状态原码；0 是有效原值，但未确认中文含义。","marketStatus":"市场状态原码；不等同于其他状态接口的 status。","securityStatusName":"证券状态中文含义；未确认时为 null。","marketStatusName":"市场状态中文含义；未确认时为 null。","listingDate":"上市日期","delistingDate":"退市日期；null 不代表已确认未退市。","statusAvailability":"available=取得证券状态原码；missing=未取得有效证券状态。available 不代表可交易。","missingReason":"DOWNSTREAM_VALUE_UNAVAILABLE=下游未提供有效证券状态；不能据此确认证券不存在。"}
- 分支 market="CN"，statusType="session"；响应 dataType：object[]
- 分支 market="CN"，statusType="session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","board":"板块代码：1=主板、3=创业板、6=科创板。"}
- 分支 market="CN"，statusType="session"；响应 valueMappings：{}
- 分支 market="CN"，statusType="session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
- 分支 market="CN"，statusType="security"；响应 dataType：object[]
- 分支 market="CN"，statusType="security"；响应 statusBasis：basic_info
- 分支 market="CN"，statusType="security"；响应 sourceEndpoint：/v1/stock/basic/info
- 分支 market="CN"，statusType="security"；响应 semantics：证券状态来源于静态基础资料；securityStatus/marketStatus 保留原码，字典及更新时间尚未确认，不能用于实时可交易判断。
- 分支 market="CN"，statusType="security"；响应 fieldDescriptions：{"symbol":"来源证券代码","canonicalSymbol":"归一化股票代码","name":"证券名称","nameCn":"中文名称","nameEn":"英文名称","securityStatus":"证券状态原码；0 是有效原值，但未确认中文含义。","marketStatus":"市场状态原码；不等同于其他状态接口的 status。","securityStatusName":"证券状态中文含义；未确认时为 null。","marketStatusName":"市场状态中文含义；未确认时为 null。","listingDate":"上市日期","delistingDate":"退市日期；null 不代表已确认未退市。","statusAvailability":"available=取得证券状态原码；missing=未取得有效证券状态。available 不代表可交易。","missingReason":"DOWNSTREAM_VALUE_UNAVAILABLE=下游未提供有效证券状态；不能据此确认证券不存在。"}
- 分支 market="JP"，statusType="session"；响应 dataType：object
- 分支 market="JP"，statusType="session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","tradeStatus":"来源交易标识；保留原码，未确认完整字典。"}
- 分支 market="JP"，statusType="session"；响应 valueMappings：{"status":{"0":"未开盘","1":"盘前竞价","2":"等待开盘","3":"交易中","4":"午间休市","5":"收盘竞价","6":"已收盘","7":"休市中","8":"盘后交易"}}
- 分支 market="JP"，statusType="session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
- 分支 market="GLOBAL"，statusType="bond_session"；响应 dataType：object
- 分支 market="GLOBAL"，statusType="bond_session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
- 分支 market="GLOBAL"，statusType="bond_session"；响应 valueMappings：{}
- 分支 market="GLOBAL"，statusType="bond_session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
- 分支 market="GLOBAL"，statusType="yield_session"；响应 dataType：object
- 分支 market="GLOBAL"，statusType="yield_session"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
- 分支 market="GLOBAL"，statusType="yield_session"；响应 valueMappings：{}
- 分支 market="GLOBAL"，statusType="yield_session"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
[返回本工具集](#toolset-reference) · [返回入参目录](#parameters)
#### 5.26.3 `get_symbol_mapping` 证券代码映射
查询证券代码名称映射、指数映射。
调用工具集：`reference`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_symbol_mapping | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US" | 市场代码：HK=港股，CN=A股，US=美股，JP=日股，GLOBAL=债券。 |
| `referenceType` | `string` | 是 | 未声明 | 枚举："stock"；"index" | referenceType 选择业务分支；字段适用范围见 parameterBranches。 |
##### 查询分支：`market="HK"，referenceType="stock"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1000 | 证券代码数组；只支持单证券的分支最多传 1 个。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单证券查询写法，与 symbols 二选一。 |
至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。
##### 查询分支：`market="HK"，referenceType="index"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 是 | 未声明 | 未声明 | 指数代码：恒生指数使用 HSI 或 HSI.HI，不使用股票后缀 HSI.hk。 |
##### 查询分支：`market="US"，referenceType="stock"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1000 | 证券代码数组；只支持单证券的分支最多传 1 个。 |
| `symbol` | `string` | 否 | 未声明 | 未声明 | 单证券查询写法，与 symbols 二选一。 |
至少提供一项：symbol、symbols。symbol 与 symbols 同时出现时会被拒绝。
请求示例与补充说明
```json
{
"name": "reference",
"arguments": {
"endpoint": "get_symbol_mapping",
"params": {
"market": "HK",
"referenceType": "stock",
"symbols": [
"00700.hk",
"00388.hk"
]
}
}
}
```
补充说明：
- HK/US 股票映射保留来源记录及顺序，按归一化代码匹配请求。coverage=complete/partial/none 表示有效映射覆盖，missingSymbols 保留缺项的原始请求代码。
- 别名或重复请求不按行数判缺失；有效映射至少需要来源名称非空。全缺失或全空回显返回 empty/REFERENCE_VALUE_UNAVAILABLE，部分缺失返回数据和 warning。
- 证券代码和指数代码使用不同命名空间；港股指数映射使用 HSI 或 HSI.HI。
- 本工具集按完整响应交付，预算为 128,000 字符；超出时返回 RESPONSE_TOO_LARGE，请缩小 pageSize 或批量证券数。
[返回本工具集](#toolset-reference) · [返回入参目录](#parameters)
#### 5.26.4 `get_market_hours` 市场交易时段
查询当前交易时段状态；是 get_trading_status(session) 的别名，不是完整交易日程。
调用工具集：`reference`。业务参数位置：`arguments.params`。
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `arguments.endpoint` | `string` | 是 | 未声明 | 固定值：get_market_hours | 选择本端点。 |
| `arguments.params` | `object` | 否 | {} | 未声明 | 业务参数对象；仅填写目标端点和分支声明的字段。 |
| `market` | `string` | 是 | 未声明 | 枚举："HK"；"US"；"CN"；"JP"；"GLOBAL" | 市场代码：HK=港股，CN=A股，US=美股，JP=日股，GLOBAL=债券。 |
| `statusType` | `string` | 否 | 未声明 | 枚举："bond"；"yield" | statusType 选择业务分支；字段适用范围见 parameterBranches。 |
##### 查询分支：`market="HK"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `board` | `string` | 否 | 未声明 | 枚举："MAIN"；"GEM"；"NASD"；"ETS" | 市场类别筛选：MAIN=主板、GEM=创业板、NASD=NASDAQ AMX市场、ETS=扩充交易证券；不传返回全部类别。 不是交易时段 ID，不支持 symbol/symbols 筛选。 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式：0=实时，1=延时。 |
##### 查询分支：`market="US"`
此分支无需额外业务参数。
##### 查询分支：`market="CN"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `board` | `string` | 否 | "1" | 枚举："1"；"3"；"6" | 主板1，创业板3，科创板6，不填默认所有 |
##### 查询分支：`market="JP"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `board` | `string` | 否 | 未声明 | 未声明 | 股票代码 |
| `timeMode` | `integer` | 否 | 0 | 枚举：0；1 | 时间模式：0=实时，1=延时。 |
##### 查询分支：`market="GLOBAL"，statusType="bond"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | "US91282CHZ77" | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
##### 查询分支：`market="GLOBAL"，statusType="yield"`
| 参数 | 类型 | 必填 | 默认值 | 可选值与约束 | 说明 |
| --- | --- | --- | --- | --- | --- |
| `symbol` | `string` | 否 | "US91282CHZ77" | 未声明 | 证券代码，例如 00700.hk、600519.sh、AAPL.us。 |
| `symbols` | `string[]` | 否 | 未声明 | 最少项数：1；最多项数：1 | symbol 的单元素数组写法；此分支不支持多证券查询。 |
请求示例与补充说明
```json
{
"name": "reference",
"arguments": {
"endpoint": "get_market_hours",
"params": {
"market": "HK",
"board": "MAIN"
}
}
}
```
补充说明：
- 按市场选择交易时段分支；HK/JP 支持 timeMode，US/CN 不接受该参数。GLOBAL 必须按 bond/yield 选择分支并填写标识。
- 时间使用带偏移的 ISO 8601，sourceTime 保留来源原值；时段状态码按市场解释。HK 的市场、状态、子时段和控制标识含义见响应约定。
- 本工具集按完整响应交付，预算为 128,000 字符；超出时返回 RESPONSE_TOO_LARGE，请缩小 pageSize 或批量证券数。
- 分支 market="HK"；响应 dataType：object[]
- 分支 market="HK"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","market":"下游市场类别代码：主板、创业板及供应商定义的其他证券市场类别；不是请求的 HK 市场代码，也不是交易时段 ID。","marketName":"下游市场类别中文含义，沿用供应商定义；未知码为 null。","subId":"交易时段 ID；与 market 市场类别分别解释。","subIdName":"交易时段中文含义；未知码为 null。","controlFlag":"控制标识原码。","controlFlagName":"控制标识中文含义；未知码为 null。"}
- 分支 market="HK"；响应 valueMappings：{"status":{"0":"未知","10":"暂停","20":"开盘前","30":"开盘","40":"收盘前","50":"收盘","100":"当天闭市"},"market":{"MAIN":"主板","GEM":"创业板","NASD":"NASDAQ AMX市场","ETS":"扩充交易证券"},"subId":{"0":"当天闭市","1":"订单输入","2":"订单对盘","3":"持续交易","4":"订单对盘","5":"订单输入","7":"暂停","100":"未开市","101":"不可取消","102":"交易所干预","103":"收市","104":"订单取消","105":"参考定价","106":"不可取消","107":"随机收盘","108":"随机对盘"},"controlFlag":{"0":"自动","1":"手动（表示这一天的正常日程无效）"}}
- 分支 market="HK"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
- 分支 market="US"；响应 dataType：object
- 分支 market="US"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"当前美东时间；不是交易时段边界或行情更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。当前美东时间；不是交易时段边界或行情更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
- 分支 market="US"；响应 valueMappings：{"status":{"0":"休市中","1":"盘中交易","3":"已收盘","-1":"盘前交易","-2":"盘后交易"}}
- 分支 market="US"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
- 分支 market="CN"；响应 dataType：object[]
- 分支 market="CN"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","board":"板块代码：1=主板、3=创业板、6=科创板。"}
- 分支 market="CN"；响应 valueMappings：{}
- 分支 market="CN"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
- 分支 market="JP"；响应 dataType：object
- 分支 market="JP"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。","tradeStatus":"来源交易标识；保留原码，未确认完整字典。"}
- 分支 market="JP"；响应 valueMappings：{"status":{"0":"未开盘","1":"盘前竞价","2":"等待开盘","3":"交易中","4":"午间休市","5":"收盘竞价","6":"已收盘","7":"休市中","8":"盘后交易"}}
- 分支 market="JP"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
- 分支 market="GLOBAL"，statusType="bond"；响应 dataType：object
- 分支 market="GLOBAL"，statusType="bond"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
- 分支 market="GLOBAL"，statusType="bond"；响应 valueMappings：{}
- 分支 market="GLOBAL"，statusType="bond"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
- 分支 market="GLOBAL"，statusType="yield"；响应 dataType：object
- 分支 market="GLOBAL"，statusType="yield"；响应 fieldDescriptions：{"status":"交易时段状态原码；仅按当前市场码表解释。","statusName":"交易时段状态中文含义；未知码为 null。","securityStatus":"证券状态原码；当前尚无已确认字典。","securityStatusName":"证券状态中文含义；未确认时为 null。","time":"来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。 输出为带时区偏移的 ISO 8601 或 null。","sourceTime":"未经转换的来源 time。来源时间，业务语义尚未确认；不能据此认定交易时段边界或数据更新时间。","startTime":"来源开始时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的开始边界。","endTime":"来源结束时间，转为带偏移 ISO 8601 或 null；不能直接视为完整交易日程的结束边界。","sourceStartTime":"未经转换的来源 startTime；不是已核实的数据更新时间。","sourceEndTime":"未经转换的来源 endTime；不是已核实的数据更新时间。"}
- 分支 market="GLOBAL"，statusType="yield"；响应 valueMappings：{}
- 分支 market="GLOBAL"，statusType="yield"；响应 semantics：当前交易时段状态，不是完整交易日程；未提供可核验的来源更新时间，不能据此判断数据新鲜度或个股是否可交易。
[返回本工具集](#toolset-reference) · [返回入参目录](#parameters)
## 6. 返回结果说明
### 6.1 MCP 封装与业务数据
业务 JSON 通常位于 MCP `content` 的 text 项中。先检查 MCP `isError`，再解析业务 JSON；不能假设所有端点都有相同的 `data` 包装。
| 字段 | 含义与使用方式 |
| --- | --- |
| `resultStatus` / `code` | 成功业务结果为 `ok` 或 `empty`，`code=0`；参数或下游错误走错误信封。 |
| `columns` / `columnNames` / `rows` | K 线、财务及部分排行等使用紧凑表，英文名、中文名和每行值按相同列索引对应。 |
| `data`、分组对象或列表 | 其他接口按自己的业务结构返回。HK/US/CN 基础行情包含分组对象及字段说明，参考数据保留来源记录和语义元数据。 |
| `emptyReason` | 成功空结果的原因；不能统一理解为证券不存在或未披露。 |
| `warnings` / `coverage` / `missingSymbols` | 查询告警、批量有效覆盖和缺少有效返回的请求证券。 |
| `requestId` | 排查失败时与工具名、endpoint、查询条件一起保留。 |
### 6.2 空结果与失败
`resultStatus=empty` 表示查询完成但没有可用业务值。`NO_MATCHING_DATA`、`NO_DATA_FOR_PERIOD`、`REFERENCE_VALUE_UNAVAILABLE` 等分别说明不同缺失原因。部分指标结果即使保留报告期行，`value` 仍可能为 null；0 和 null 不等价。
鉴权、非法参数、路由不支持或下游故障返回 `isError=true` 和错误信息。不要把错误响应归类为正常空表。
### 6.3 完整响应、分页与数量
- K 线：`meta.count=rows.length`；日股批量的 `meta.rowCounts` 与 `meta.symbols` 顺序一致。`limit` 是请求上限，不保证下游返回同样数量，也不自动补页。
- 参考数据和成交统计明细：以实际返回页和核验总数重算分页；空页区分 `PAGE_OUT_OF_RANGE` 和 `PAGE_EMPTY_UNCONFIRMED`，不能用未经确认的零总数推定无数据。
- 财务：`returnedRowCount=rows.length`；`reportSize` 是返回行数上限，`dataCoverage` 另行说明历史候选记录覆盖程度。
- `describe_tool`、参考数据、K 线及成交统计明细采用 128,000 字符完整响应预算；超出时返回 `RESPONSE_TOO_LARGE`，请减少工具名、批量证券数、`limit` 或 `pageSize`。其他端点按各自返回契约读取。
### 6.4 时间、状态和财务语义
交易时段状态、证券状态和市场状态属于不同字段体系。参考数据保留原码、来源时间和已确认的中文含义；缺失码义不猜测。CN/US 证券状态来自静态资料，`statusAvailability=available` 只表示存在有效原码。
财务期末、供应商报告日期和首次公开时间不能混用。US 财年键仅在来源字段可核验时生成；缺失期间、币种、单位、倍率或来源关系均按返回说明处理。现金流保持来源符号，不自动补零或据近似科目推算。
## 7. 常见问题与排错
| 现象 | 检查方向 | 处理方式 |
| ------------------------------------------------- | ------------------------------------------- | ---------------------------------------------------------------------------- |
| 找不到`node` / `npx` | Node.js 版本、客户端进程 PATH | 安装符合版本要求的 Node.js；必要时为`command` 配置可执行文件的绝对路径 |
| 客户端没有 FIU 工具 | 配置文件位置、服务开关、连接状态 | 检查 MCP 设置并重启或重新连接；通过`tools/list` 验证 |
| `401` 鉴权失败 | Key 是否有效、Bearer 格式、环境变量是否传入 | HTTP 检查 Authorization；stdio 检查`FIU_API_KEY` 或 `--api-key` |
| `INVALID_ARGUMENT` / `INVALID_SEMANTIC_INPUT` | 字段位置、类型、必填项与枚举 | 对具体端点调用`describe_tool`，按本端点契约填写 |
| `INVALID_DOWNSTREAM_ARGS` | 查询分支或业务筛选条件不完整 | 核查类型判别字段、条件必填和有效业务标识；不能仅传查询类型而遗漏必要筛选条件 |
| `UNSUPPORTED_ROUTE` | 市场、资产与查询类型组合不支持 | 结合条件组合选择可用分支，或更换专用工具集 |
| `resultStatus=empty` | 标的、交易日期、历史覆盖或筛选条件 | 阅读空结果说明，调整合法查询条件 |
| 下游网络错误或超时 | 数据服务连接与响应 | 保留`requestId` 及查询条件，按错误提示处理 |
| 文档与远端工具列表不同 | 部署版本差异 | 以远端实时`tools/list` 和 `describe_tool` 为准 |
## 8. 版本与验证范围
| 项目 | 说明 |
| --- | --- |
| 文档基线 | 2026-10-23；保留 product-catalog-20261009 归档目录名。 |
| 接口来源 | 当前工作区运行的 tools/list、104 个 endpoint 的 describe_tool、注册路由、适配器和仓库 OpenAPI；包含本地尚未部署的实现。 |
| 数量口径 | 26 个业务工具集、104 个业务端点，加两个辅助工具，共 28 个 MCP 工具；未将内部兼容端点重复计入。 |
| 本次同步 | K 线日期、复权、实际条数与完整响应；财务公开参数、批量和报告期；排行分支排序；参考数据分支、分页、证券状态和批量覆盖；timeMode 实际限制。 |
| 示例验证 | 104 个端点请求示例经本地 MCP 参数校验与适配链路检查；在下游调用边界拦截，不请求真实金融数据。业务 ID 占位符需替换为有效查询结果。 |
| 验证边界 | 本次未验证生产部署、生产数据可用性或 npm 包安装；远端以实际 tools/list 和 describe_tool 为准。 |
| 格式同步 | 两份 Markdown、HTML、Excel、llms.txt 与 llms-full.txt 共用本次端点清单与参数数据。 |