Skill: xuyun9160-lgtm/noah-stock-market (version 1.2.10)

--- name: noah-stock-market description: 用于港股和美股市场数据查询与结构化行情摘要。当用户询问股票当前价格、最新行情、市场快照、分时走势、K线、盘口摆盘、逐笔成交、经纪队列、市场是否开盘、个股资金流向、板块与板块成分股、股票基础信息、期权到期日或期权链等场景时使用。适用于 HK-00700、US-AAPL 这类标准代码，也适用于用户直接输入股票名称或简写代码。仅用于只读查询，不用于下单、账户、持仓、交易执行或投资建议。 --- # Noah Stock Market 港股 / 美股只读市场数据 skill。通过公司内部证券 Open API 获取市场数据，并将原始结果整理成适合聊天场景阅读的结构化摘要。 > **Usage notice**：本 skill 只提供市场数据查询与整理，不提供下单、持仓、账户或投资建议。 ## Installation / Usage Prerequisite 本 skill 依赖公司内部证券 Open API。通过 ClawHub / OpenClaw 安装后，用户仍需补充 market token。 推荐配置文件： ```text ~/.openclaw/.secrets/noah-market.env ``` 推荐最小配置： ```bash NOAH_MARKET_APIKEY=your_common_token NOAH_API_BASE_URL=https://securities-open-api.noahgroup.com ``` 说明： - 当前生产 market 域名已固定为 `https://securities-open-api.noahgroup.com` - `noah-stock-market` 与 `noah-stock-trade` 共用同一个通用 token - token 不内置；安装后用户需自行补充 `NOAH_MARKET_APIKEY` - 不要让用户额外提供与 market 查询无关的配置项 ## Skill Routing 当前环境已验证支持： - 个股快照 / 最新行情 - 实时分时 / K线（含时间范围 K 线） - 逐笔成交 / 经纪队列 - 市场状态 / 全局市场状态 - 交易日历 - 个股资金流向 - 股票基础信息 - IPO 列表 / 排行榜 / 条件选股 - 美股分析（US analysis） - 港美股财务数据 - 股东增减持榜单 - 财富类查询：余额、总资产、现金类资产、固收资产、私募资产、银行定存详情 不支持： - 下单 / 撤单 / 改单 - 账户 / 持仓 / 资金查询 - 任何交易写操作 - 主观投资建议或收益承诺 ## Preflight 1. 先读取 `references/auth-and-preflight.md`，确认 API 配置与 token 读取方式。 2. 再根据用户意图，按需读取对应 reference： - 标的识别 / 代码标准化 → `references/symbol-resolution.md` - 快照 / 最新行情 → `references/snapshot-and-quote.md` - 分时 / K线 → `references/kline-and-intraday.md` - 逐笔 / 经纪队列 → `references/orderbook-ticker-broker.md` - 市场状态 / 交易日 → `references/market-status.md` - 资金流向 → `references/capital-flow.md` - 基本信息 → `references/plates-and-basicinfo.md` - API 意图映射 → `references/api-mapping.md` - 使用方式总览 → `references/usage-guide.md` - 当前限制 → `references/known-limitations.md` ## Execution Rules - 默认只走只读接口。 - 优先使用标准代码发请求：港股 `HK-00700`，美股 `US-AAPL`。 - 用户输入名称、简称或裸代码时，先做标准化，再请求接口。 - 如标的存在歧义，不要猜；先返回候选或要求用户澄清市场 / 代码。 - 默认返回结构化摘要，不直接倾倒整段原始 JSON。 - 仅当用户明确要求“明细”“完整逐笔”时，才展开更多原始字段。 - 排行榜、IPO 列表属于扩展能力；只有当用户明确问到时才使用。 - 对 `wealth_total_asset` 与 [REDACTED_SECRET]： - 如果用户明确给出币种，则按用户指定币种查询 - 如果用户未给出币种，则默认按 `USD` 查询 ## Recommended Script Entry 优先通过 `scripts/run_query.py` 调用已验证能力： 协议规则（重要）： - `references/openapi.yaml`、`references/enum.yaml`、`references/entity.yaml` 是本 skill 的协议源文件。 - 凡是 openapi 参数声明为枚举引用（`enum.yaml#/...`），调用时必须从 `references/enum.yaml` 取值并校验，禁止按语义猜测枚举值。 - 若协议源缺失、解析失败或传入值不在 enum 中，应直接报错，不要构造猜测参数继续请求。 - `snapshot` - `market_state` - `global_state` - `intraday` - `ticker` - `broker_queue` - `kline` - `capital_flow` - `basicinfo` - `trading_days` - `us_analysis` - `rank` - `ipo_list` - `financial_hk` - `financial_us` - `shareholder_inc_red_hold` - [REDACTED_SECRET] - `wealth_balance_list` - `wealth_cash_total_asset` - `wealth_fixed_income` - [REDACTED_SECRET] - `wealth_total_asset` 示例： ```bash python3 scripts/run_query.py snapshot HK-00700 python3 scripts/run_query.py market_state HK-00700 python3 scripts/run_query.py global_state HK-00700 python3 scripts/run_query.py intraday HK-00700 python3 scripts/run_query.py ticker HK-00700 num=10 python3 scripts/run_query.py broker_queue HK-00700 python3 scripts/run_query.py kline HK-00700 num=10 ktype=K_DAY python3 scripts/run_query.py kline HK-00700 from=20260401000000000 to=20260413235959999 ktype=K_DAY autype=NONE python3 scripts/run_query.py capital_flow HK-00700 num=5 python3 scripts/run_query.py basicinfo HK-00700 python3 scripts/run_query.py trading_days HK-00700 start=20260401 end=20260430 python3 scripts/run_query.py us_analysis US-AAPL python3 scripts/run_query.py rank HK market_codes=HK rank_field=raisePercent page=1 page_size=10 python3 scripts/run_query.py ipo_list HK market=HK python3 scripts/run_query.py financial_hk HK-00700 type_code=DT4 year=2024 python3 scripts/run_query.py financial_us US-AAPL type_code=DT4 year=2024 python3 scripts/run_query.py shareholder_inc_red_hold HK market=HK shareholder=EVENT_DATE order_code=DESCEND page=1 page_size=10 python3 scripts/run_query.py shareholder_inc_red_hold_by_ucode HK-00700 shareholder=EVENT_DATE order_code=DESCEND page=1 page_size=10 python3 scripts/run_query.py wealth_balance_list HK python3 scripts/run_query.py wealth_cash_total_asset HK python3 scripts/run_query.py wealth_fixed_income HK productTypeList=NOTE,DEPOSIT_COM toCcy=HKD showTotalAsset=true python3 scripts/run_query.py wealth_private_contract_asset_list HK toCurrency=HKD queryType=ALL positionStatus=HOLDING isPaging=true python3 scripts/run_query.py wealth_total_asset HK toCurrency=HKD ``` 如果脚本返回 `ok=false`，先直接向用户说明失败原因，不要编造数据。 如果用户没有指定 K 线周期与数量，`kline` 默认使用 `num=5`、`ktype=K_DAY`、`autype=NONE`。 如果用户直接用自然语言提问，可优先尝试 `scripts/route_query.py` 做第一轮意图识别，再落到 `scripts/run_query.py`。 当前 `route_query.py` 已支持基础的 K 线周期识别（如日K、周K、月K、5分钟K）与数量识别（如“最近10根”）。 ## Output Style 默认输出顺序： 1. 一句话结论 2. 关键数据 3. 补充观察 4. 数据时间 / 状态说明 要求： - 把枚举值翻译成人话，不直接输出原始枚举代码。 - 对港股 / 美股盘前盘后状态做明确说明。 - 对停牌、退市、无权限订阅、空数据等情况直接说明原因。 - 保持客观，不给买卖建议。 ## Response Mode Rule ### 开发模式 当用户在开发、调试、设计或排查这个 skill 时，可以说明： - 使用了哪个接口 - 请求参数 - 返回结构 - 当前实现逻辑与已知问题 ### 股票帮手模式 当 skill 面向最终用户实际使用时： - 只回答用户需求与结果 - 只展示清晰、简洁、业务化的数据结果 - 不暴露接口 URL、路径、token、脚本名、内部实现逻辑 - 不把开发调试信息带给最终用户 - 如果用户询问“`noah-stock-market` 有什么功能”“你支持什么功能”“这个 skill 能做什么”等能力范围问题，优先用下面这套标准口径回答： `noah-stock-market` 目前支持港股和美股的只读市场数据查询，主要包括： - 个股快照 / 最新行情 - 分时走势 / K线 - 逐笔成交 / 经纪队列 - 市场状态 / 全局市场状态 - 交易日历 - 个股资金流向 - 股票基础信息 - IPO 列表 / 排行榜 - 美股分析 - 港美股财务数据 - 股东增减持信息 - 财富类查询（余额、总资产、固收、私募、现金、银行定存详情） 你可以直接用自然语言提问，比如： - 看一下腾讯现在的股价 - 看腾讯最近 10 根日 K - 查一下腾讯资金流向 - 现在港股开盘了吗 - 看港股涨跌幅排行榜 - 查一下苹果的美股分析 - 看一下腾讯的财务数据 - 查一下腾讯最近的股东增减持 一句话概括就是： `noah-stock-market` 已经覆盖港股 / 美股常用行情查询、结构化分析，以及财务和股东增减持这两类扩展数据能力。 ## Notes - 市场代码当前一期只重点支持港股和美股。 - 港股标准代码格式：`HK-00700` - 美股标准代码格式：`US-AAPL` - token 与 base URL 不写入 skill 正文，从本地 secrets 配置读取。

path: references/README.md
content: # References Index

## Purpose
本目录用于沉淀 `noah-stock-market` 模块的能力边界、安装前提、路由规则、输出策略、已知限制和示例问法。

## Documents
- `auth-and-preflight.md`：鉴权与前置检查说明
- `current-availability.md`：当前能力状态矩阵（Ready / Partial / Unsupported）
- `current-status-summary.md`：当前阶段能力状态摘要
- `edge-cases.md`：已知边界场景与踩坑记录
- `error-catalog.md`：常见错误类型、原因与恢复建议
- `install-troubleshooting.md`：安装与接入排障指南
- `known-limitations.md`：当前环境限制与未开放能力说明
- `market-examples.md`：示例问法与典型查询场景
- `name-resolution.md`：股票名称 / 代码解析规则
- `output-policy.md`：最终用户输出策略与风格规则
- `response-modes.md`：开发模式与股票帮手模式说明
- `routing-and-intents.md`：早期意图与路由说明
- `routing-spec.md`：当前正式路由规格说明
- `usage-guide.md`：使用说明与安装后建议路径

## Suggested Reading Order
1. `current-availability.md`
2. `usage-guide.md`
3. `market-examples.md`
4. `routing-spec.md`
5. `output-policy.md`
6. `edge-cases.md`
7. `install-troubleshooting.md`
8. `error-catalog.md`


path: references/api-mapping.md
content: # API Mapping

## Core Quote Queries

- 最新行情 / 市场快照
  - `/quotes/get_market_snapshot`
  - 返回：`MarketQuote`

- 订阅实时报价（受权限限制）
  - `/quotes/get_stock_quote`
  - 返回：扩展报价数据
  - 仅在用户明确要求订阅级实时数据且接口可用时使用

- 实时分时
  - `/quotes/get_rt_data`
  - 返回：`StockTimeData`

- 实时 K 线
  - `/quotes/get_cur_kline`
  - 返回：`KlineItem`

## Market Depth

- 实时摆盘
  - `/quotes/get_order_book`
  - 返回：`OrderBook`

- 实时逐笔
  - `/quotes/get_rt_ticker`
  - 返回：`TickerItem`

- 实时经纪队列
  - `/quotes/get_broker_queue`
  - 返回：`BrokerQueue`

## Market State

- 个股所属市场状态
  - `/infos/get_market_state`
  - 返回：`MarketStatus`

- 全局市场状态
  - `/quote/get_global_state`
  - 返回：`GlobalStateItem`

- 交易日历
  - `/quote/request_trading_days`
  - 返回：`TradingDayItem`

## Capital Flow

- 个股资金流向
  - `/infos/get_capital_flow`
  - 返回：`CapitalFlowItem`

## Plate / Basic Info

- 板块列表
  - `/quote/get_plate_list`
  - 返回：`PlateItem`

- 板块成分股
  - `/quote/get_plate_stock`
  - 返回：`PlateStockItem`

- 股票基础信息
  - `/quote/get_stock_basicinfo`
  - 返回：`StockBasicInfoItem`

## Derivatives

- 期权到期日
  - `/derivatives/get_option_expiration_date`
  - 返回：`OptionExpirationItem`

- 期权链
  - `/derivatives/get_option_chain`
  - 返回：`OptionChainItem`

- 窝轮 / 牛熊证 / 界内证
  - `/derivatives/get_warrant`
  - 返回：`WarrantItem`

## Advanced (Optional)

- 排行榜
  - `/rank/get_stock_rank`

- IPO 列表
  - `/quote/get_ipo_list`

## Routing Hints

- “现在多少钱 / 最新价 / 快照 / 行情” → `get_market_snapshot`
- “分时 / 实时走势” → `get_rt_data`
- “日K / 周K / 5分钟K / 30天走势” → `get_cur_kline`
- “摆盘 / 五档 / 买卖盘” → `get_order_book`
- “逐笔 / 成交明细” → `get_rt_ticker`
- “经纪队列” → `get_broker_queue`
- “港股/美股开盘了吗 / 市场状态” → `get_global_state` 或 `get_market_state`
- “资金流向 / 主力流入流出” → `get_capital_flow`
- “板块 / 板块成分股” → `get_plate_list` / `get_plate_stock`
- “基本信息 / 上市时间 / 每手股数” → `get_stock_basicinfo`
- “期权到期日 / 期权链” → `get_option_expiration_date` / `get_option_chain`


path: references/auth-and-preflight.md
content: # Auth and Preflight

## Config Source

本 skill 的可执行前提是：必须提供 API token。未配置 token 时，查询脚本不可用。

默认从工作区本地 secrets 文件读取：

- `<repo-or-workspace-root>/.secrets/noah-market.env`

期望字段：
- `NOAH_API_BASE_URL`
- `NOAH_MARKET_APIKEY`

不要把 token 写入 `SKILL.md` 或公开文档。

## Request Auth

- 所有业务请求默认使用 Bearer Token：
  - `Authorization: Bearer <NOAH_MARKET_APIKEY>`
- base URL 使用：
  - `NOAH_API_BASE_URL`

## Preflight Checklist

1. 确认 secrets 文件存在。
2. 确认 `NOAH_API_BASE_URL` 非空。
3. 确认 `NOAH_MARKET_APIKEY` 非空。
4. 确认该值是**公司证券行情服务的 API key**，而不是 GitHub token 或其他平台凭证。
5. 若接口报 401/403，提示用户更新本地 API key，而不是把 key 回显到聊天里。
6. 安装后优先执行 `scripts/smoke_test.py` 验证快照、市场状态与 K 线链路是否可用。
7. 单次查询优先走 `scripts/run_query.py`，避免每次重复手写接口调用逻辑。
8. `/security/get_token` 已不再作为当前 market skill 的鉴权流程；统一使用外部配置 Bearer token。

## Error Handling

- `success=false`：优先展示 `msg`。
- 401 / 403：说明 token 无效或权限不足。
- 404：说明标的、数据或市场映射不存在。
- 500：说明服务端异常，建议稍后重试。
- 有订阅限制的接口（如 `/quotes/get_stock_quote`）失败时，优先回退到更通用的快照接口。


path: references/capital-flow.md
content: # Capital Flow

核心接口：
- `/infos/get_capital_flow`

## Suitable Questions

- 个股资金流向
- 主力资金净流入 / 净流出
- 大单 / 中单 / 小单流向

## Default Output

默认展示：
- 整体净流入
- 主力大单净流入
- 特大单净流入
- 大单 / 中单 / 小单净流入
- 数据有效时间

## Summary Rule

优先总结资金方向：
- 净流入 → 偏强
- 净流出 → 偏弱
- 主力与小单方向相反时，提示分歧

保持客观，不把资金流向直接解释成交易建议。


path: references/current-availability.md
content: # Current Availability

## Market Module Capability Status

| Capability | Status | Notes |
|---|---|---|
| Snapshot / Latest Quote | Ready | 已验证，可用于港股 / 美股快照查询 |
| Market State | Ready | 已验证，可返回市场状态文本 |
| Intraday | Ready | 已验证，支持 detail mode，默认最多展示最近 10 条 |
| Kline | Ready | 已验证 `get_cur_kline` 与 `get_cur_kline_date` 主路径可用；detail mode 已支持 |
| Capital Flow | Ready | 已验证，支持 detail mode；尾部 0 值占位记录已处理 |
| Basic Info | Ready | 已验证，可返回上市日期、每手股数、退市状态等 |
| CN Name Parsing | Partial | 已支持部分常见名称和歧义澄清；目前仍以本地映射为主，未接入正式搜索接口 |
| HK / US Ambiguity Clarification | Ready | 已支持阿里巴巴、百度、京东、哔哩哔哩、蔚来、小鹏、理想等双市场名称澄清 |
| IPO List | Ready | 已验证 `/quote/get_ipo_list` 可用 |
| Rank | Ready | 已按 `references/enum.yaml#/QuoteSortField` 严格取枚举值验证通过 |
| Finance HK / US | Ready | 已验证 `/infos/get_finance_hk_infos` 与 `/infos/get_finance_us_infos` 可用；调用时需使用 `DateTypeConvertUtil` 的 `x-enum-varnames`（如 `DT4`） |
| Shareholder Inc/Red Hold | Ready | 已验证 `/infos/shareholder_inc_red_hold` 与 `/infos/shareholder_inc_red_hold_by_ucode` 可用；调用时需使用 `ShareholderRedHoldEnum` 的 `x-enum-varnames`（如 `EVENT_DATE`） |
| Wealth Balance List | Routed | 已接入 `/wealth/balance_list`，等待统一联调验证 |
| Wealth Cash Total Asset | Routed | 已接入 `/wealth/cash_total_asset`，等待统一联调验证 |
| Wealth Fixed Income | Routed | 已接入 `/wealth/fixed_income`，等待统一联调验证 |
| Wealth Private Contract Asset List | Routed | 已接入 `/wealth/query_private_contract_asset_list`，等待统一联调验证 |
| Wealth Total Asset | Routed | 已接入 `/wealth/total_asset`，等待统一联调验证 |

## Notes

- `Ready`：当前环境已验证可用。
- `Partial`：已有部分能力，但仍受当前环境、标的或名称解析策略限制。
- `Unsupported in current env`：接口存在，但当前环境未正式开放或直接返回错误。

## Product Rules Already Applied

当前 market 模块已落地的产品规则包括：
- 默认优先摘要输出，不直接倾倒原始 JSON
- 用户要求“最近几条 / 明细 / 逐条”时进入 detail mode
- detail mode 默认最多展示最近 10 条记录
- 中文名称存在港股 / 美股歧义时先澄清，不默认猜测
- 资金流向尾部全 0 占位记录会自动忽略

## Related Files

- `references/edge-cases.md`
- `references/known-limitations.md`
- `references/usage-guide.md`


path: references/current-status-summary.md
content: # Current Status Summary

## What is already in place

> 说明：该 skill 的可运行性依赖公司行情服务的 API token。没有 `NOAH_MARKET_APIKEY` 时，只能查看 skill 结构与文档，不能执行真实查询。


- `SKILL.md`：定义 skill 的触发边界、范围和执行规则
- `references/`：已拆分意图映射、鉴权、行情、K线、盘口、资金流向、限制说明、输出模板、使用说明
- `scripts/quote_client.py`：统一 API 访问
- `scripts/normalize_symbol.py`：代码标准化与少量名称 hint
- `scripts/summarize_market.py`：结构化摘要
- `scripts/format_market_text.py`：用户可读文本输出
- `scripts/run_query.py`：统一查询入口
- `scripts/route_query.py`：自然语言路由入口
- `scripts/smoke_test.py`：接口级 smoke test
- `scripts/nl_smoke_test.py`：自然语言 smoke test

## Verified One-Phase Capabilities

- 港股：快照、市场状态、全局市场状态、分时、逐笔、经纪队列、K线、时间区间 K 线、资金流向、基础信息、交易日历、IPO 列表、排行榜、财务数据、股东增减持
- 美股：分析接口 `us_analysis` 已验证可用；财务数据已验证可用
- 自然语言问法：腾讯相关主路径已基本可用
- 枚举协议：已将 `openapi.yaml / enum.yaml / entity.yaml` 沉淀到 skill references，并开始按 enum 严格取值；财务与股东增减持场景已确认需取 `x-enum-varnames`

## Not Yet Ready For Phase-1 Promise

- 股东增减持按时间范围查询（`shareholder_inc_red_hold_by_date`）尚未接入主脚本
- 美股 K 线（当前环境仍需继续确认）

## Recommended Next Step

如果继续开发，优先方向：
1. 排查美股 K 线 404 根因
2. 增强名称解析，减少对本地 hint 的依赖
3. 将 `run_query.py` / `route_query.py` 嵌入真正的 agent 调用流程


path: references/edge-cases.md
content: # Edge Cases

## 1. 港股 / 美股名称歧义
部分中文股票名称同时对应港股和美股，例如：
- 阿里巴巴：`HK-09988` / `US-BABA`
- 百度：`HK-09888` / `US-BIDU`
- 京东：`HK-09618` / `US-JD`
- 哔哩哔哩：`HK-09626` / `US-BILI`
- 蔚来：`HK-09866` / `US-NIO`
- 小鹏：`HK-09868` / `US-XPEV`
- 理想：`HK-02015` / `US-LI`

处理规则：
- 若用户已明确说“港股”或“美股”，则直接路由到对应市场。
- 若用户未明确市场，则先返回澄清提示，不默认猜测。

## 2. 代码格式规范
- 港股统一格式：`HK-00700`
- 美股统一格式：`US-AAPL`
- 输入允许中文名称、裸代码或标准代码，执行时统一转标准格式。

## 3. 资金流向尾部 0 值记录
`capital_flow` 接口在部分标的上，原始返回末尾可能带有全 0 占位记录。

已验证现象：
- `HK-09988` 在 `num=5` 时，原始返回可能是 6 条，其中最后 1 条为全 0。
- `HK-09988` 在 `num=10` 时，原始返回可能是 8 条。
- `HK-00700` 在 `num=10` 时，原始返回可正常返回 10 条，且最新一条为有效数据。

处理规则：
- 默认忽略尾部全 0 占位记录。
- 对外展示有效条数，并保留原始条数字段供开发调试使用。

## 4. detail mode 默认展示上限
当前 detail mode 适用于：
- 资金流向
- K线
- 分时

处理规则：
- 默认最多展示最近 10 条记录。
- 若实际记录超过 10 条，文本中明确提示“仅展示最近 10 条”。

## 5. K线返回条数依赖后端实际数据
即使传入 `num=5` 或 `num=20`，后端实际返回条数仍可能少于请求值。

已验证现象：
- `HK-00700` 某些 K线查询场景下，即使请求多条，当前环境实测只返回 1 条。

处理原则：
- skill 负责按实际返回做摘要或明细展示。
- 不假设后端一定严格返回请求条数。

## 6. 美股 K线当前环境可能返回 404
已验证现象：
- `看苹果5分钟K`
- `看英伟达最近5根周K`

当前路由可正确识别意图与标的，但后端在当前环境下返回 `404`。

处理原则：
- 对用户提示“当前环境下，该标的或该查询参数暂不可用（接口返回 404）”。
- 这属于当前环境限制，不代表路由逻辑本身错误。

## 7. 板块 / 期权能力在当前环境未正式开放
已验证现象：
- `/quote/get_plate_list`：生产环境暂不支持
- `/derivatives/get_option_chain`：生产环境暂不支持
- `/derivatives/get_option_expiration_date`：404

处理原则：
- 这些能力仅保留为未来扩展接口，不作为当前一期主承诺能力。

## 8. 安装成功不等于可真实查询
当前 skill 安装后，还必须配置：
- `NOAH_API_BASE_URL`
- `NOAH_MARKET_APIKEY`

否则：
- skill 可以被识别 / 加载
- 但不能执行真实行情查询

## 9. 不要把 GitHub token 当成行情 API key
已出现过用户把 `ghp_...` GitHub token 错当成 `NOAH_MARKET_APIKEY` 的情况。

处理原则：
- 必须使用公司证券行情服务 API key。
- 文档和错误提示中应明确禁止把 GitHub token / OpenClaw token / 其他平台凭证用于行情接口鉴权。


path: references/entity.yaml
content: 
components:
  schemas:
    AnalysisUSStocks:
      type: object
      description: 美股分析
      properties:
        targetPricePrediction:
          $ref: '#/components/schemas/TargetPricePrediction'
        recommendedByUSStockAnalysts:
          $ref: '#/components/schemas/RecommendedByUSStockAnalysts'

    TargetPricePrediction:
      type: object
      description: 目标价预测
      properties:
        high:
          type: number
          description: 最高目标价
        mean:
          type: number
          description: 平均目标价
        low:
          type: number
          description: 最低目标价
        lastPrice:
          type: number
          description: 最新价
        numOfEstimates:
          type: string
          description: 预测机构数量

    RecommendedByUSStockAnalysts:
      type: object
      description: 美股分析师推荐相关统计
      properties:
        numberOfAnalystsOneWeekAgo:
          type: string
          description: 一周前分析师数量
        averageRating:
          type: string
          description: 平均评级
        averageRatingData:
          type: number
          description: 平均评级数据
        oneWeekAgo:
          $ref: '#/components/schemas/RecommendationsNumResp'
          description: 一周前
        oneMonthAgo:
          $ref: '#/components/schemas/RecommendationsNumResp'
          description: 一月前
        twoMonthAgo:
          $ref: '#/components/schemas/RecommendationsNumResp'
          description: 二月前
        threeMonthAgo:
          $ref: '#/components/schemas/RecommendationsNumResp'
          description: 三月前

    RecommendationsNumResp:
      type: object
      description: 各评级档位数量
      properties:
        strongBuy:
          type: string
          description: 强烈买入
        buy:
          type: string
          description: 买入
        hold:
          type: string
          description: 持有
        sell:
          type: string
          description: 卖出
        strongSell:
          type: string
          description: 强烈卖出

    SecQuoteExtendIndexDto:
      type: object
      description: 证券扩展行情指标（ES sec_extend_index / SecQuoteExtendIndexDto）
      properties:
        # --- Securities ---
        unique_code:
          type: string
          description: 唯一码
        code:
          type: string
        name:
          type: string
        market_code:
          type: string
        genera_type_code:
          type: string
        detail_type_code:
          type: string
        listed_sector_code:
          type: string
        # --- QuoteExtendIndexDto ---
        sec_id:
          type: string
        listed_status_code:
          type: string
        isin:
          type: string
        exg_code:
          type: string
        agg_exg_code:
          type: string
        listed_date_numeral:
          type: integer
          format: int32
        delisted_date_numeral:
          type: integer
          format: int32
        tra_curr_unit_code:
          type: string
        realtime_flag:
          type: string
          description: 实时性标识，1 实时；2 延时
        # --- SecQuoteExtendIndexDto ---
        id:
          type: string
        trading_unit:
          type: integer
          format: int32
        # 板块
        raise_percent5_days:
          type: number
          format: double
        raise_percent10_days:
          type: number
          format: double
        raise_percent20_days:
          type: number
          format: double
        # 股票等
        avg:
          type: number
          format: double
        raise_speed:
          type: number
          format: double
        entrust_ratio:
          type: number
          format: double
        dy_profit:
          type: number
          format: double
        st_profit:
          type: number
          format: double
        pe_dynamic:
          type: number
          format: double
        pe_static:
          type: number
          format: double
        net_asset_per_share:
          type: number
          format: double
        net_asset_exc_min_pro:
          type: number
          format: double
        pna_ratio:
          type: number
          format: double
        total_capital:
          type: integer
          format: int64
        high_price52_weeks:
          type: number
          format: double
        low_price52_weeks:
          type: number
          format: double
        trade_vol_avg_pre5_days:
          type: number
          format: double
        up_limit_time:
          type: string
          format: date-time
        down_limit_time:
          type: string
          format: date-time
        last_opend_board_time:
          type: string
          format: date-time
        close_deal_ratio:
          type: number
          format: double
        up_limit:
          type: number
          format: double
        down_limit:
          type: number
          format: double
        hk_listed_shares:
          type: integer
          format: int64
        hk_market_value:
          type: number
          format: double
        dividend_ttm:
          type: number
          format: double
        dividend_ratio_ttm:
          type: number
          format: double
        dividend_lfy:
          type: number
          format: double
        dividend_ratio_lfy:
          type: number
          format: double
        avg_five_dividend_ratio:
          type: number
          format: double
        # 基金
        iopv:
          type: number
          format: double
        overflow_ratio:
          type: number
          format: double
        net_value:
          type: number
          format: double
        asset_size:
          type: number
          format: double
        share_issued:
          type: number
          format: double
        # 债券
        cbsk_code:
          type: string
        stock_current:
          type: number
          format: double
        stock_change_range:
          type: number
          format: double
        stagflation_percent:
          type: number
          format: double
        convert_bond_price:
          type: number
          format: double
        discount:
          type: number
          format: double
        double_low:
          type: number
          format: double
        convert_bond_date:
          type: string
          format: date-time
        convert_bond_rate:
          type: string
        remain_days:
          type: integer
          format: int32
        pure_bond_premium_ratio:
          type: number
          format: double
        purebond_value:
          type: number
          format: double
        remaining_amount:
          type: number
          format: double
        # 权证
        target_price:
          type: number
          format: double
        perc_of_still_out:
          type: number
          format: double
        ent_ratio:
          type: number
          format: double
        exercise_price:
          type: number
          format: double
        leverage_ratio:
          type: number
          format: double
        break_even_price:
          type: number
          format: double
        effective_gearing:
          type: number
          format: double
        maturity_day:
          type: string
          format: date-time
        last_trade_day:
          type: string
          format: date-time
        p_str_price_spread:
          type: number
          format: double
        p_str_price:
          type: number
          format: double
        lower_strike:
          type: number
          format: double
        upper_strike:
          type: number
          format: double
        delta:
          type: number
          format: double
        implied_volatility:
          type: number
          format: double
        ent_price:
          type: number
          format: double
        in_or_out_price:
          type: number
          format: double
        in_or_out:
          type: string
        # 公共 + 行情
        pe_ratio:
          type: number
          format: double
        circulation_value:
          type: number
          format: double
        market_value:
          type: number
          format: double
        trade_capital:
          type: integer
          format: int64
        amplitude:
          type: number
          format: double
        profit:
          type: number
          format: double
        volume_ratio:
          type: number
          format: double
        exchange:
          type: number
          format: double
        premium_ratio:
          type: number
          format: double
        profit_per_lot:
          type: number
          format: double
        all_raise_percent:
          type: number
          format: double
        pre_close1y:
          type: number
          format: double
        raise_percent1y:
          type: number
          format: double
        pre_close3y:
          type: number
          format: double
        raise_percent3y:
          type: number
          format: double
        pre_close5y:
          type: number
          format: double
        raise_percent5y:
          type: number
          format: double
        pre_close1m:
          type: number
          format: double
        raise_percent1m:
          type: number
          format: double
        pre_close3m:
          type: number
          format: double
        raise_percent3m:
          type: number
          format: double
        pre_close6m:
          type: number
          format: double
        raise_percent6m:
          type: number
          format: double
        pre_close_current1m:
          type: number
          format: double
        pre_close_current1w:
          type: number
          format: double
        pre_close_current1q:
          type: number
          format: double
        raise_percent_current1m:
          type: number
          format: double
        pre_close_ytd:
          type: number
          format: double
        raise_percent_ytd:
          type: number
          format: double
        trade_local_date_time:
          type: string
          format: date-time
        quote_date_time:
          type: string
        last_price:
          type: number
          format: double
        high_price:
          type: number
          format: double
        low_price:
          type: number
          format: double
        open_price:
          type: number
          format: double
        pre_close:
          type: number
          format: double
        raise:
          type: number
          format: double
        raise_percent:
          type: number
          format: double
        total_trade_vol:
          type: integer
          format: int64
        total_turnover:
          type: number
          format: double
        pre_raise_percent:
          type: number
          format: double
        tags:
          type: string
        created_time:
          type: integer
          format: int64
        modified_time:
          type: integer
          format: int64
        inner:
          type: number
          format: double
        outer:
          type: number
          format: double
        decrease_num:
          type: integer
          format: int32
        increase_num:
          type: integer
          format: int32
        not_change_num:
          type: integer
          format: int32
        delay_decrease_num:
          type: integer
          format: int32
        delay_increase_num:
          type: integer
          format: int32
        delay_not_change_num:
          type: integer
          format: int32
        stock_code:
          type: string
        stock_name:
          type: string
        stock_raise:
          type: number
          format: double
        stock_raise_percent:
          type: number
          format: double
        delay_stock_code:
          type: string
        delay_stock_name:
          type: string
        delay_stock_raise:
          type: number
          format: double
        delay_stock_raise_percent:
          type: number
          format: double
        up_limit_num:
          type: integer
          format: int32
        down_limit_num:
          type: integer
          format: int32
        down_num:
          type: integer
          format: int32
        up_num:
          type: integer
          format: int32
        main_net_inflow:
          type: number
          format: double
        st_status:
          type: string
        industry:
          type: string
        concept:
          type: string
        index:
          type: string
        last_ut_opend_board_time:
          type: string
          format: date-time
        nominal_price:
          type: number
          format: double
        connect_status:
          type: string
        warrant_character_code:
          type: integer
          format: int32
        target_code:
          type: string
        target_name:
          type: string
        classification_code:
          type: string
        foreign_exchange_code:
          type: string
        tracking_index_code:
          type: string
        direction:
          type: string
        etf_type_code:
          type: string
        etf_sub_type:
          type: string
        roe:
          type: number
          format: double
        raise_percent_one_year:
          type: number
          format: double
        cn_concept:
          type: string
        star:
          type: string
        bid1_price:
          type: number
          format: double
        ask1_price:
          type: number
          format: double
        currency_one_code:
          type: string
        currency_second_code:
          type: string
        exchange_rate_type_code:
          type: integer
          format: int32
        common_fx_type_code:
          type: integer
          format: int32
        inverse_fx_unique_code:
          type: string
        source_currency:
          type: string
        target_currency:
          type: string
        order_num:
          type: integer
          format: int32
        base_order_num:
          type: integer
          format: int32
        listed_capital:
          type: integer
          format: int64
        net_profit:
          type: number
          format: double
        to_cash_div_rw:
          type: number
          format: double
        eps:
          type: number
          format: double
        diluted_eps:
          type: number
          format: double
        avg_five_dividend:
          type: number
          format: double
        sum_four_eps_ttm:
          type: number
          format: double
          description: 近4季度每股盈利TTM（SG）
    RankResp:
      type: object
      description: 排行榜/行情返回（secRank）
      properties:
        uniqueCode:
          type: string
          description: 唯一编码
        nominalPrice:
          type: number
          format: decimal
          description: 参考价
        lastPrice:
          type: number
          format: decimal
          description: 当前价
        raisePercent:
          type: number
          format: decimal
          description: 涨跌幅
        raise:
          type: number
          format: decimal
          description: 涨跌值
        exchange:
          type: number
          format: decimal
          description: 换手率
        raiseSpeed:
          type: number
          format: decimal
          description: 涨速
        mainNetInflow:
          type: number
          format: decimal
          description: 主力资金净流入
        totalTradeVol:
          type: integer
          format: int64
          description: 成交量
        totalTurnover:
          type: number
          format: decimal
          description: 成交额
        volumeRatio:
          type: number
          format: decimal
          description: 量比
        entrustRatio:
          type: number
          format: decimal
          description: 委比
        amplitude:
          type: number
          format: decimal
          description: 振幅
        highPrice:
          type: number
          format: decimal
          description: 最高
        lowPrice:
          type: number
          format: decimal
          description: 最低
        openPrice:
          type: number
          format: decimal
          description: 今开
        preClose:
          type: number
          format: decimal
          description: 昨收
        peDynamic:
          type: number
          format: decimal
          description: 市盈率动
        peRatio:
          type: number
          format: decimal
          description: 市盈率ttm
        circulationValue:
          type: number
          format: decimal
          description: 流通值
        marketValue:
          type: number
          format: decimal
          description: 总市值
        generaType:
          type: integer
          description: 类别
        detailType:
          type: integer
          description: 子类型
        tags:
          type: string
          description: 标签
        pnaRatio:
          type: number
          format: decimal
          description: 市净率
        roe:
          type: number
          format: decimal
        raisePercentOneYear:
          type: number
          format: decimal
          description: 近一年涨幅
        targetPrice:
          type: number
          format: decimal
          description: 相关资产最新价
        percOfStillOut:
          type: number
          format: decimal
          description: 街货比
        premiumRatio:
          type: number
          format: decimal
          description: 溢价率
        entRatio:
          type: number
          format: decimal
          description: 换股比率
        exercisePrice:
          type: number
          format: decimal
          description: 行使价
        leverageRatio:
          type: number
          format: decimal
          description: 杠杆比率
        breakEvenPrice:
          type: number
          format: decimal
          description: 打和点
        effectiveGearing:
          type: number
          format: decimal
          description: 有效杠杆
        maturityDay:
          type: string
          format: date-time
          description: 到期日
        pStrPriceSpread:
          type: number
          format: decimal
          description: 距收回价
        pStrPrice:
          type: number
          format: decimal
          description: 收回价
        bid1Price:
          type: number
          format: decimal
          description: 申买1-价格
        ask1Price:
          type: number
          format: decimal
          description: 申卖1-价格
        currencyOneCode:
          type: string
          description: 货币对1
        currencySecondCode:
          type: string
          description: 货币对2
        exchangeRateTypeCode:
          type: integer
          description: 汇率类型，0：不确定；1：直接汇率；2：交叉汇率
        commonFxTypeCode:
          type: integer
          description: 常用汇率，0：不是；3：常用汇率
        inverseFxUniqueCode:
          type: string
          description: 反向汇率证券代码
        sourceCurrency:
          type: string
          description: 货币兑换源币种
        targetCurrency:
          type: string
          description: 货币兑换目标币种
        orderNum:
          type: integer
          description: 排序编号
        baseOrderNum:
          type: integer
          description: 基准排序编号
        preClose1y:
          type: number
          format: decimal
          description: 近1年第一个交易日的昨收价
        raisePercent1y:
          type: number
          format: decimal
        preClose3y:
          type: number
          format: decimal
        raisePercent3y:
          type: number
          format: decimal
        preClose5y:
          type: number
          format: decimal
        raisePercent5y:
          type: number
          format: decimal
        prePrice1m:
          type: number
          format: decimal
        raisePercent1m:
          type: number
          format: decimal
        preClose3m:
          type: number
          format: decimal
        raisePercent3m:
          type: number
          format: decimal
        preClose6m:
          type: number
          format: decimal
        raisePercent6m:
          type: number
          format: decimal
        prePriceCurrent1m:
          type: number
          format: decimal
        raisePercentCurrent1m:
          type: number
          format: decimal
        preCloseYtd:
          type: number
          format: decimal
        raisePercentYtd:
          type: number
          format: decimal
        tradeCapital:
          type: integer
          format: int64
          description: 流通股
        totalCapital:
          type: integer
          format: int64
          description: 总股本
        listedCapital:
          type: integer
          format: int64
          description: 已上市股本
        netAssetPerShare:
          type: number
          format: decimal
        rollingNetProfit:
          type: number
          format: decimal
        netProfit:
          type: number
          format: decimal
        toCashDivRw:
          type: number
          format: decimal
        eps:
          type: number
          format: decimal
        dilutedEps:
          type: number
          format: decimal
        profit:
          type: number
          format: decimal
        dyProfit:
          type: number
          format: decimal
        stProfit:
          type: number
          format: decimal
        dividendTtm:
          type: number
          format: decimal
        dividendRatioTtm:
          type: number
          format: decimal
        dividendLfy:
          type: number
          format: decimal
        dividendRatioLfy:
          type: number
          format: decimal
        avgFiveDividend:
          type: number
          format: decimal
        assetSize:
          type: number
          format: decimal
        shareIssued:
          type: number
          format: decimal
    CodeList:
      type: array
      items:
        type: string

    SecResponseList:
      type: object
      description: 请求结果封装类
      properties:
        success:
          type: boolean
          description: 请求结果是否成功
        code:
          type: integer
          description: 错误代码
        msg:
          type: string
          description: 返回提示信息
        data:
          description: 返回查询的数据
          oneOf:
            - $ref: "#/components/schemas/DataList"

    SecResponseData:
      type: object
      description: 请求结果封装类
      properties:
        success:
          type: boolean
          description: 请求结果是否成功
        code:
          type: integer
          description: 错误代码
        msg:
          type: string
          description: 返回提示信息
        data:
          description: 返回查询的数据
          oneOf:
            - $ref: "#/components/schemas/OrderBook"
            - $ref: "#/components/schemas/BrokerQueue"
            - $ref: "#/components/schemas/AnalysisUSStocks"
            - $ref: "#/components/schemas/HKStockFinancial"
            - $ref: "#/components/schemas/USStockFinancial"

    DataList:
      type: array
      items:
        oneOf:
          - $ref: "#/components/schemas/RankResp"
          - $ref: "#/components/schemas/SecQuoteExtendIndexDto"
          - $ref: "#/components/schemas/MarketQuote"
          - $ref: "#/components/schemas/KlineItem"
          - $ref: "#/components/schemas/StockTimeData"
          - $ref: "#/components/schemas/TickerItem"
          - $ref: "#/components/schemas/MarketStatus"
          - $ref: "#/components/schemas/CapitalFlowItem"
          - $ref: "#/components/schemas/OptionChainItem"
          - $ref: "#/components/schemas/OptionExpirationItem"
          - $ref: "#/components/schemas/WarrantItem"
          - $ref: "#/components/schemas/PlateItem"
          - $ref: "#/components/schemas/PlateStockItem"
          - $ref: "#/components/schemas/StockBasicInfoItem"
          - $ref: "#/components/schemas/IpoItem"
          - $ref: "#/components/schemas/TradingDayItem"
          - $ref: "#/components/schemas/GlobalStateItem"
          - $ref: "#/components/schemas/StockFilterItem"
          - $ref: "#/components/schemas/SecStockFilter"
          - $ref: "#/components/schemas/CandleOpenApiDotResp"
          - $ref: "#/components/schemas/MxShareholderOpenApiIncRedHoldResp"

    MarketStatus:
      type: object
      description: 市场状态
      properties:
        code:
          type: string
          description: 股票代码
        stock_name:
          type: string
          description: 股票名称
        market_state:
          type: string
          description: 市场状态
          allOf:
            - $ref: "enum.yaml#/MarketTradingState"

    MxShareholderOpenApiIncRedHoldResp:
      type: object
      description: 股东增持减持持仓明细（MxShareholderOpenApiIncRedHoldResp）
      properties:
        id:
          type: string
          description: 记录/主体标识
        name:
          type: string
          description: 股东名称
        transDate:
          type: string
          description: 交易或变更日期（字符串）
        adjSharesTraded:
          type: number
          format: decimal
          description: 调整后成交股数
        changedAmount:
          type: number
          format: decimal
          description: 变动金额
        holdSumBefEvent:
          type: number
          format: decimal
          description: 事件前持股合计
        holdSumAfEvent:
          type: number
          format: decimal
          description: 事件后持股合计
        variableQuantityRatio:
          type: number
          format: decimal
          description: 变动数量比例
        uniqueCode:
          type: string
          description: 证券唯一码
        secName:
          type: string
          description: 证券名称
        exgCode:
          type: string
          description: 交易所代码

    CapitalFlowItem:
      type: object
      description: 资金流向数据项
      properties:
        in_flow:
          type: number
          format: decimal
          description: 整体净流入
        main_in_flow:
          type: number
          format: decimal
          description: 主力大单净流入
        super_in_flow:
          type: number
          format: decimal
          description: 特大单净流入
        big_in_flow:
          type: number
          format: decimal
          description: 大单净流入
        mid_in_flow:
          type: number
          format: decimal
          description: 中单净流入
        sml_in_flow:
          type: number
          format: decimal
          description: 小单净流入
        capital_flow_item_time:
          type: string
          description: 开始时间
        last_valid_time:
          type: string
          description: 数据最后有效时间

    StockTimeData:
      type: object
      description: 股票时间行情数据
      properties:
        code:
          type: string
          description: 股票代码
        name:
          type: string
          description: 股票名称
        time:
          type: string
          description: 时间
        is_blank:
          type: boolean
          description: 数据状态
        opened_mins:
          type: integer
          description: 零点到当前多少分钟
        cur_price:
          type: number
          format: decimal
          description: 当前价格
        last_close:
          type: number
          format: decimal
          description: 昨天收盘的价格
        avg_price:
          type: number
          format: decimal
          description: 平均价格
        volume:
          type: number
          format: decimal
          description: 成交量
        turnover:
          type: number
          format: decimal
          description: 成交金额

    KlineItem:
      type: object
      description: 股票行情数据
      properties:
        code:
          type: string
          description: 股票代码
        name:
          type: string
          description: 股票名称
        time_key:
          type: string
          description: 时间
        open:
          type: number
          format: decimal
          description: 开盘价
        close:
          type: number
          format: decimal
          description: 收盘价
        high:
          type: number
          format: decimal
          description: 最高价
        low:
          type: number
          format: decimal
          description: 最低价
        volume:
          type: integer
          description: 成交量
        turnover:
          type: number
          format: decimal
          description: 成交额
        pe_ratio:
          type: number
          format: decimal
          description: 市盈率
        turnover_rate:
          type: number
          format: decimal
          description: 换手率
        last_close:
          type: number
          format: decimal
          description: 昨收价

    CandleOpenApiDotResp:
      type: object
      description: K 线/蜡烛图单点行情（CandleDotResp）
      properties:
        uniqueCode:
          type: string
          description: 证券唯一码
        type:
          type: string
          description: 类型
        afType:
          type: string
          description: 复权类型等
        preClose:
          type: number
          format: decimal
          description: 昨收价
        highPrice:
          type: number
          format: decimal
          description: 最高价
        lowPrice:
          type: number
          format: decimal
          description: 最低价
        openPrice:
          type: number
          format: decimal
          description: 开盘价
        closePrice:
          type: number
          format: decimal
          description: 收盘价
        raisePercent:
          type: number
          format: decimal
          description: 涨跌幅
        raise:
          type: number
          format: decimal
          description: 涨跌额
        tradeDateTime:
          type: string
          description: 交易时间（字符串，如 yyyyMMddHHmmssSSS）
        tradeVol:
          type: integer
          format: int64
          description: 成交量
        tradeVolBd:
          type: number
          format: decimal
          description: 成交量（BigDecimal）
        tradeCount:
          type: integer
          format: int64
          description: 成交笔数
        turnover:
          type: number
          format: decimal
          description: 成交额
        phTradeVol:
          type: number
          format: decimal
          description: 盘后成交量等
        phTurnover:
          type: number
          format: decimal
          description: 盘后成交额等
        amplitude:
          type: number
          format: decimal
          description: 振幅
        exchange:
          type: number
          format: decimal
          description: 委比
        currTurnover:
          type: number
          format: decimal
          description: 当前成交额
        currTradeVol:
          type: integer
          format: int64
          description: 当前成交量
        currTradeVolBd:
          type: number
          format: decimal
          description: 当前成交量（BigDecimal）
        sequenceNo:
          type: integer
          format: int64
          description: 序号
        tradingStageType:
          type: string
          description: 交易阶段类型
        realtimeFlag:
          type: string
          description: 实时性标识
        totalShares:
          type: integer
          format: int64
          description: 总股本
        marketValue:
          type: number
          format: decimal
          description: 市值

    OrderBook:
      type: object
      properties:
        code:
          type: string
          description: 股票代码
        name:
          type: string
          description: 股票名称
        svr_recv_time_bid:
          type: string
          description: 诺亚服务器从交易所收到买盘数据的时间
        svr_recv_time_ask:
          type: string
          description: 诺亚服务器从交易所收到卖盘数据的时间
        bid:
          type: array
          items:
            $ref: '#/components/schemas/Order'
        ask:
          type: array
          items:
            $ref: '#/components/schemas/Order'

    TickerItem:
      type: object
      description: 逐笔成交数据
      properties:
        code:
          type: string
          description: 股票代码
        name:
          type: string
          description: 股票名称
        sequence:
          type: integer
          description: 逐笔序号
        time:
          type: string
          description: 成交时间
        price:
          type: number
          format: decimal
          description: 成交价格
        volume:
          type: integer
          description: 成交数量
        turnover:
          type: number
          format: decimal
          description: 成交金额
        ticker_direction:
          type: string
          description: 逐笔方向
          allOf:
            - $ref: 'enum.yaml#/TickerDirect'
        type:
          type: string
          description: 逐笔类型
          allOf:
            - $ref: 'enum.yaml#/TickerType'

    Order:
      type: object
      properties:
        price:
          type: number
          description: 委托价格
        quantity:
          type: number
          description: 委托数量
        order_quantity:
          type: number
          description: 委托订单数
        details:
          type: object

    MarketQuote:
      type: object
      properties:
        code:
          type: string
          description: 股票代码
        name:
          type: string
          description: 股票名称
        data_date:
          type: string
          description: 日期
        data_time:
          type: string
          description: 当前价更新时间
        last_price:
          type: number
          format: decimal
          description: 最新价格

        open_price:
          type: number
          format: decimal
          description: 今日开盘价
        high_price:
          type: number
          format: decimal
          description: 最高价格
        low_price:
          type: number
          format: decimal
          description: 最低价格
        prev_close_price:
          type: number
          format: decimal
          description: 昨收盘价格
        volume:
          type: integer
          description: 成交数量
        turnover:
          type: number
          format: decimal
          description: 成交金额
        turnover_rate:
          type: number
          format: decimal
          description: 换手率
        amplitude:
          type: number
          format: decimal
          description: 振幅
        suspension:
          type: boolean
          description: 是否停牌
        listing_date:
          type: string
          description: 上市日期
        price_spread:
          type: number
          format: decimal
          description: 当前向上的价差

        dark_status:
          allOf:
            - $ref: "enum.yaml#/DarkStatus"
          description: 暗盘交易状态 (DarkStatus)
        sec_status:
          allOf:
            - $ref: "enum.yaml#/SecurityStatus"
          description: 股票状态 (SecurityStatus)

        strike_price:
          type: number
          format: decimal
          description: 行权价
        contract_size:
          type: number
          format: decimal
          description: 每份合约数
        open_interest:
          type: integer
          description: 未平仓合约数
        implied_volatility:
          type: number
          format: decimal
          description: 隐含波动率
        premium:
          type: number
          format: decimal
          description: 溢价
        delta:
          type: number
          format: decimal
          description: 希腊值 Delta
        gamma:
          type: number
          format: decimal
          description: 希腊值 Gamma
        vega:
          type: number
          format: decimal
          description: 希腊值 Vega
        theta:
          type: number
          format: decimal
          description: 希腊值 Theta
        rho:
          type: number
          format: decimal
          description: 希腊值 Rho

        index_option_type:
          allOf:
            - $ref: "enum.yaml#/IndexOptionType"
          description: 指数期权类型 (IndexOptionType)
        net_open_interest:
          type: integer
          description: 净未平仓合约数
        expiry_date_distance:
          type: integer
          description: 距离到期日天数
        contract_nominal_value:
          type: number
          format: decimal
          description: 合约名义金额
        owner_lot_multiplier:
          type: number
          format: decimal
          description: 相等正股手数
        option_area_type:
          allOf:
            - $ref: "enum.yaml#/OptionAreaType"
          description: 期权类型 (按行权时间) (OptionAreaType)
        contract_multiplier:
          type: number
          format: decimal
          description: 合约乘数

        pre_price:
          type: number
          format: decimal
          description: 盘前价格
        pre_high_price:
          type: number
          format: decimal
          description: 盘前最高价
        pre_low_price:
          type: number
          format: decimal
          description: 盘前最低价
        pre_volume:
          type: integer
          description: 盘前成交量
        pre_turnover:
          type: number
          format: decimal
          description: 盘前成交额
        pre_change_val:
          type: number
          format: decimal
          description: 盘前涨跌额
        pre_change_rate:
          type: number
          format: decimal
          description: 盘前涨跌幅
        pre_amplitude:
          type: number
          format: decimal
          description: 盘前振幅

        after_price:
          type: number
          format: decimal
          description: 盘后价格
        after_high_price:
          type: number
          format: decimal
          description: 盘后最高价
        after_low_price:
          type: number
          format: decimal
          description: 盘后最低价
        after_volume:
          type: integer
          description: 盘后成交量
        after_turnover:
          type: number
          format: decimal
          description: 盘后成交额
        after_change_val:
          type: number
          format: decimal
          description: 盘后涨跌额
        after_change_rate:
          type: number
          format: decimal
          description: 盘后涨跌幅
        after_amplitude:
          type: number
          format: decimal
          description: 盘后振幅

        overnight_price:
          type: number
          format: decimal
          description: 夜盘价格
        overnight_high_price:
          type: number
          format: decimal
          description: 夜盘最高价
        overnight_low_price:
          type: number
          format: decimal
          description: 夜盘最低价
        overnight_volume:
          type: integer
          description: 夜盘成交量
        overnight_turnover:
          type: number
          format: decimal
          description: 夜盘成交额
        overnight_change_val:
          type: number
          format: decimal
          description: 夜盘涨跌额
        overnight_change_rate:
          type: number
          format: decimal
          description: 夜盘涨跌幅
        overnight_amplitude:
          type: number
          format: decimal
          description: 夜盘振幅

        last_settle_price:
          type: number
          format: decimal
          description: 昨结
        position:
          type: number
          format: decimal
          description: 持仓量
        position_change:
          type: number
          format: decimal
          description: 日增仓

    BrokerQueue:
      type: object
      description: 买卖盘经济队列
      properties:
        bid_frame_table:
          type: array
          description: 返回买盘经纪队列数据
          items:
            $ref: "#/components/schemas/BidBrokerOrderItem"
        ask_frame_table:
          type: array
          description: 返回卖盘经纪队列数据
          items:
            $ref: "#/components/schemas/AskBrokerOrderItem"

    AskBrokerOrderItem:
      type: object
      description: 经纪卖盘订单信息
      properties:
        code:
          type: string
          description: 股票代码
        name:
          type: string
          description: 股票名称
        ask_broker_id:
          type: integer
          description: 经纪卖盘ID
        ask_broker_name:
          type: string
          description: 经纪卖盘名称
        ask_broker_pos:
          type: integer
          description: 经纪档位
        order_id:
          type: integer
          description: 交易所订单ID
        order_volume:
          type: integer
          description: 单笔委托数量

    BidBrokerOrderItem:
      type: object
      description: 经纪买盘订单信息
      properties:
        code:
          type: string
          description: 股票代码
        name:
          type: string
          description: 股票名称
        bid_broker_id:
          type: integer
          description: 经纪买盘 ID
        bid_broker_name:
          type: string
          description: 经纪买盘名称
        bid_broker_pos:
          type: integer
          description: 经纪档位
        order_id:
          type: integer
          description: 交易所订单 ID
        order_volume:
          type: integer
          description: 单笔委托数量

    OptionChainItem:
      type: object
      description: 期权链单项（参考 Futu get_option_chain）
      properties:
        code:
          type: string
          description: 期权合约代码
        name:
          type: string
          description: 期权名称
        lot_size:
          type: integer
          description: 每手股数/每份合约股数
        stock_owner:
          type: string
          description: 标的股代码
        strike_time:
          type: string
          description: 行权日 yyyy-MM-dd
        strike_price:
          type: number
          format: decimal
          description: 行权价
        option_type:
          type: string
          description: 期权类型
        suspension:
          type: boolean
          description: 是否停牌
        stock_id:
          type: integer
          description: 股票 ID

    OptionExpirationItem:
      type: object
      description: 期权到期日（参考 Futu get_option_expiration_date）
      properties:
        expiration_date:
          type: string
          description: 到期日 yyyy-MM-dd

    WarrantItem:
      type: object
      description: 窝轮/牛熊证/界内证单项（参考 Futu get_warrant，港股）
      properties:
        code:
          type: string
          description: 窝轮代码
        name:
          type: string
          description: 名称
        stock_owner:
          type: string
          description: 所属正股代码
        warrant_type:
          type: string
          description: 窝轮类型
        maturity_time:
          type: string
          description: 到期日 yyyy-MM-dd
        list_time:
          type: string
          description: 上市时间 yyyy-MM-dd
        last_trade_time:
          type: string
          description: 最后交易日 yyyy-MM-dd
        strike_price:
          type: number
          format: decimal
          description: 行使价
        recovery_price:
          type: number
          format: decimal
          description: 收回价（牛熊证）
        conversion_ratio:
          type: number
          format: decimal
          description: 换股比率
        lot_size:
          type: integer
          description: 每手数量
        cur_price:
          type: number
          format: decimal
          description: 当前价
        last_close_price:
          type: number
          format: decimal
          description: 昨收价
        premium:
          type: number
          format: decimal
          description: 溢价（百分比）
        leverage_ratio:
          type: number
          format: decimal
          description: 杠杆比率
        volume:
          type: integer
          description: 成交量
        turnover:
          type: number
          format: decimal
          description: 成交额

    PlateItem:
      type: object
      description: 板块信息（对应 Futu get_plate_list）
      properties:
        code:
          type: string
          description: 板块代码
        plate_name:
          type: string
          description: 板块名称
        plate_id:
          type: string
          description: 板块 ID

    PlateStockItem:
      type: object
      description: 板块内股票（对应 Futu get_plate_stock）
      properties:
        code:
          type: string
          description: 股票代码
        stock_name:
          type: string
          description: 股票名称
        lot_size:
          type: integer
          description: 每手股数
        list_time:
          type: string
          description: 上市时间 yyyy-MM-dd
        stock_id:
          type: string
          description: 股票 ID

    StockBasicInfoItem:
      type: object
      description: 股票静态信息（对应 Futu get_stock_basicinfo / GetStaticInfo）
      properties:
        code:
          type: string
          description: 股票代码
        name:
          type: string
          description: 股票名称
        lot_size:
          type: integer
          description: 每手股数
        listing_date:
          type: string
          description: 上市日期 yyyy-MM-dd
        stock_id:
          type: integer
          description: 股票 ID
        delisting:
          type: boolean
          description: 是否退市

    IpoItem:
      type: object
      description: IPO 信息（对应 Futu get_ipo_list）
      properties:
        code:
          type: string
          description: 股票代码
        name:
          type: string
          description: 股票名称
        list_time:
          type: string
          description: 上市日期（美股是预计上市日期）
        list_timestamp:
          type: integer
          format: int64
          description: 上市日期时间戳（美股是预计上市日期时间戳）
        apply_code:
          type: string
          description: 申购代码（A股适用）
        issue_size:
          type: integer
          description: 发行总数（A股适用/发行量，非 A 股适用情况请以返回为空为准）
        online_issue_size:
          type: integer
          description: 网上发行量（A股适用/发行量，非 A 股适用情况请以返回为空为准）
        apply_upper_limit:
          type: integer
          description: 申购上限（A股适用/申购上限）
        apply_limit_market_value:
          type: integer
          description: 顶格申购需配市值（A股适用）
        is_estimate_ipo_price:
          type: boolean
          description: 是否预估发行价（A股适用）
        ipo_price:
          type: number
          format: decimal
          description: 发行价（A股适用）
        industry_pe_rate:
          type: number
          format: decimal
          description: 行业市盈率（A股适用）
        is_estimate_winning_ratio:
          type: boolean
          description: 是否预估中签率（A股适用）
        winning_ratio:
          type: number
          format: decimal
          description: 中签率（A股适用）
        issue_pe_rate:
          type: number
          format: decimal
          description: 发行市盈率（A股适用）
        apply_time:
          type: string
          description: 申购开始日期（A股适用）
        apply_timestamp:
          type: integer
          format: int64
          description: 申购开始日期时间戳（A股适用）
        winning_time:
          type: string
          description: 公布中签日期（A股适用）
        winning_timestamp:
          type: integer
          format: int64
          description: 公布中签日期时间戳（A股适用）
        is_has_won:
          type: boolean
          description: 是否已经公布中签号（A股适用）
        winning_num_data:
          type: string
          description: 中签号数据（A股适用）
        ipo_price_min:
          type: number
          format: decimal
          description: 最低发行价（港股/美股适用情况以返回为空为准）
        ipo_price_max:
          type: number
          format: decimal
          description: 最高发行价（港股/美股适用情况以返回为空为准）
        list_price:
          type: number
          format: decimal
          description: 上市价格（港股适用）
        lot_size:
          type: integer
          description: 每手股数
        entrance_price:
          type: number
          format: decimal
          description: 入场费（港股适用）
        is_subscribe_status:
          type: boolean
          description: 是否为认购状态
        apply_end_time:
          type: string
          description: 预计/实际申购结束日期（港股/美股/其他市场以返回为空为准）
        apply_end_timestamp:
          type: integer
          format: int64
          description: 预计/实际申购结束日期时间戳

    TradingDayItem:
      type: object
      description: 交易日（对应 Futu request_trading_days）
      properties:
        date:
          type: string
          description: 日期 yyyy-MM-dd
        is_trading_day:
          type: boolean
          description: 是否交易日

    GlobalStateItem:
      type: object
      description: 全局市场状态（对应 Futu get_global_state）
      properties:
        market:
          type: string
          description: 市场
        market_state:
          type: string
          description: 市场状态
        trade_session:
          type: string
          description: 交易时段

    SecStockFilter:
      type: object
      description: 条件选股合并结果（量化策略 StockFilterQuantitativeStrategy + 扩展行情 SecQuoteExtendIndexDto）
      properties:
        agg_exg_code:
          type: string
          description: aggExgCode (String)
        all_raise_percent:
          type: number
          format: decimal
          description: allRaisePercent (BigDecimal)
        amplitude:
          type: number
          format: decimal
          description: amplitude (BigDecimal)
        ask1_price:
          type: number
          format: decimal
          description: ask1Price (BigDecimal)
        asset_size:
          type: number
          format: decimal
          description: assetSize (BigDecimal)
        avg:
          type: number
          format: decimal
          description: avg (BigDecimal)
        avg_five_dividend:
          type: number
          format: decimal
          description: avgFiveDividend (BigDecimal)
        avg_five_dividend_ratio:
          type: number
          format: decimal
          description: avgFiveDividendRatio (BigDecimal)
        base_order_num:
          type: integer
          description: baseOrderNum (Integer)
        bid1_price:
          type: number
          format: decimal
          description: bid1Price (BigDecimal)
        boll_break_lower:
          type: boolean
          description: bollBreakLower (Boolean)
        boll_break_upper:
          type: boolean
          description: bollBreakUpper (Boolean)
        boll_cross_middle_down:
          type: boolean
          description: bollCrossMiddleDown (Boolean)
        boll_cross_middle_up:
          type: boolean
          description: bollCrossMiddleUp (Boolean)
        break_even_price:
          type: number
          format: decimal
          description: breakEvenPrice (BigDecimal)
        cbsk_code:
          type: string
          description: cbskCode (String)
        circulation_value:
          type: number
          format: decimal
          description: circulationValue (BigDecimal)
        classification_code:
          type: string
          description: classificationCode (String)
        close:
          type: number
          format: decimal
          description: close (BigDecimal)
        close_deal_ratio:
          type: number
          format: decimal
          description: closeDealRatio (BigDecimal)
        cn_concept:
          type: string
          description: cnConcept (String)
        code:
          type: string
          description: code (String)
        common_fx_type_code:
          type: integer
          description: commonFxTypeCode (Integer)
        concept:
          type: string
          description: concept (String)
        connect_status:
          type: string
          description: connectStatus (String)
        convert_bond_date:
          type: string
          format: date-time
          description: convertBondDate (Date)
        convert_bond_price:
          type: number
          format: decimal
          description: convertBondPrice (BigDecimal)
        convert_bond_rate:
          type: string
          description: convertBondRate (String)
        created_time:
          type: integer
          format: int64
          description: createdTime (Long)
        currency_one_code:
          type: string
          description: currencyOneCode (String)
        currency_second_code:
          type: string
          description: currencySecondCode (String)
        d:
          type: number
          format: decimal
          description: d (BigDecimal)
        dea:
          type: number
          format: decimal
          description: dea (BigDecimal)
        decrease_num:
          type: integer
          description: decreaseNum (Integer)
        delay_decrease_num:
          type: integer
          description: delayDecreaseNum (Integer)
        delay_increase_num:
          type: integer
          description: delayIncreaseNum (Integer)
        delay_not_change_num:
          type: integer
          description: delayNotChangeNum (Integer)
        delay_stock_code:
          type: string
          description: delayStockCode (String)
        delay_stock_name:
          type: string
          description: delayStockName (String)
        delay_stock_raise:
          type: number
          format: decimal
          description: delayStockRaise (BigDecimal)
        delay_stock_raise_percent:
          type: number
          format: decimal
          description: delayStockRaisePercent (BigDecimal)
        delisted_date_numeral:
          type: integer
          description: delistedDateNumeral (Integer)
        delta:
          type: number
          format: decimal
          description: delta (BigDecimal)
        detail_type_code:
          type: string
          description: detailTypeCode (String)
        dif:
          type: number
          format: decimal
          description: dif (BigDecimal)
        diluted_eps:
          type: number
          format: decimal
          description: dilutedEps (BigDecimal)
        direction:
          type: string
          description: direction (String)
        discount:
          type: number
          format: decimal
          description: discount (BigDecimal)
        dividend_lfy:
          type: number
          format: decimal
          description: dividendLfy (BigDecimal)
        dividend_ratio_lfy:
          type: number
          format: decimal
          description: dividendRatioLfy (BigDecimal)
        dividend_ratio_ttm:
          type: number
          format: decimal
          description: dividendRatioTtm (BigDecimal)
        dividend_ttm:
          type: number
          format: decimal
          description: dividendTtm (BigDecimal)
        double_low:
          type: number
          format: decimal
          description: doubleLow (BigDecimal)
        down_limit:
          type: number
          format: decimal
          description: downLimit (BigDecimal)
        down_limit_num:
          type: integer
          description: downLimitNum (Integer)
        down_limit_time:
          type: string
          format: date-time
          description: downLimitTime (Date)
        down_num:
          type: integer
          description: downNum (Integer)
        dy_profit:
          type: number
          format: decimal
          description: dyProfit (BigDecimal)
        effective_gearing:
          type: number
          format: decimal
          description: effectiveGearing (BigDecimal)
        ema10:
          type: number
          format: decimal
          description: ema10 (BigDecimal)
        ema12:
          type: number
          format: decimal
          description: ema12 (BigDecimal)
        ema20:
          type: number
          format: decimal
          description: ema20 (BigDecimal)
        ema26:
          type: number
          format: decimal
          description: ema26 (BigDecimal)
        ema30:
          type: number
          format: decimal
          description: ema30 (BigDecimal)
        ema5:
          type: number
          format: decimal
          description: ema5 (BigDecimal)
        ema60:
          type: number
          format: decimal
          description: ema60 (BigDecimal)
        ema_long:
          type: boolean
          description: emaLong (Boolean)
        ema_short:
          type: boolean
          description: emaShort (Boolean)
        ent_price:
          type: number
          format: decimal
          description: entPrice (BigDecimal)
        ent_ratio:
          type: number
          format: decimal
          description: entRatio (BigDecimal)
        entrust_ratio:
          type: number
          format: decimal
          description: entrustRatio (BigDecimal)
        eps:
          type: number
          format: decimal
          description: eps (BigDecimal)
        etf_sub_type:
          type: string
          description: etfSubType (String)
        etf_type_code:
          type: string
          description: etfTypeCode (String)
        exchange:
          type: number
          format: decimal
          description: exchange (BigDecimal)
        exchange_rate_type_code:
          type: integer
          description: exchangeRateTypeCode (Integer)
        exercise_price:
          type: number
          format: decimal
          description: exercisePrice (BigDecimal)
        exg_code:
          type: string
          description: exgCode (String)
        foreign_exchange_code:
          type: string
          description: foreignExchangeCode (String)
        genera_type_code:
          type: string
          description: generaTypeCode (String)
        high_price:
          type: number
          format: decimal
          description: highPrice (BigDecimal)
        high_price52_weeks:
          type: number
          format: decimal
          description: highPrice52Weeks (BigDecimal)
        hk_listed_shares:
          type: integer
          format: int64
          description: hkListedShares (Long)
        hk_market_value:
          type: number
          format: decimal
          description: hkMarketValue (BigDecimal)
        id:
          type: string
          description: id (String)
        implied_volatility:
          type: number
          format: decimal
          description: impliedVolatility (BigDecimal)
        in_or_out:
          type: string
          description: inOrOut (String)
        in_or_out_price:
          type: number
          format: decimal
          description: inOrOutPrice (BigDecimal)
        increase_num:
          type: integer
          description: increaseNum (Integer)
        index:
          type: string
          description: index (String)
        industry:
          type: string
          description: industry (String)
        inner:
          type: number
          format: decimal
          description: inner (BigDecimal)
        inverse_fx_unique_code:
          type: string
          description: inverseFxUniqueCode (String)
        iopv:
          type: number
          format: decimal
          description: iopv (BigDecimal)
        isin:
          type: string
          description: isin (String)
        j:
          type: number
          format: decimal
          description: j (BigDecimal)
        k:
          type: number
          format: decimal
          description: k (BigDecimal)
        kdj_death_cross_high:
          type: boolean
          description: kdjDeathCrossHigh (Boolean)
        kdj_gold_cross_low:
          type: boolean
          description: kdjGoldCrossLow (Boolean)
        last_opend_board_time:
          type: string
          format: date-time
          description: lastOpendBoardTime (Date)
        last_price:
          type: number
          format: decimal
          description: lastPrice (BigDecimal)
        last_trade_day:
          type: string
          format: date-time
          description: lastTradeDay (Date)
        last_ut_opend_board_time:
          type: string
          format: date-time
          description: lastUtOpendBoardTime (Date)
        lb:
          type: number
          format: decimal
          description: lb (BigDecimal)
        leverage_ratio:
          type: number
          format: decimal
          description: leverageRatio (BigDecimal)
        listed_capital:
          type: integer
          format: int64
          description: listedCapital (Long)
        listed_date_numeral:
          type: integer
          description: listedDateNumeral (Integer)
        listed_sector_code:
          type: string
          description: listedSectorCode (String)
        listed_status_code:
          type: string
          description: listedStatusCode (String)
        long_rsi:
          type: number
          format: decimal
          description: longRSI (BigDecimal)
        low_price:
          type: number
          format: decimal
          description: lowPrice (BigDecimal)
        low_price52_weeks:
          type: number
          format: decimal
          description: lowPrice52Weeks (BigDecimal)
        lower_strike:
          type: number
          format: decimal
          description: lowerStrike (BigDecimal)
        ma10:
          type: number
          format: decimal
          description: ma10 (BigDecimal)
        ma20:
          type: number
          format: decimal
          description: ma20 (BigDecimal)
        ma30:
          type: number
          format: decimal
          description: ma30 (BigDecimal)
        ma5:
          type: number
          format: decimal
          description: ma5 (BigDecimal)
        ma60:
          type: number
          format: decimal
          description: ma60 (BigDecimal)
        ma_long:
          type: boolean
          description: maLong (Boolean)
        ma_short:
          type: boolean
          description: maShort (Boolean)
        macd:
          type: number
          format: decimal
          description: macd (BigDecimal)
        macd_death_cross_high:
          type: boolean
          description: macdDeathCrossHigh (Boolean)
        macd_gold_cross_low:
          type: boolean
          description: macdGoldCrossLow (Boolean)
        main_net_inflow:
          type: number
          format: decimal
          description: mainNetInflow (BigDecimal)
        market_code:
          type: string
          description: marketCode (String)
        market_value:
          type: number
          format: decimal
          description: marketValue (BigDecimal)
        maturity_day:
          type: string
          format: date-time
          description: maturityDay (Date)
        mb:
          type: number
          format: decimal
          description: mb (BigDecimal)
        modified_time:
          type: integer
          format: int64
          description: modifiedTime (Long)
        name:
          type: string
          description: name (String)
        net_asset_exc_min_pro:
          type: number
          format: decimal
          description: netAssetExcMinPro (BigDecimal)
        net_asset_per_share:
          type: number
          format: decimal
          description: netAssetPerShare (BigDecimal)
        net_profit:
          type: number
          format: decimal
          description: netProfit (BigDecimal)
        net_value:
          type: number
          format: decimal
          description: netValue (BigDecimal)
        nominal_price:
          type: number
          format: decimal
          description: nominalPrice (BigDecimal)
        not_change_num:
          type: integer
          description: notChangeNum (Integer)
        open_price:
          type: number
          format: decimal
          description: openPrice (BigDecimal)
        order_num:
          type: integer
          description: orderNum (Integer)
        outer:
          type: number
          format: decimal
          description: outer (BigDecimal)
        overflow_ratio:
          type: number
          format: decimal
          description: overflowRatio (BigDecimal)
        p_str_price:
          type: number
          format: decimal
          description: pStrPrice (BigDecimal)
        p_str_price_spread:
          type: number
          format: decimal
          description: pStrPriceSpread (BigDecimal)
        pe_dynamic:
          type: number
          format: decimal
          description: peDynamic (BigDecimal)
        pe_ratio:
          type: number
          format: decimal
          description: peRatio (BigDecimal)
        pe_static:
          type: number
          format: decimal
          description: peStatic (BigDecimal)
        peak:
          type: boolean
          description: peak (Boolean)
        perc_of_still_out:
          type: number
          format: decimal
          description: percOfStillOut (BigDecimal)
        pna_ratio:
          type: number
          format: decimal
          description: pnaRatio (BigDecimal)
        pre_close:
          type: number
          format: decimal
          description: preClose (BigDecimal)
        pre_close1m:
          type: number
          format: decimal
          description: preClose1m (BigDecimal)
        pre_close1y:
          type: number
          format: decimal
          description: preClose1y (BigDecimal)
        pre_close3m:
          type: number
          format: decimal
          description: preClose3m (BigDecimal)
        pre_close3y:
          type: number
          format: decimal
          description: preClose3y (BigDecimal)
        pre_close5y:
          type: number
          format: decimal
          description: preClose5y (BigDecimal)
        pre_close6m:
          type: number
          format: decimal
          description: preClose6m (BigDecimal)
        pre_close_current1m:
          type: number
          format: decimal
          description: preCloseCurrent1m (BigDecimal)
        pre_close_current1q:
          type: number
          format: decimal
          description: preCloseCurrent1q (BigDecimal)
        pre_close_current1w:
          type: number
          format: decimal
          description: preCloseCurrent1w (BigDecimal)
        pre_close_ytd:
          type: number
          format: decimal
          description: preCloseYtd (BigDecimal)
        pre_raise_percent:
          type: number
          format: decimal
          description: preRaisePercent (BigDecimal)
        premium_ratio:
          type: number
          format: decimal
          description: premiumRatio (BigDecimal)
        profit:
          type: number
          format: decimal
          description: profit (BigDecimal)
        profit_per_lot:
          type: number
          format: decimal
          description: profitPerLot (BigDecimal)
        pure_bond_premium_ratio:
          type: number
          format: decimal
          description: pureBondPremiumRatio (BigDecimal)
        purebond_value:
          type: number
          format: decimal
          description: purebondValue (BigDecimal)
        quote_date_time:
          type: string
          description: quoteDateTime (String)
        raise:
          type: number
          format: decimal
          description: raise (BigDecimal)
        raise_percent:
          type: number
          format: decimal
          description: raisePercent (BigDecimal)
        raise_percent10_days:
          type: number
          format: decimal
          description: raisePercent10Days (BigDecimal)
        raise_percent1m:
          type: number
          format: decimal
          description: raisePercent1m (BigDecimal)
        raise_percent1y:
          type: number
          format: decimal
          description: raisePercent1y (BigDecimal)
        raise_percent20_days:
          type: number
          format: decimal
          description: raisePercent20Days (BigDecimal)
        raise_percent3m:
          type: number
          format: decimal
          description: raisePercent3m (BigDecimal)
        raise_percent3y:
          type: number
          format: decimal
          description: raisePercent3y (BigDecimal)
        raise_percent5_days:
          type: number
          format: decimal
          description: raisePercent5Days (BigDecimal)
        raise_percent5y:
          type: number
          format: decimal
          description: raisePercent5y (BigDecimal)
        raise_percent6m:
          type: number
          format: decimal
          description: raisePercent6m (BigDecimal)
        raise_percent_current1m:
          type: number
          format: decimal
          description: raisePercentCurrent1m (BigDecimal)
        raise_percent_one_year:
          type: number
          format: decimal
          description: raisePercentOneYear (BigDecimal)
        raise_percent_ytd:
          type: number
          format: decimal
          description: raisePercentYtd (BigDecimal)
        raise_speed:
          type: number
          format: decimal
          description: raiseSpeed (BigDecimal)
        realtime_flag:
          type: string
          description: realtimeFlag (String)
        remain_days:
          type: integer
          description: remainDays (Integer)
        remaining_amount:
          type: number
          format: decimal
          description: remainingAmount (BigDecimal)
        roe:
          type: number
          format: decimal
          description: roe (BigDecimal)
        rsi_death_cross_high:
          type: boolean
          description: rsiDeathCrossHigh (Boolean)
        rsi_gold_cross_low:
          type: boolean
          description: rsiGoldCrossLow (Boolean)
        rsv:
          type: number
          format: decimal
          description: rsv (BigDecimal)
        sd:
          type: number
          format: decimal
          description: sd (BigDecimal)
        sec_id:
          type: string
          description: secId (String)
        share_issued:
          type: number
          format: decimal
          description: shareIssued (BigDecimal)
        short_rsi:
          type: number
          format: decimal
          description: shortRSI (BigDecimal)
        source_currency:
          type: string
          description: sourceCurrency (String)
        st_profit:
          type: number
          format: decimal
          description: stProfit (BigDecimal)
        st_status:
          type: string
          description: stStatus (String)
        stagflation_percent:
          type: number
          format: decimal
          description: stagflationPercent (BigDecimal)
        star:
          type: string
          description: star (String)
        stock_change_range:
          type: number
          format: decimal
          description: stockChangeRange (BigDecimal)
        stock_code:
          type: string
          description: stockCode (String)
        stock_current:
          type: number
          format: decimal
          description: stockCurrent (BigDecimal)
        stock_name:
          type: string
          description: stockName (String)
        stock_raise:
          type: number
          format: decimal
          description: stockRaise (BigDecimal)
        stock_raise_percent:
          type: number
          format: decimal
          description: stockRaisePercent (BigDecimal)
        tags:
          type: string
          description: tags (String)
        target_code:
          type: string
          description: targetCode (String)
        target_currency:
          type: string
          description: targetCurrency (String)
        target_name:
          type: string
          description: targetName (String)
        target_price:
          type: number
          format: decimal
          description: targetPrice (BigDecimal)
        to_cash_div_rw:
          type: number
          format: decimal
          description: toCashDivRw (BigDecimal)
        total_capital:
          type: integer
          format: int64
          description: totalCapital (Long)
        total_trade_vol:
          type: integer
          format: int64
          description: totalTradeVol (Long)
        total_turnover:
          type: number
          format: decimal
          description: totalTurnover (BigDecimal)
        tra_curr_unit_code:
          type: string
          description: traCurrUnitCode (String)
        tracking_index_code:
          type: string
          description: trackingIndexCode (String)
        trade_capital:
          type: integer
          format: int64
          description: tradeCapital (Long)
        trade_date_time:
          type: string
          description: tradeDateTime (String)
        trade_local_date_time:
          type: string
          format: date-time
          description: tradeLocalDateTime (LocalDateTime)
        trade_vol_avg_pre5_days:
          type: number
          format: decimal
          description: tradeVolAvgPre5Days (BigDecimal)
        trough:
          type: boolean
          description: trough (Boolean)
        type:
          type: string
          description: type (String)
        ub:
          type: number
          format: decimal
          description: ub (BigDecimal)
        unique_code:
          type: string
          description: uniqueCode (String)
        up_limit:
          type: number
          format: decimal
          description: upLimit (BigDecimal)
        up_limit_num:
          type: integer
          description: upLimitNum (Integer)
        up_limit_time:
          type: string
          format: date-time
          description: upLimitTime (Date)
        up_num:
          type: integer
          description: upNum (Integer)
        upper_strike:
          type: number
          format: decimal
          description: upperStrike (BigDecimal)
        volume_ratio:
          type: number
          format: decimal
          description: volumeRatio (BigDecimal)
        warrant_character_code:
          type: integer
          description: warrantCharacterCode (Integer)
    StockFilterItem:
      type: object
      description: 条件选股结果项（对应 Futu get_stock_filter）
      properties:
        code:
          type: string
          description: 股票代码

    SimpleFilter:
      type: object
      description: 简单属性筛选条件（SimpleFilter）
      properties:
        filter_type:
          type: string
          description: 多态类型，必须为 SIMPLE（与 discriminator mapping 一致）
        stock_field:
          $ref: "enum.yaml#/StockField"
        filter_min:
          type: number
          format: decimal
          description: 区间下限（闭区间），不传默认为 -∞
        filter_max:
          type: number
          format: decimal
          description: 区间上限（闭区间），不传默认为 +∞
        eq_value:
          type: string
          description: 等于值，不传默认为空
        is_no_filter:
          type: boolean
          description: 该字段是否不需要筛选（不传默认为不筛选）
        sort:
          $ref: "enum.yaml#/SortDir"
      required:
        - filter_type
        - stock_field

    FinancialFilter:
      type: object
      description: 财务属性筛选条件（FinancialFilter）
      properties:
        filter_type:
          type: string
          description: 多态类型，必须为 FINANCIAL（与 discriminator mapping 一致）
        stock_field:
          $ref: "enum.yaml#/FinancialStockField"
        filter_min:
          type: number
          format: decimal
          description: 区间下限（闭区间），不传默认为 -∞
        filter_max:
          type: number
          format: decimal
          description: 区间上限（闭区间），不传默认为 +∞
        is_no_filter:
          type: boolean
          description: 该字段是否不需要筛选（不传默认为不筛选）
        sort:
          $ref: "enum.yaml#/SortDir"
        quarter:
          $ref: "enum.yaml#/FinancialQuarter"
      required:
        - filter_type
        - stock_field
        - quarter

    PatternFilter:
      type: object
      description: 形态技术指标筛选条件（PatternFilter）
      properties:
        filter_type:
          type: string
          description: 多态类型，必须为 PATTERN（与 discriminator mapping 一致）
        stock_field:
          $ref: "enum.yaml#/PatternStockField"
        ktype:
          $ref: "enum.yaml#/KLType"
        consecutive_period:
          type: integer
          default: 0
          description: 筛选连续周期（consecutive_period）
        is_no_filter:
          type: boolean
          description: 该字段是否不需要筛选（不传默认为不筛选）
      required:
        - filter_type
        - stock_field
        - ktype

    CustomIndicatorFilter:
      type: object
      description: 自定义技术指标筛选条件（CustomIndicatorFilter）
      properties:
        filter_type:
          type: string
          description: 多态类型，必须为 CUSTOM_INDICATOR（与 discriminator mapping 一致）
        stock_field1:
          $ref: "enum.yaml#/CustomStockField"
        stock_field1_para:
          type: array
          description: 自定义指标参数（根据指标类型传参）
          items:
            type: integer
        relative_position:
          $ref: "enum.yaml#/RelativePosition"
        stock_field2:
          $ref: "enum.yaml#/CustomStockField"
        stock_field2_para:
          type: array
          description: 自定义指标参数（根据指标类型传参）
          items:
            type: integer
        value:
          type: number
          format: decimal
          description: 自定义数值（当 stock_field2 选择自定义数值时为必传参数）
        ktype:
          $ref: "enum.yaml#/KLType"
        consecutive_period:
          type: integer
          description: 筛选连续周期（consecutive_period）
        is_no_filter:
          type: boolean
          description: 该字段是否不需要筛选（不传默认为不筛选）
      required:
        - filter_type
        - stock_field1
        - stock_field2
        - relative_position
        - ktype

    StockFilterCondition:
      description: 条件选股筛选条件（多态，依赖 filter_type 反序列化）
      oneOf:
        - $ref: "#/components/schemas/SimpleFilter"
        - $ref: "#/components/schemas/FinancialFilter"
        - $ref: "#/components/schemas/PatternFilter"
        - $ref: "#/components/schemas/CustomIndicatorFilter"
      discriminator:
        propertyName: filter_type
        mapping:
          SIMPLE: "#/components/schemas/SimpleFilter"
          FINANCIAL: "#/components/schemas/FinancialFilter"
          PATTERN: "#/components/schemas/PatternFilter"
          CUSTOM_INDICATOR: "#/components/schemas/CustomIndicatorFilter"

    StockFilterConfig:
      type: object
      description: 条件选股请求体（POST /quote/get_stock_filter）
      properties:
        market:
          $ref: "enum.yaml#/Markets"
        filter_list:
          type: array
          description: 筛选条件列表（SimpleFilter / FinancialFilter / PatternFilter / CustomIndicatorFilter）
          items:
            $ref: "#/components/schemas/StockFilterCondition"
        sort_field:
          $ref: 'enum.yaml#/QuoteSortField'
        ascend:
          type: boolean
          description: 是否升序
        page:
          type: integer
          description: 分页页码（从 0 起，与现有服务逻辑一致）
        page_size:
          type: integer
          description: 每页条数
      required:
        - market

    HKStockFinancial:
      type: object
      properties:
        hkStockFinancialIndicatorResp:
          type: array
          items:
            $ref: "#/components/schemas/HkOpenApiStockFinancialIndicator"
        hkIncomeStatementResp:
          $ref: "#/components/schemas/HkOpenApiIncomeStatement"
        hkBalanceSheetResp:
          $ref: "#/components/schemas/HkOpenApiBalanceSheet"
        hkCashflowStatementResp:
          $ref: "#/components/schemas/HkOpenApiCashflowStatement"

    HkOpenApiStockFinancialIndicator:
      type: object
      description: 港股财务指标
      properties:
        basicEps:
          type: number
          description: 每股收益EPS-基本(元/股)
        basicEps1y:
          type: number
          description: 基本每股收益(年增长率)(%)
        basicEps3y:
          type: number
          description: 基本每股收益(近3年增长率)(%)
        beginDate:
          type: string
          format: date-time
          description: 起始日期
        cashFlowPs:
          type: number
          description: 每股净现金流量(元/股)
        currentAssetsToTa:
          type: number
          description: 流动资产/总资产(%)
        currentAssetsTurnoverRate:
          type: number
          description: 流动资产周转率(次)
        currentLiabilityToTl:
          type: number
          description: 流动负债/负债合计(%)
        currentRatio:
          type: number
          description: 流动比率
        debtAssetsRatio:
          type: number
          description: 资产负债率
        debtEquityRatio:
          type: number
          description: 产权比率
        dilutedEps:
          type: number
          description: 每股收益EPS-稀释(元/股)
        dividendPs:
          type: number
          description: 每股派息(含税/人民币元)
        dividendRatio:
          type: number
          description: 派息比率(%)
        earningBeforeTaxRatio:
          type: number
          description: 税前利润率(%)
        ebtgr1y:
          type: number
          description: 税前利润(年增长率)(%)
        ebtgr3y:
          type: number
          description: 税前利润(近3年增长率)(%)
        endDate:
          type: string
          format: date-time
          description: 日期
        equityGr1y:
          type: number
          description: 股东权益(年增长率)(%)
        equityGr3y:
          type: number
          description: 股东权益(近3年增长率)(%)
        equityMultipler:
          type: number
          description: 权益乘数
        fiscalYear:
          type: string
          format: date-time
          description: 财政年度
        fixedAssetTurnoverRate:
          type: number
          description: 固定资产周转率(次)
        grossIncomeGr1y:
          type: number
          description: 毛利(年增长率)(%)
        grossIncomeGr3y:
          type: number
          description: 毛利(近3年增长率)(%)
        grossIncomeRatio:
          type: number
          description: 销售毛利率
        inventoryTurnoverRate:
          type: number
          description: 存货周转率
        liabilityGr1y:
          type: number
          description: 负债合计(年增长率)(%)
        liabilityGr3y:
          type: number
          description: 负债合计(近3年增长率)(%)
        mainIncomePs:
          type: number
          description: 每股主营业务收入(元/股)
        netAssetPs:
          type: number
          description: 每股净资产BPS(元/股)
        netAssetPs1y:
          type: number
          description: 每股净资产(年增长率)(%)
        netAssetPs3y:
          type: number
          description: 每股净资产(近3年增长率)(%)
        netProfitGr1y:
          type: number
          description: 净利润(年增长率)(%)
        netProfitGr3y:
          type: number
          description: 净利润(近3年增长率)(%)
        netProfitRatio:
          type: number
          description: 销售净利率
        nonCurrentAssetsToTa:
          type: number
          description: 非流动资产/总资产(%)
        nonCurrentLiabilityToTl:
          type: number
          description: 非流动负债/负债合计(%)
        npParentCompanyGr1y:
          type: number
          description: 归属母公司股东的净利润(年增长率)(%)
        npParentCompanyGr3y:
          type: number
          description: 归属母公司股东的净利润(近3年增长率)(%)
        opToTl:
          type: number
          description: 营业利润／负债合计
        operCashFlowPs:
          type: number
          description: 每股经营活动现金流量(元/股)
        operCashFlowToCl:
          type: number
          description: 经营活动产生的现金流量净额／流动负债
        operCashFlowToTl:
          type: number
          description: 经营活动产生的现金流量净额／负债合计
        operCashToTp:
          type: number
          description: 经营活动产生的现金流量净额／营业收入(%)
        operProfitGr1y:
          type: number
          description: 营业利润(年增长率)(%)
        operProfitGr3y:
          type: number
          description: 营业利润(近3年增长率)(%)
        operProfitToCl:
          type: number
          description: 营业利润／流动负债
        operProfitToTp:
          type: number
          description: 营业利润／利润总额(%)
        operatingProfitRatio:
          type: number
          description: 营业利润率
        operatingRevenueGr1y:
          type: number
          description: 营业收入(年增长率)(%)
        operatingRevenueGr3y:
          type: number
          description: 营业收入(近3年增长率)(%)
        orgId:
          type: string
          description: 港股财务指标 @author @date 2021-08-14 / @Data public class HkStockFinancialIndicatorResp
            { /** 机构ID
        quickRatio:
          type: number
          description: 速动比率
        reportPeriodType:
          type: string
          description: 报告期类型
        reportPeriodTypeCode:
          type: string
          description: 报告期类型编码
        roa:
          type: number
          description: 资产净利率
        roeWeighted:
          type: number
          description: 净资产收益率(加权)
        seWithoutMiGr1y:
          type: number
          description: 归属母公司股东的权益(年增长率)(%)
        seWithoutMiGr3y:
          type: number
          description: 归属母公司股东的权益(近3年增长率)(%)
        seWithoutMiToTl:
          type: number
          description: 归属母公司股东的权益/负债合计(%)
        taxToTp:
          type: number
          description: 税项／利润总额(%)
        totalAssetGr1y:
          type: number
          description: 资产总计(年增长率)(%)
        totalAssetGr3y:
          type: number
          description: 资产总计(近3年增长率)(%)
        totalAssetTurnoverRate:
          type: number
          description: 总资产周转率(次)
        yoyGrowthInBasicEps:
          type: number
          description: yoy_growth_in_basic_eps 基本每股收益同比增长
    HkOpenApiIncomeStatement:
      type: object
      description: 港股利润表
      properties:
        accountingStandards:
          type: integer
          format: int32
          description: accounting_standards 会计准则
        adjItemsAftaxProfit:
          type: number
          description: adj_items_aftax_profit 除税后溢利调整项目(元)
        adjItemsBefDedImp:
          type: number
          description: adj_items_bef_ded_imp 扣除减值前调整项目(元)
        adjItemsEBefTax:
          type: number
          description: adj_items_e_bef_tax 溢利调整项目(元)
        adjItemsIncome:
          type: number
          description: adj_items_income 收入调整项目(元)
        adjItemsOPAfImp:
          type: number
          description: adj_items_o_p_af_imp 扣除减值后调整项目(元)
        adjItemsOpeProfit:
          type: number
          description: adj_items_ope_profit 经营溢利调整项目(元)
        adjItemsOperatRevenue:
          type: number
          description: adj_items_operat_revenue 经营收入调整项目(元)
        adjItemsOperateProfit:
          type: number
          description: adj_items_operate_profit 经营溢利调整项目(元)
        adjItemsProfTSholders:
          type: number
          description: adj_items_prof_t_sholders 股东应占溢利调整项目(元)
        adjItemsProfits:
          type: number
          description: adj_items_profits 溢利调整项目(元)
        admExpensesAe:
          type: number
          description: adm_expenses_ae 管理费用-行政费用(元)
        affiliatedComFrofit:
          type: number
          description: affiliated_com_frofit 应占联营公司溢利(元)
        aftaxProfitFCBusi:
          type: number
          description: aftax_profit_f_c_busi 持续经营业务税后利润(元)
        aftaxProfitFNCBusi:
          type: number
          description: aftax_profit_f_n_c_busi 非持续经营业务税后溢利(元)
        amortReinsuExpend:
          type: number
          description: amort_reinsu_expend 摊回分保费用(元)
        attriToMSholdFCBprof:
          type: number
          description: attri_to_m_shold_f_c_bprof 少数股东应占来自持续业务溢利(元)
        attriToMSholdFNCBprof:
          type: number
          description: attri_to_m_shold_f_n_c_bprof 少数股东应占来自非持续业务溢利(元)
        attriToProfAssAJVent:
          type: number
          description: attri_to_prof_ass_a_j_vent 应占联营企业和合营企业收益(元)
        attriToProfJVent:
          type: number
          description: attri_to_prof_j_vent 应占合营公司溢利(元)
        attriToSholdFCBprof:
          type: number
          description: attri_to_shold_f_c_bprof 股东应占来自持续业务溢利(元)
        attriToSholdFNCBprof:
          type: number
          description: attri_to_shold_f_n_c_bprof 股东应占来自非持续业务溢利(元)
        bankIncome:
          type: number
          description: bank_income 银行业务收入(元)
        beginDate:
          type: string
          format: date-time
          description: begin_date 开始日期
        commissionIncome:
          type: number
          description: commission_income 佣金收入(元)
        companyNature:
          type: string
          description: company_nature 企业性质
        companyNatureCode:
          type: integer
          format: int32
          description: company_nature_code 企业性质编码：1-普通，2-金融，3-保险
        cooperateBusProfit:
          type: number
          description: cooperate_bus_profit 应占共同控制实体溢利(元)
        currencyUnit:
          type: integer
          format: int32
          description: currency_unit 货币类别
        deferredTax:
          type: number
          description: deferred_tax 递延税项(元)
        depDividerSale:
          type: number
          description: dep_divider_sale 折旧与摊销(元)
        devalAndAccBadDebt:
          type: number
          description: deval_and_acc_bad_debt 减值及拨备(元)
        dividend:
          type: number
          description: dividend 股息(元)
        dividendIncome:
          type: number
          description: dividend_income 股息收入(元)
        dividendPerShare:
          type: number
          description: dividend_per_share 每股股息(元)
        earningAfterTax:
          type: number
          description: earning_after_tax 除税后溢利(元)
        earningBeforeTax:
          type: number
          description: earning_before_tax 除税前溢利(元)
        empTurnover:
          type: number
          description: emp_turnover 员工支销(元)
        endDate:
          type: string
          format: date-time
          description: end_date 截止日期
        eps:
          type: number
          description: eps 每股摊薄盈利(元)
        epsBasic:
          type: number
          description: eps_basic 每股基本盈利(元)
        exchangeGains:
          type: number
          description: exchange_gains 汇兑损益-收入(元)
        expOnInsBusOthExp:
          type: number
          description: exp_on_ins_bus_oth_exp 保险业务支出及其他费用(元)
        finAssetsIncome:
          type: number
          description: fin_assets_income 金融资产收益(元)
        financialExpenseBTax:
          type: number
          description: financial_expense_b_tax 财务费用-税前(元)
        financingIncome:
          type: number
          description: financing_income 融资收入(元)
        fiscalYear:
          type: string
          format: date-time
          description: fiscal_year 财政年度
        fundingCost:
          type: number
          description: funding_cost 融资成本(元)
        grossProfit:
          type: number
          description: gross_profit 毛利(元)
        infoPublDate:
          type: string
          format: date-time
          description: info_publ_date 信息发布日期
        infoSource:
          type: string
          description: info_source 信息来源
        infoSourceCode:
          $ref: 'enum.yaml#/DateTypeConvertUtil'
        investmentIncome:
          type: number
          description: investment_income 投资收入(元)
        jointVenturesProfit:
          type: number
          description: joint_ventures_profit 应占合营公司溢利(元)
        mark:
          type: integer
          format: int32
          description: mark 合并调整标志
        minorityProfit:
          type: number
          description: minority_profit 少数股东损益(元)
        netIFInsAtFairValue:
          type: number
          description: net_i_f_ins_at_fair_value 以公平值列账的金融工具净收益(元)
        netInsClaAPolHoldLiab:
          type: number
          description: net_ins_cla_a_pol_hold_liab 保险索偿净额及保单持有负债(元)
        netInterestIncome:
          type: number
          description: net_interest_income 净利息收入(元)
        netPayAClaims:
          type: number
          description: net_pay_a_claims 给付及赔付净额(元)
        netPremIncRealized:
          type: number
          description: net_prem_inc_realized 已实现净保费收入(元)
        netRemittance:
          type: number
          description: net_remittance 汇兑净额(元)
        netRentIncome:
          type: number
          description: net_rent_income 租金净收入(元)
        netServiceIncome:
          type: number
          description: net_service_income 净服务费收入(元)
        netTransIncome:
          type: number
          description: net_trans_income 交易净收入(元)
        npDispAffilComp:
          type: number
          description: np_disp_affil_comp 出售附属公司净溢利(元)
        npDispAvaFSaleSecu:
          type: number
          description: np_disp_ava_f_sale_secu 出售可供出售证券净溢利(元)
        npDispFixedAssets:
          type: number
          description: np_disp_fixed_assets 出售固定资产净溢利(元)
        npDispInvestProp:
          type: number
          description: np_disp_invest_prop 出售投资物业净溢利(元)
        opeExpenseAe:
          type: number
          description: ope_expense_ae 管理费用-销售费用(元)
        opeInterestExpense:
          type: number
          description: ope_interest_expense 营运利息支出(元)
        opeProfitAfDedImp:
          type: number
          description: ope_profit_af_ded_imp 扣除减值后经营溢利(元)
        opeProfitBefDedImp:
          type: number
          description: ope_profit_bef_ded_imp 扣除减值前经营溢利(元)
        operExpenses:
          type: number
          description: oper_expenses 营运支出(元)
        operatingIncome:
          type: number
          description: operating_income 营业收入(元)
        operatingPayoutAD:
          type: number
          description: operating_payout_a_d 营业支出-扣除减值后(元)
        operatingPayoutBD:
          type: number
          description: operating_payout_b_d 营业支出-扣除减值前(元)
        operatingProfit:
          type: number
          description: operating_profit 经营溢利(元)
        operatingRevenue:
          type: number
          description: operating_revenue 经营收入(元)
        orgId:
          type: string
          description: 港股利润表 @author @date 2022-05-07 01:50:15 / @Data public class HkIncomeStatementResp
            { /** org_id 机构ID
        periodMark:
          $ref: 'enum.yaml#/PeriodMark'
        profitDispOfAssets:
          type: number
          description: profit_disp_of_assets 出售资产溢利(元)
        profitToShareholders:
          type: number
          description: profit_to_shareholders 股东应占溢利(元)
        rAndDExpensesAe:
          type: number
          description: r_and_d_expenses_ae 管理费用-研发支出(元)
        revaluationSurplus:
          type: number
          description: revaluation_surplus 重估盈余(元)
        salesCost:
          type: number
          description: sales_cost 销售成本(元)
        secuAndInvestIncome:
          type: number
          description: secu_and_invest_income 证券交易及投资净收入(元)
        speItemsAftaxProfit:
          type: number
          description: spe_items_aftax_profit 除税后溢利特殊项目(元)
        speItemsBefDedImp:
          type: number
          description: spe_items_bef_ded_imp 扣除减值前特殊项目(元)
        speItemsEBefTax:
          type: number
          description: spe_items_e_bef_tax 溢利特殊项目(元)
        speItemsIncome:
          type: number
          description: spe_items_income 收入特殊项目(元)
        speItemsOPAfImp:
          type: number
          description: spe_items_o_p_af_imp 扣除减值后特殊项目(元)
        speItemsOpeProfit:
          type: number
          description: spe_items_ope_profit 经营溢利其他项目(元)
        speItemsOperatRevenue:
          type: number
          description: spe_items_operat_revenue 经营收入特殊项目(元)
        speItemsOperateProfit:
          type: number
          description: spe_items_operate_profit 经营溢利特殊项目(元)
        speItemsProfTSholders:
          type: number
          description: spe_items_prof_t_sholders 股东应占溢利其他项目(元)
        speItemsProfits:
          type: number
          description: spe_items_profits 溢利特殊项目(元)
        tax:
          type: number
          description: tax 税项(元)
        totalIncome:
          type: number
          description: total_income 收入合计(元)
        totalPayCompExp:
          type: number
          description: total_pay_comp_exp 给付、赔付及费用总计(元)
        turnover:
          type: number
          description: turnover 营业额(元)
        yoyGrowtAftaxProfitFcBusi:
          type: number
          description: yoy_growt_aftax_profit_fc_busi 净利润同比增长
    HkOpenApiBalanceSheet:
      type: object
      description: 港股资产负债表
      properties:
        aAdjItems:
          type: number
          description: a_adj_items 资产调整项目(元)
        aExcepItems:
          type: number
          description: a_excep_items 资产特殊项目(元)
        accountReceivables:
          type: number
          description: account_receivables 应收帐款(元)
        accountingStandards:
          type: integer
          format: int32
          description: accounting_standards 会计准则
        accountsPayable:
          type: number
          description: accounts_payable 应付帐款(元)
        addEquityInstruments:
          type: number
          description: add_equity_instruments 额外股本工具(元)
        advanceInsurance:
          type: number
          description: advance_insurance 预收保费(元)
        advancePayment:
          type: number
          description: advance_payment 预付款项(元)
        advanceReceipts:
          type: number
          description: advance_receipts 预收款项(元)
        advancesTCusts:
          type: number
          description: advances_t_custs 客户垫款(元)
        assetLessCLiability:
          type: number
          description: asset_less_c_liability 总资产减流动负债(元)
        assetLessTLiability:
          type: number
          description: asset_less_t_liability 总资产减总负债(元)
        assetToSold:
          type: number
          description: asset_to_sold 待出售之资产(元)
        associateFundRece:
          type: number
          description: associate_fund_rece 应收关联方款项(元)
        bFinInstAmsPayable:
          type: number
          description: b_fin_inst_ams_payable 应付银行及其他金融机构款项(元)
        bFinInstDepBorMoney:
          type: number
          description: b_fin_inst_dep_bor_money 同业及其他金融机构存放及拆入款项(元)
        bankLoansAndOverdraft:
          type: number
          description: bank_loans_and_overdraft 银行贷款及透支(元)
        beginDate:
          type: string
          format: date-time
          description: begin_date 起始日期
        billReceivable:
          type: number
          description: bill_receivable 应收票据(元)
        borFromCentralBank:
          type: number
          description: bor_from_central_bank 向中央银行借款(元)
        borrowingCapital:
          type: number
          description: borrowing_capital 拆入资金(元)
        borrowings:
          type: number
          description: borrowings 贷款(元)
        boughtSellbackAssets:
          type: number
          description: bought_sellback_assets 买入返售金融资产(元)
        boughtSellbackSecu:
          type: number
          description: bought_sellback_secu 买入返售证券(元)
        cAAdjItems:
          type: number
          description: c_a_adj_items 流动资产调整项目(元)
        cAExcepItems:
          type: number
          description: c_a_excep_items 流动资产特殊项目(元)
        cLAdjItems:
          type: number
          description: c_l_adj_items 流动负债调整项目(元)
        cLExcepItems:
          type: number
          description: c_l_excep_items 流动负债特殊项目(元)
        cWrksCliMonReceCA:
          type: number
          description: c_wrks_cli_mon_rece_c_a 应收合约客户款项-流动资产(元)
        cWrksCliMonReceNCA:
          type: number
          description: c_wrks_cli_mon_rece_n_c_a 应收合约客户款项-非流动资产(元)
        capitalReserveFund:
          type: number
          description: capital_reserve_fund 资本公积(元)
        cash:
          type: number
          description: cash 现金及等价物(元)
        cashHoldings:
          type: number
          description: cash_holdings 库存现金及短期资金(元)
        coBusinessEquity:
          type: number
          description: co_business_equity 共同控制实体权益(元)
        companyNature:
          type: string
          description: company_nature 企业性质
        companyNatureCode:
          type: integer
          format: int32
          description: company_nature_code 企业性质编码：1-普通，2-金融，3-保险
        conBillAndBond:
          type: number
          description: con_bill_and_bond 可转换票据及债券(元)
        construInProcess:
          type: number
          description: constru_in_process 在建工程(元)
        curIncTaxLiab:
          type: number
          description: cur_inc_tax_liab 当期所得税负债(元)
        currencyUnit:
          type: integer
          format: int32
          description: currency_unit 货币单位
        customerDeposits:
          type: number
          description: customer_deposits 客户存款(元)
        debtInstruIssued:
          type: number
          description: debt_instru_issued 已发行债务工具(元)
        debtsSecurities:
          type: number
          description: debts_securities 债务证券(元)
        deferredProceedsCL:
          type: number
          description: deferred_proceeds_c_l 递延收入-流动负债(元)
        deferredTaxAssets:
          type: number
          description: deferred_tax_assets 递延税项资产(元)
        deferredTaxLiability:
          type: number
          description: deferred_tax_liability 递延税项负债(元)
        depositCard:
          type: number
          description: deposit_card 所持存款证(元)
        depositCardIA:
          type: number
          description: deposit_card_i_a 存款证(元)
        depositInCentralBank:
          type: number
          description: deposit_in_central_bank 存放中央银行款项(元)
        depositOfInsured:
          type: number
          description: deposit_of_insured 保户储金(元)
        derFinInstsCA:
          type: number
          description: der_fin_insts_c_a 衍生金融工具-流动资产(元)
        derFinInstsCL:
          type: number
          description: der_fin_insts_c_l 衍生金融工具-流动负债(元)
        derFinInstsNCA:
          type: number
          description: der_fin_insts_n_c_a 衍生金融工具-非流动资产(元)
        derFinInstsNCL:
          type: number
          description: der_fin_insts_n_c_l 衍生金融工具-非流动负债(元)
        deriFinAssets:
          type: number
          description: deri_fin_assets 衍生性金融资产(元)
        derivativeLiability:
          type: number
          description: derivative_liability 衍生金融负债(元)
        deveAndForSalePro:
          type: number
          description: deve_and_for_sale_pro 发展中及待售物业(元)
        developmentExpenditure:
          type: number
          description: development_expenditure 开发支出(元)
        diviForInsured:
          type: number
          description: divi_for_insured 应付保户红利(元)
        dividendPayable:
          type: number
          description: dividend_payable 应付股利(元)
        endDate:
          type: string
          format: date-time
          description: end_date 日期
        equUTFundInvPort:
          type: number
          description: equ_u_t_fund_inv_port 股本证券及单位信托基金投资组合(元)
        exchangeReserve:
          type: number
          description: exchange_reserve 汇兑储备(元)
        fAccruedBadDebtCL:
          type: number
          description: f_accrued_bad_debt_c_l 拨备-流动负债(元)
        fAssociateFundRecCL:
          type: number
          description: f_associate_fund_rec_c_l 应付关连方款项-流动负债(元)
        fFinanceLeaseOwesCL:
          type: number
          description: f_finance_lease_owes_c_l 融资租赁负债-流动负债(元)
        fOrganizationDepposit:
          type: number
          description: f_organization_depposit 银行同业及其他金融机构存款(负债)(元)
        fOtherLoanCL:
          type: number
          description: f_other_loan_c_l 其他贷款-流动负债(元)
        finAetAtFValTPL:
          type: number
          description: fin_aet_at_f_val_t_p_l 按公平值入损益金融资产(元)
        finAetAtFValTPLCA:
          type: number
          description: fin_aet_at_f_val_t_p_l_c_a 按公平值入损益金融资产-流动资产(元)
        finAetAtFValTPLNCA:
          type: number
          description: fin_aet_at_f_val_t_p_l_n_c_a 按公平值入损益金融资产-非流动资产(元)
        financialOrgDeposits:
          type: number
          description: financial_org_deposits 银行同业及其他金融机构存款(元)
        finliabAtFV:
          type: number
          description: finliab_at_f_v 以公平值计入损益金融负债(元)
        fiscalYear:
          type: string
          format: date-time
          description: fiscal_year 财政年度
        fixedAssets:
          type: number
          description: fixed_assets 固定资产(元)
        fixedDeposit:
          type: number
          description: fixed_deposit 定期存款(元)
        fixedDepositCA:
          type: number
          description: fixed_deposit_c_a 定期存款-流动资产(元)
        fixedDepositNCA:
          type: number
          description: fixed_deposit_n_c_a 定期存款-非流动资产(元)
        goodWill:
          type: number
          description: good_will 商誉(元)
        hForSaleAssetsCA:
          type: number
          description: h_for_sale_assets_c_a 可供出售金融资产-流动资产(元)
        heldToMatuInv:
          type: number
          description: held_to_matu_inv 持至到期投资(元)
        holdForSaleAssets:
          type: number
          description: hold_for_sale_assets 可供出售金融资产(元)
        holdForSaleAssetsNCA:
          type: number
          description: hold_for_sale_assets_n_c_a 可供出售金融资产-非流动资产(元)
        holdProfit:
          type: number
          description: hold_profit 保留溢利(元)
        holdToMatInv:
          type: number
          description: hold_to_mat_inv 持有至到期投资(元)
        hongkongDollar:
          type: number
          description: hongkong_dollar 香港特区政府流通纸币(元)
        infoPublDate:
          type: string
          format: date-time
          description: info_publ_date 信息发布日期
        infoSource:
          type: string
          description: info_source 信息来源
        infoSourceCode:
          $ref: 'enum.yaml#/DateTypeConvertUtil'
        insAndOthRece:
          type: number
          description: ins_and_oth_rece 保险及其他应收款项(元)
        insContract:
          type: number
          description: ins_contract 保险合同(元)
        insOtherReceCA:
          type: number
          description: ins_other_rece_c_a 保险及其他应收款项-流动资产(元)
        insOtherReceNCA:
          type: number
          description: ins_other_rece_n_c_a 保险及其他应收款项-非流动资产(元)
        insurAccPayable:
          type: number
          description: insur_acc_payable 保险应付账款(元)
        insurAccPayableNCL:
          type: number
          description: insur_acc_payable_n_c_l 保险应付账款-非流动负债(元)
        insuranceReceivables:
          type: number
          description: insurance_receivables 应收保费(元)
        insurerImpawnLoan:
          type: number
          description: insurer_impawn_loan 保户质押贷款(元)
        intangibleAssets:
          type: number
          description: intangible_assets 无形资产(元)
        interestPayable:
          type: number
          description: interest_payable 应付利息(元)
        interestReceivables:
          type: number
          description: interest_receivables 应收利息(元)
        invInAsJointVen:
          type: number
          description: inv_in_as_joint_ven 于联营企业和合营企业的投资(元)
        inveContLiaCL:
          type: number
          description: inve_cont_lia_c_l 投资合同负债-流动负债(元)
        inveContLiaNCL:
          type: number
          description: inve_cont_lia_n_c_l 投资合约负债-非流动负债(元)
        inventories:
          type: number
          description: Inventories 存货(元)
        investContract:
          type: number
          description: invest_contract 投资合同(元)
        investInJointVen:
          type: number
          description: invest_in_joint_ven 对合营企业的投资(元)
        investInLoansAndRece:
          type: number
          description: invest_in_loans_and_rece 归入贷款及应收款的投资(元)
        investInRece:
          type: number
          description: invest_in_rece 应收款项类投资(元)
        investIncRece:
          type: number
          description: invest_inc_rece 应收投资收益(元)
        investProperty:
          type: number
          description: invest_property 投资物业(元)
        issuedDepositCard:
          type: number
          description: issued_deposit_card 已发行存款证(元)
        issuedbond:
          type: number
          description: issuedbond 已发行债券(元)
        jointVenturesEquity:
          type: number
          description: joint_ventures_equity 合营公司权益(元)
        lAdjuItems:
          type: number
          description: l_adju_items 负债调整项目(元)
        lExcepItems:
          type: number
          description: l_excep_items 负债特殊项目(元)
        lFromOthBanksCL:
          type: number
          description: l_from_oth_banks_c_l 拆入资金-流动负债(元)
        lFromOthBanksNCL:
          type: number
          description: l_from_oth_banks_n_c_l 拆入资金-非流动负债(元)
        lTAccountPayable:
          type: number
          description: l_t_account_payable 长期应付款(元)
        lTInvestments:
          type: number
          description: l_t_investments 长期投资(元)
        landUsufruct:
          type: number
          description: land_usufruct 土地使用权(元)
        lendCapital:
          type: number
          description: lend_capital 拆出资金(元)
        lendingCapital:
          type: number
          description: lending_capital 借贷资本(元)
        loansAndOtherPayment:
          type: number
          description: loans_and_other_payment 客户贷款及其他款项(元)
        loansOtherRece:
          type: number
          description: loans_other_rece 贷款及其他账项(元)
        longSalariesPay:
          type: number
          description: long_salaries_pay 长期应付职工薪酬(元)
        longtermLoan:
          type: number
          description: longterm_loan 长期银行贷款(元)
        longtermReceivableAccount:
          type: number
          description: longterm_receivable_account 长期应收款(元)
        mark:
          type: integer
          format: int32
          description: mark 备注说明
        minorityInterests:
          type: number
          description: minority_interests 非控股权益(元)
        mortagageDeposit:
          type: number
          description: mortagage_deposit 已抵押存款(元)
        mortagageDepositNCA:
          type: number
          description: mortagage_deposit_n_c_a 已抵押存款-非流动资产(元)
        nCAAdjItems:
          type: number
          description: n_c_a_adj_items 非流动资产调整项目(元)
        nCAExcepItems:
          type: number
          description: n_c_a_excep_items 非流动资产特殊项目(元)
        nCLAdjItems:
          type: number
          description: n_c_l_adj_items 非流动负债调整项目(元)
        nCLExcepItems:
          type: number
          description: n_c_l_excep_items 非流动负债特殊项目(元)
        nFOtherLoanNCL:
          type: number
          description: n_f_other_loan_n_c_l 其他贷款-非流动负债(元)
        negaGoodWill:
          type: number
          description: nega_good_will 负商誉(元)
        netCurrentLiability:
          type: number
          description: net_current_liability 净流动资产(元)
        nfAccruedBadDebtNCL:
          type: number
          description: nf_accrued_bad_debt_n_c_l 拨备-非流动负债(元)
        nfAssociateFundRecNCL:
          type: number
          description: nf_associate_fund_rec_n_c_l 应付关联方款项-非流动负债(元)
        nfDeferredProceedsNCL:
          type: number
          description: nf_deferred_proceeds_n_c_l 递延收入-非流动负债(元)
        nfFinanceLeaseOwesNCL:
          type: number
          description: nf_finance_lease_owes_n_c_l 融资租赁负债-非流动负债(元)
        notDecidedReserves:
          type: number
          description: not_decided_reserves 未决赔款准备(元)
        notDecidedReservesCL:
          type: number
          description: not_decided_reserves_c_l 未决赔款准备-流动负债(元)
        notDecidedReservesNCL:
          type: number
          description: not_decided_reserves_n_c_l 未决赔款准备-非流动负债(元)
        notMatuRiskReserves:
          type: number
          description: not_matu_risk_reserves 未到期风险准备金(元)
        notesPayable:
          type: number
          description: notes_payable 应付票据(元)
        oSecuInvestment:
          type: number
          description: o_secu_investment 其他证券投资(元)
        orgId:
          type: string
          description: 港股资产负债表 @author @date 2022-05-07 01:50:15 / @Data public class
            HkBalanceSheetResp { /** org_id 机构ID
        otherAccounetrece:
          type: number
          description: other_accounetrece 预付款按金及其他应收款(元)
        otherAccountAndPrepare:
          type: number
          description: other_account_and_prepare 其他帐项及准备(元)
        otherAssets:
          type: number
          description: other_assets 资产其他项目
        otherCurrentAssets:
          type: number
          description: other_current_assets 其他流动资产(元)
        otherCurrentLiability:
          type: number
          description: other_current_liability 其他流动负债(元)
        otherEquityinstruments:
          type: number
          description: other_equityinstruments 其他权益工具(元)
        otherFeesPayable:
          type: number
          description: other_fees_payable 其他应付款及应计费用(元)
        otherInvestment:
          type: number
          description: other_investment 其他投资(元)
        otherLiability:
          type: number
          description: other_liability 负债其他项目
        otherNonCurrentAssets:
          type: number
          description: other_non_current_assets 其他非流动资产(元)
        otherNonCurrentLiab:
          type: number
          description: other_non_current_liab 其他非流动负债(元)
        otherReserve:
          type: number
          description: other_reserve 其他储备(元)
        owesCertiOfGovHK:
          type: number
          description: owes_certi_of_gov_h_k 香港特区政府负债证明书(元)
        periodMark:
          $ref: 'enum.yaml#/PeriodMark'
        prepaidLeasePays:
          type: number
          description: prepaid_lease_pays 预付租赁付款(元)
        prepaidRentCA:
          type: number
          description: prepaid_rent_c_a 预付租金-流动资产(元)
        prepaidRentNCA:
          type: number
          description: prepaid_rent_n_c_a 预付租金-非流动资产(元)
        rMetal:
          type: number
          description: r_metal 贵金属(元)
        recoverTax:
          type: number
          description: recover_tax 可收回税项(元)
        refCapDeposit:
          type: number
          description: ref_cap_deposit 存出资本保证金(元)
        reinPremPayable:
          type: number
          description: rein_prem_payable 应付再保险保费(元)
        reinsAssets:
          type: number
          description: reins_assets 再保险资产(元)
        reinsuranceReceivables:
          type: number
          description: reinsurance_receivables 应收分保账款(元)
        reserve:
          type: number
          description: reserve 储备(元)
        reserveDeposits:
          type: number
          description: reserve_deposits 法定存款(元)
        reserveFund:
          type: number
          description: reserve_fund 法定储备(元)
        retBfitsResp:
          type: number
          description: ret_bfits_resp 退休福利责任(元)
        retainedProfit:
          type: number
          description: retained_profit 未分配利润(元)
        revaluationReserve:
          type: number
          description: revaluation_reserve 重估储备(元)
        sBbSecuProceeds:
          type: number
          description: s_bb_secu_proceeds 卖出回购金融资产款(元)
        sEAdjItems:
          type: number
          description: s_e_adj_items 股东权益调整项目(元)
        sEExcepItems:
          type: number
          description: s_e_excep_items 股东权益特殊项目(元)
        salariesPayable:
          type: number
          description: salaries_payable 应付职工薪酬(元)
        secuInvestment:
          type: number
          description: secu_investment 证券投资(元)
        shareCapital:
          type: number
          description: share_capital 股本(元)
        shareholderEquity:
          type: number
          description: shareholder_equity 股东权益(元)
        shortTermDeposit:
          type: number
          description: short_term_deposit 短期存款(元)
        shortTermInvest:
          type: number
          description: short_term_invest 短期投资(元)
        shortTermLoan:
          type: number
          description: short_term_loan 短期借款(元)
        simulantAllotDividend:
          type: number
          description: simulant_allot_dividend 拟派股息(元)
        soldRepoSecuProceeds:
          type: number
          description: sold_repo_secu_proceeds 卖出回购证券(元)
        stockPremium:
          type: number
          description: stock_premium 股本溢价(元)
        subCompanyEquity:
          type: number
          description: sub_company_equity 联营公司权益(元)
        subordDebt:
          type: number
          description: subord_debt 后偿负债(元)
        subordDebtIL:
          type: number
          description: subord_debt_i_l 应付次级债(元)
        subsAndOtherEquity:
          type: number
          description: subs_and_other_equity 附属公司及其他权益(元)
        suppCompEquity:
          type: number
          description: supp_comp_equity 附属公司权益(元)
        taxPayable:
          type: number
          description: tax_payable 应交税项(元)
        taxReceivable:
          type: number
          description: tax_receivable 预缴及应收税项(元)
        taxesPayable:
          type: number
          description: taxes_payable 应付税项(元)
        totalAssets:
          type: number
          description: total_assets 总资产(元)
        totalCurrentAssets:
          type: number
          description: total_current_assets 流动资产合计(元)
        totalCurrentLiability:
          type: number
          description: total_current_liability 流动负债合计(元)
        totalIntANCTLiability:
          type: number
          description: total_int_a_n_c_t_liability 总权益及非流动负债(元)
        totalIntATotalLiab:
          type: number
          description: total_int_a_total_liab 总权益及总负债(元)
        totalInterests:
          type: number
          description: total_interests 总权益(元)
        totalLiability:
          type: number
          description: total_liability 总负债(元)
        totalNonCurrentAssets:
          type: number
          description: total_non_current_assets 非流动资产合计(元)
        totalNonCurrentLiab:
          type: number
          description: total_non_current_liab 非流动负债合计(元)
        tradeBill:
          type: number
          description: trade_bill 贸易票据(元)
        tradingAssets:
          type: number
          description: trading_assets 交易性金融资产(元)
        unearnedPremiumReserve:
          type: number
          description: unearned_premium_reserve 未到期责任准备金(元)
        workshopAndEquipment:
          type: number
          description: workshop_and_equipment 物业厂房及设备(元)
        yoyGrowthInTotalAssets:
          type: number
          description: yoy_growth_in_total_assets 总资产同比增长
        yoyGrowthInTotalLiability:
          type: number
          description: yoy_growth_in_total_liability 总负债同比增长
    HkOpenApiCashflowStatement:
      type: object
      description: 港股现金流量
      properties:
        absorbInvestIncome:
          type: number
          description: 吸收投资所得(元)
        accPayableChange:
          type: number
          description: 应付帐款增加(减少)(元)
        accRePayableChange:
          type: number
          description: 应付分保帐款增(减)(元)
        accReceivChange:
          type: number
          description: 应收帐款(增加)减少(元)
        accountingStandards:
          type: integer
          format: int32
          description: 会计准则
        adjItemsManageAdj:
          type: number
          description: 经营调整调整项目(元)
        adjItemsOpeBusi:
          type: number
          description: 经营业务调整项目(元)
        adjItemsWCapChange:
          type: number
          description: 营运资本变动其他项目(元)
        advPaymentChange:
          type: number
          description: 预付款项(增)减(元)
        advReceiptsChange:
          type: number
          description: 预收款项增(减)(元)
        affilCompProfAloss:
          type: number
          description: 应占附属公司(盈)亏(元)
        bBackSFAssetsChange:
          type: number
          description: 买入返售金融资产(增)减(元)
        bankDepositChange:
          type: number
          description: 银行存款(增)减(元)
        bankDeposits:
          type: number
          description: 银行存款(元)
        beginDate:
          type: string
          format: date-time
          description: 开始日期
        beginPeriodCash:
          type: number
          description: 期初现金(元)
        bfaafValOnPLChange:
          type: number
          description: 按公平值计入损益的金融资产(增)减(元)
        bflafValOnPLChange:
          type: number
          description: 按公平值计入损益的金融负债增(减)(元)
        borFromCBChange:
          type: number
          description: 向中央银行借款增(减)(元)
        cInFVofDerFinInst:
          type: number
          description: 衍生金融工具公平值(增)减(元)
        cInFVofInvPropert:
          type: number
          description: 其中:投资物业公平值(增)减(元)
        cInFVofOtherAssets:
          type: number
          description: 其他公平值变动(元)
        cashABankBalances:
          type: number
          description: 现金及银行结余(元)
        cashAndOtherBefFin:
          type: number
          description: 融资前现金其他项目(元)
        cashCashEquival:
          type: number
          description: 现金及现金等值项目结余(元)
        cashEndPer:
          type: number
          description: 期末现金(元)
        cashReceiptsFOpe:
          type: number
          description: 经营业务现金收入(元)
        chinaIncomeTaxPaid:
          type: number
          description: 已缴中国所得税(元)
        companyType:
          type: integer
          format: int32
          description: 公司类别
        currencyUnit:
          type: integer
          format: int32
          description: 货币类别
        cusDepositsChange:
          type: number
          description: 客戶存款增(减)(元)
        depDividerSale:
          type: number
          description: '折旧及摊销(元):'
        depositChange:
          type: number
          description: 存款减少(增加)(元)
        depreciation:
          type: number
          description: 其中:折旧(元)
        derFinInstChange:
          type: number
          description: 衍生金融工具(增)减(元)
        devalAndAccBadDebt:
          type: number
          description: '减值与拨备(元):'
        devalofAvaForSaleInv:
          type: number
          description: 可供出售投资减值(回拨)(元)
        devalofGoodwill:
          type: number
          description: 商誉减值(元)1
        devalofInventories:
          type: number
          description: 存货减值(回拨)(元)
        devalofOthers:
          type: number
          description: 其他减值与拨备(元)
        devalofProPlEquip:
          type: number
          description: 其中:物业、厂房及设备减值(回拨)(元)
        devalofTradeRece:
          type: number
          description: 应收贸易账款减值(回拨)(元)
        disinvestmentCash:
          type: number
          description: 收回投资所得现金(元)
        dividendIncomeAd:
          type: number
          description: 股息(收入)-调整(元)
        dividendPaidBo:
          type: number
          description: 己付股息-经营(元)
        dividendPaidFB:
          type: number
          description: 已付股息-融资(元)
        dividendsRecBo:
          type: number
          description: 已收股息-经营(元)
        dividendsRecIb:
          type: number
          description: 已收股息-投资(元)
        earningBeforeTax:
          type: number
          description: 除税前溢利(元)
        effectOfRate:
          type: number
          description: 汇率影响(元)
        endDate:
          type: string
          format: date-time
          description: 截止日期
        exchangeIncome:
          type: number
          description: 汇兑损(益)(元)
        faafValOnPlChange:
          type: number
          description: 按公平值计入损益的金融资产(增)减(元)
        financeAdjustedItems:
          type: number
          description: 融资业务调整项目(元)
        financeAdjustedOther:
          type: number
          description: 融资业务其他项目(元)
        financeAndSpeItems:
          type: number
          description: 融资费用等特殊项目(元)
        financialExpense:
          type: number
          description: 财务费用(元)
        fiscalYear:
          type: string
          format: date-time
          description: 财政年度
        flafValOnPlChange:
          type: number
          description: 按公平值计入损益的金融负债增(减)(元)
        hkProfitsTaxPaid:
          type: number
          description: 已缴香港利得税(元)
        infoPublDate:
          type: string
          format: date-time
          description: 信息发布日期
        infoSource:
          type: string
          description: 信息来源
        infoSourceCode:
          $ref: 'enum.yaml#/DateTypeConvertUtil'
        insertTime:
          type: string
          format: date-time
          description: 发布时间
        insuContLiabChange:
          type: number
          description: 保险合同负债增(减)(元)
        insuReceivChange:
          type: number
          description: 保险业务应收款(增)减(元)
        intangibleAssetAmort:
          type: number
          description: 无形资产摊销(元)1
        interestExpAd:
          type: number
          description: 利息支出-调整(元)
        interestIncomeAd:
          type: number
          description: 利息(收入)-调整(元)
        interestPaidBo:
          type: number
          description: 已付利息-经营(元)
        interestPaidCb:
          type: number
          description: 支付利息-现金结存(元)
        interestPaidFB:
          type: number
          description: 已付利息-融资(元)
        interestRecBo:
          type: number
          description: 已收利息-经营(元)
        interestRecCb:
          type: number
          description: 收取利息-现金结存(元)
        interestRecIb:
          type: number
          description: 已收利息-投资(元)
        inventoryChange:
          type: number
          description: 存货(增加)减少(元)
        investAdjustedItems:
          type: number
          description: 投资业务调整项目(元)
        investAdjustedOther:
          type: number
          description: 投资业务特殊项目(元)
        investPaymentCash:
          type: number
          description: 投资支付现金(元)
        investProfAloss:
          type: number
          description: 投资损(益)(元)
        issExpAPayOfRedSecu:
          type: number
          description: 发行费用及赎回证券支出(元)
        issueBonds:
          type: number
          description: 发行债券(元)
        issueShares:
          type: number
          description: 发行股份(元)
        itemsPeriod:
          type: number
          description: 期间变动其他项目(元)
        loanReceivableChange:
          type: number
          description: 应收贷款(增)减(元)
        loansAAdvanChange:
          type: number
          description: 发放贷款及垫款(增)减(元)
        mark:
          type: integer
          format: int32
          description: 合并调整标志
        netCash:
          type: number
          description: 现金净额(元)
        netCashBeforFinance:
          type: number
          description: 融资前现金净额(元)
        netCashFromFinance:
          type: number
          description: 融资业务现金净额(元)
        netInvbusiCFlow:
          type: number
          description: 投资业务现金净额(元)
        netOpeCFlow:
          type: number
          description: 经营业务现金净额(元)
        newLoan:
          type: number
          description: 新增借款(元)
        opeProBefChgInOpeCap:
          type: number
          description: 经营资金变动前经营溢利(元)
        orgId:
          type: string
          description: 港股现金流量 @author @date 2021-08-14 / @Data public class HkCashflowStatementResp
            { /** 机构ID
        otherDepDividerSale:
          type: number
          description: 其他折旧及摊销(元)
        otherItemsAffectNc:
          type: number
          description: 影响现金净额其他项目(元)
        otherTaxes:
          type: number
          description: 其他税项(元)
        periodMark:
          $ref: 'enum.yaml#/PeriodMark'
        pledgedDepositChange:
          type: number
          description: 已抵押银行存款(增)减(元)
        proUnderDevelChange:
          type: number
          description: 发展中物业(增)减(元)
        profDispOfAFSaleInv:
          type: number
          description: 其中:出售可供出售投资损(益)(元)
        profDispOfAffCEqu:
          type: number
          description: 出售附属公司权益损(益)(元)
        profDispOfOthAssets:
          type: number
          description: 出售其他资产损(益)(元)
        profDispOfProPlEquip:
          type: number
          description: 出售物业、机器及设备损(益)(元)
        profitDispOfAssets:
          type: number
          description: '出售资产损(益)(元):'
        purAffCompanies:
          type: number
          description: 收购附属公司(元)
        purCapitalAssents:
          type: number
          description: 购买固定资产(元)
        purIntassets:
          type: number
          description: 购买无形资产(元)
        refund:
          type: number
          description: 偿还借款(元)
        restrictCashChange:
          type: number
          description: 受限制现金(增)减(元)
        revaluationSurplus:
          type: number
          description: '重估盈余(元):'
        speItemsManageAdj:
          type: number
          description: 经营调整特殊项目(元)
        speItemsOpeAchange:
          type: number
          description: 经营资产变动其他项目(元)
        speItemsOpeBusi:
          type: number
          description: 经营业务其他项目(元)
        speItemsOpeLchange:
          type: number
          description: 经营负债变动其他项目(元)
        speItemsWCapChange:
          type: number
          description: 营运资金变动调整项目(元)
        unrealExchangeIncome:
          type: number
          description: 未实现汇兑损(益)(元)
        updateTime:
          type: string
          format: date-time
          description: 更新时间
        vendAffCompanies:
          type: number
          description: 出售附属公司(元)
        vendCapitalAssents:
          type: number
          description: 出售固定资产(元)
        vendIntassets:
          type: number
          description: 出售无形资产(元)
        yoyGrowthInNetOpeCFlow:
          type: number
          description: yoy_growth_in_net_op_cash_flow 现金流同比增长

    USStockFinancial:
      type: object
      properties:
        usMainFinancialInfoResp:
          $ref: "#/components/schemas/UsOpenApiMainFinancialInfoResp"
        usCashFlowResp:
          $ref: "#/components/schemas/UsOpenApiCashFlowResp"
        usBalanceSheetResp:
          $ref: "#/components/schemas/UsOpenApiBalanceSheetResp"
        usIncomeStatementResp:
          $ref: "#/components/schemas/UsOpenApiIncomeStatementResp"

    UsOpenApiCashFlowResp:
      type: object
      description: 美股现金流量表
      properties:
        acquisitionOfFixedAssets:
          type: number
        amortizationOfGross:
          type: number
        cashDividendPayment:
          type: number
        cashFlowFromFinancingActivities:
          type: number
        cashFlowFromInvestingActivities:
          type: number
        cashFlowFromOperActivities:
          type: number
        cashIncome:
          type: number
        cashInterestPayment:
          type: number
        cashOutlay:
          type: number
        cashTaxPayment:
          type: number
        changesInWorkingCapital:
          type: number
        companyNature:
          type: string
        companyNatureCode:
          type: integer
          format: int32
        createdTime:
          type: string
          format: date-time
        deferredTax:
          type: number
        endDate:
          type: string
          format: date-time
        exchangeRate:
          type: number
        exchangeRateDate:
          type: string
          format: date-time
        financingProject:
          type: number
        fiscalPeriodNumber:
          type: integer
          format: int32
        fiscalYear:
          type: integer
          format: int32
        infoSource:
          type: string
        infoSourceCode:
          $ref: 'enum.yaml#/InfoSourceEnum'
        insertTime:
          type: string
          format: date-time
        isDeleted:
          type: integer
          format: int32
          description: 0/1 等，对应 Java Byte
        modifiedTime:
          type: string
          format: date-time
        netBorrowing:
          type: number
        netCashFlowOfIssuedOrEliminatedShares:
          type: number
        noncashItems:
          type: number
        orgId:
          type: string
        periodLength:
          type: string
        periodMark:
          $ref: 'enum.yaml#/PeriodMark'
        reportingCurrency:
          type: string
        retainedProfits:
          type: number
        totalCashFlowsFromOtherInvestments:
          type: number
        totalOfDepreciationAndConsumption:
          type: number
        updateTime:
          type: string
          format: date-time
        yoyGrowthInNetOpCashFlow:
          type: number
      required:
      - createdTime
      - endDate
      - fiscalYear
      - isDeleted
      - modifiedTime
      - orgId
      - periodMark
      - updateTime
    UsOpenApiMainFinancialInfoResp:
      type: object
      description: 美股主要财务指标
      properties:
        createdTime:
          type: string
          format: date-time
        dividendPerShare:
          type: number
        dividendPerShareAdr:
          type: number
        endDate:
          type: string
          format: date-time
        eps:
          type: number
        epsAdr:
          type: number
        epsBasic:
          type: number
        epsBasicAdr:
          type: number
        exchangeRate:
          type: number
        exchangeRateDate:
          type: string
          format: date-time
        infoSource:
          type: string
        infoSourceCode:
          $ref: 'enum.yaml#/InfoSourceEnum'
        isDeleted:
          type: integer
          format: int32
          description: 0/1 等，对应 Java Byte
        modifiedTime:
          type: string
          format: date-time
        netAssetValuePerShare:
          type: number
        netAssetValuePerShareAdr:
          type: number
        netOperatingCashFlowPerShare:
          type: number
        netOperatingCashFlowPerShareAdr:
          type: number
        operatingIncomePerShare:
          type: number
        operatingIncomePerShareAdr:
          type: number
        orgId:
          type: string
        priceCurrency:
          type: string
        reportingCurrency:
          type: string
        yoyGrowthInBasicEps:
          type: number
      required:
      - createdTime
      - isDeleted
      - modifiedTime
      - orgId
    UsOpenApiBalanceSheetResp:
      type: object
      description: 美股资产负债表
      properties:
        accountsPayable:
          type: number
        accruedCharge:
          type: number
        accruedUnpaid:
          type: number
        accumulatedDepreciation:
          type: number
        borrowingAmount:
          type: number
        capitalReserve:
          type: number
        capitalizedLease:
          type: number
        cash:
          type: number
        cashAndCashEquivalents:
          type: number
        cashAndShortTermInvestments:
          type: number
        companyNature:
          type: string
        companyNatureCode:
          type: integer
          format: int32
        costOfDeferredPolicyPurchase:
          type: number
        createdTime:
          type: string
          format: date-time
        currentInvestment:
          type: number
        deferredIncomeTax:
          type: number
        depositAmount:
          type: number
        depositBankCashAndFunds:
          type: number
        endDate:
          type: string
          format: date-time
        esopDebtGuarantee:
          type: number
        exchangeRate:
          type: number
        exchangeRateDate:
          type: string
          format: date-time
        fiscalPeriodNumber:
          type: integer
          format: int32
        fiscalYear:
          type: integer
          format: int32
        fundedDebt:
          type: number
        immobilisations:
          type: number
        infoSource:
          type: string
        infoSourceCode:
          $ref: 'enum.yaml#/InfoSourceEnum'
        insertTime:
          type: string
          format: date-time
        isDeleted:
          type: integer
          format: int32
          description: 0/1 等，对应 Java Byte
        longTermLiabilitiesOrCapitalizedLeasesDueWithin1y:
          type: number
        minorityEquity:
          type: number
        modifiedTime:
          type: string
          format: date-time
        netAmountTotalUtilitiesPlantAndEquipment:
          type: number
        netCredit:
          type: number
        netIntangibleAssets:
          type: number
        netReceivables:
          type: number
        netValueOfFixedAssets:
          type: number
        netValueOfGoodwill:
          type: number
        notesPayableOrShortTermDebt:
          type: number
        notesReceivableLongTerm:
          type: number
        orgId:
          type: string
        periodMark:
          $ref: 'enum.yaml#/PeriodMark'
        permanentInvestment:
          type: number
        premiumReceivable:
          type: number
        prepayment:
          type: number
        reportingCurrency:
          type: string
        retainedEarnings:
          type: number
        totalAssets:
          type: number
        totalCommonStock:
          type: number
        totalCurrentAssets:
          type: number
        totalCurrentLiabilities:
          type: number
        totalInventory:
          type: number
        totalLiabilities:
          type: number
        totalLiabilitiesAndShareholdersEquity:
          type: number
        totalLongTermBorrowings:
          type: number
        totalNonCallablePreferredStock:
          type: number
        totalOfOtherEarningAssets:
          type: number
        totalOfOtherInterestBearingLiabilities:
          type: number
        totalOtherAssets:
          type: number
        totalOtherCurrentAssets:
          type: number
        totalOtherCurrentLiabilities:
          type: number
        totalOtherInterests:
          type: number
        totalOtherLiabilities:
          type: number
        totalOtherLongTermAssets:
          type: number
        totalOutstandingSharesOrdinaryShares:
          type: number
        totalOutstandingSharesPreferredShares:
          type: number
        totalPolicyLiabilities:
          type: number
        totalReceivables:
          type: number
        totalRedeemablePreferredStock:
          type: number
        totalShareholdersEquity:
          type: number
        totalShortTermBorrowings:
          type: number
        treasuryStockCommonStock:
          type: number
        unrealizedGainsOrLosses:
          type: number
        updateTime:
          type: string
          format: date-time
      required:
      - createdTime
      - endDate
      - fiscalYear
      - isDeleted
      - modifiedTime
      - orgId
      - periodMark
      - updateTime
    UsOpenApiIncomeStatementResp:
      type: object
      description: 美股利润表
      properties:
        allowanceForLoanLossesAdjustedForNetInterestIncome:
          type: number
        allowanceOfFundsUsedDuringConstruction:
          type: number
        amortizationOfPolicyPurchaseCosts:
          type: number
        companyNature:
          type: string
        companyNatureCode:
          type: integer
          format: int32
        depreciationAndAmortization:
          type: number
        developmentAndResearchFees:
          type: number
        dilutedEps:
          type: number
        dilutedEpsAdr:
          type: number
        dilutedNetIncome:
          type: number
        dilutedWeightedAvgShares:
          type: number
        dividendPerShare:
          type: number
        dividendPerShareAdr:
          type: number
        endDate:
          type: string
          format: date-time
        eps:
          type: number
        exchangeRate:
          type: number
        exchangeRateDate:
          type: string
          format: date-time
        fiscalPeriodNumber:
          type: integer
          format: int32
        fiscalYear:
          type: integer
          format: int32
        fuelCost:
          type: number
        gainsAndLossesOnAssetSales:
          type: number
        grossPremiumIncome:
          type: number
        grossProfit:
          type: number
        infoSource:
          type: string
        infoSourceCode:
          $ref: 'enum.yaml#/InfoSourceEnum'
        insertTime:
          type: string
          format: date-time
        interestExpTotal:
          type: number
        interestRevenue:
          type: number
        loanLossReserves:
          type: number
        mainBusinessIncome:
          type: number
        minorityEquity:
          type: number
        netInterestExpeSubBusinessIncome:
          type: number
        netInterestExpeSubNonbusinessIncome:
          type: number
        netInterestIncome:
          type: number
        netInvestmentRevenue:
          type: number
        netProfitAfterTax:
          type: number
        netProfitBeforeTax:
          type: number
        nonInterestExpe:
          type: number
        nonInterestIncome:
          type: number
        nonRecurringIncome:
          type: number
        operatingAndMaintenanceCost:
          type: number
        operationRevenue:
          type: number
        orgId:
          type: string
        otherTotalIncome:
          type: number
        periodLength:
          type: string
        periodMark:
          $ref: 'enum.yaml#/PeriodMark'
        provisionForIncomeTax:
          type: number
        realizedAndUnrealizedRevenue:
          type: number
        reportingCurrency:
          type: string
        revenueOfStockholdersAfterDeductSpecialItems:
          type: number
        revenueOfStockholdersBeforeDeductSpecialItems:
          type: number
        sellingAndManageExpTotal:
          type: number
        subsidiaryInterest:
          type: number
        totalCostOfRevenue:
          type: number
        totalIncome:
          type: number
        totalOperatingExpe:
          type: number
        totalOtherOperatingExpe:
          type: number
        updateTime:
          type: string
          format: date-time
        yoyGrowthInNetProfit:
          type: number
      required:
      - endDate
      - fiscalYear
      - orgId
      - periodMark
      - updateTime
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Token

path: references/enum.yaml
content: TickerDirect:
  type: string
  description: |
    逐笔成交方向
    - NONE: 未知
    - BUY: 外盘
    - SELL: 内盘
    - NEUTRAL: 中性盘
  enum:
    - NONE
    - BUY
    - SELL
    - NEUTRAL

QuoteSortField:
  type: string
  description: 行情/排序字段
  enum:
    - lastPrice
    - raisePercent
    - raise
    - exchange
    - raiseSpeed
    - mainNetInflow
    - totalTradeVol
    - totalTurnover
    - volumeRatio
    - entrustRatio
    - amplitude
    - highPrice
    - lowPrice
    - openPrice
    - preClose
    - peDynamic
    - peRatio
    - circulationValue
    - marketValue
    - iopv
    - nominalPrice
    - stockRaisePercent
    - increaseNum
    - roe
    - pnaRatio
    - raisePercentOneYear
    - leverageRatio
    - maturityDay
    - exercisePrice
    - percOfStillOut
    - premiumRatio
    - effectiveGearing
    - pStrPrice
    - pStrPriceSpread
    - bid1Price
    - ask1Price
    - currencyOneCode
    - currencySecondCode
    - orderNum
    - baseOrderNum
    - raisePercent1y
    - raisePercent1m
    - raisePercentYtd
    - assetSize
    - shareIssued

Markets:
  type: string
  enum:
    - HK
    - SG
    - US

TickerType:
  type: string
  description: |
    逐笔类型枚举
    
    枚举说明：
    - UNKNOWN: 未知
    - AUTO_MATCH: 自动对盘
    - LATE: 开市前成交盘
    - NON_AUTO_MATCH: 非自动对盘
    - INTER_AUTO_MATCH: 同一证券商自动对盘
    - INTER_NON_AUTO_MATCH: 同一证券商非自动对盘
    - ODD_LOT: 碎股交易
    - AUCTION: 竞价交易
    - BULK: 批量交易
    - CRASH: 现金交易
    - CROSS_MARKET: 跨市场交易
    - BULK_SOLD: 批量卖出
    - FREE_ON_BOARD: 离价交易
    - RULE127_OR155: 第127条交易（纽交所规则）或第155条交易
    - DELAY: 延迟交易
    - MARKET_CENTER_CLOSE_PRICE: 中央收市价
    - NEXT_DAY: 隔日交易
    - MARKET_CENTER_OPENING: 中央开盘价交易
    - PRIOR_REFERENCE_PRICE: 前参考价
    - MARKET_CENTER_OPEN_PRICE: 中央开盘价
    - SELLER: 卖方
    - T: T类交易（盘前和盘后交易）
    - EXTENDED_TRADING_HOURS: 延长交易时段
    - CONTINGENT: 合单交易
    - AVERAGE_PRICE: 平均价成交
    - OTC_SOLD: 场外售出
    - ODD_LOT_CROSS_MARKET: 碎股跨市场交易
    - DERIVATIVELY_PRICED: 衍生工具定价
    - REOPENINGP_RICED: 再开盘定价
    - CLOSING_PRICED: 收盘定价
    - COMPREHENSIVE_DELAY_PRICE: 综合延迟价格
    - OVERSEAS: 交易的一方不是香港交易所的成员，属于场外交易
  enum:
    - UNKNOWN
    - AUTO_MATCH
    - LATE
    - NON_AUTO_MATCH
    - INTER_AUTO_MATCH
    - INTER_NON_AUTO_MATCH
    - ODD_LOT
    - AUCTION
    - BULK
    - CRASH
    - CROSS_MARKET
    - BULK_SOLD
    - FREE_ON_BOARD
    - RULE127_OR155
    - DELAY
    - MARKET_CENTER_CLOSE_PRICE
    - NEXT_DAY
    - MARKET_CENTER_OPENING
    - PRIOR_REFERENCE_PRICE
    - MARKET_CENTER_OPEN_PRICE
    - SELLER
    - T
    - EXTENDED_TRADING_HOURS
    - CONTINGENT
    - AVERAGE_PRICE
    - OTC_SOLD
    - ODD_LOT_CROSS_MARKET
    - DERIVATIVELY_PRICED
    - REOPENINGP_RICED
    - CLOSING_PRICED
    - COMPREHENSIVE_DELAY_PRICE
    - OVERSEAS

DarkStatus:
  type: string
  description: |
    暗盘状态：
    - NONE: 无暗盘交易
    - TRADING: 暗盘交易中
    - END: 暗盘交易结束
  enum:
    - NONE
    - TRADING
    - END
  example: NONE

AssetClass:
  type: string
  enum:
    - UNKNOW #未知
    - STOCK #股票
    - BOND #债券
    - COMMODITY #商品
    - CURRENCY_MARKET #货币市场
    - FUTURE #期货
    - SWAO #掉期（互换）

SecurityStatus:
  type: string
  enum:
    - NONE #未知
    - NORMAL #正常状态
    - LISTING #待上市
    - PURCHASING #申购中
    - SUBSCRIBING #认购中
    - BEFORE_DRAK_TRADE_OPENING #暗盘开盘前
    - DRAK_TRADING #暗盘交易中
    - DRAK_TRADE_END #暗盘已收盘
    - TO_BE_OPEN #待开盘
    - SUSPENDED #停牌
    - CALLED #已收回
    - EXPIRED_LAST_TRADING_DATE #已过最后交易日
    - EXPIRED #已过期
    - DELISTED #已退市
    - CHANGE_TO_TEMPORARY_CODE #公司行动中，交易关闭，转至临时代码交易
    - TEMPORARY_CODE_TRADE_END #临时买卖结束，交易关闭
    - CHANGED_PLATE_TRADE_END #已转板，旧代码交易关闭
    - CHANGED_CODE_TRADE_END #已换代码，旧代码交易关闭
    - RECOVERABLE_CIRCUIT_BREAKER #可恢复性熔断
    - UN_RECOVERABLE_CIRCUIT_BREAKER #不可恢复性熔断
    - AFTER_COMBINATION #盘后撮合
    - AFTER_TRANSATION #盘后交易

OptionAreaType:
  type: string
  enum:
    - NONE #未知
    - AMERICAN #美式
    - EUROPEAN #欧式
    - BERMUDA #百慕大

IndexOptionType:
  type: string
  enum:
    - NONE #未知
    - NORMAL #普通的指数期权
    - SMALL #小型指数期权

OptionType:
  type: string
  enum:
    - ALL #所有
    - CALL #看涨期权
    - PUT #看跌期权

PriceType:
  type: string
  enum:
    - UNKNOW #未知
    - OUTSIDE #价外，界内证表示界外
    - WITH_IN #价内，界内证表示界内

WrtType:
  type: string
  enum:
    - NONE #未知
    - CALL #认购涡轮
    - PUT #认估涡轮
    - BULL #牛证
    - BEAR #熊证
    - INLINE #界内证

AuType:
  type: string
  description: |
    - NONE 不复权
    - QFQ 前复权
    - HFQ 后复权
  enum:
    - NONE
    - QFQ
    - HFQ

MarketTradingState:
  type: string
  enum:
    - NONE
    - AUCTION
    - WAITING_OPEN
    - MORNING
    - REST
    - AFTERNOON
    - CLOSED
    - PRE_MARKET_BEGIN
    - PRE_MARKET_END
    - AFTER_HOURS_BEGIN
    - AFTER_HOURS_END
    - OVERNIGHT
    - NIGHT_OPEN
    - NIGHT_END
    - NIGHT
    - TRADE_AT_LAST
    - FUTURE_DAY_OPEN
    - FUTURE_DAY_BREAK
    - FUTURE_DAY_CLOSE
    - FUTURE_DAY_WAIT_OPEN
    - HK_CAS
    - FUTURE_NIGHT_WAIT
    - FUTURE_AFTERNOON
    - FUTURE_SWITCH_DATE
    - FUTURE_OPEN
    - FUTURE_BREAK
    - FUTURE_BREAK_OVER
    - FUTURE_CLOSE
  descriptions: ｜
    - NONE 无交易
    - AUCTION 盘前竞价
    - WAITING_OPEN 等待开盘
    - MORNING 早盘
    - REST 午间休市
    - AFTERNOON 午盘/持续交易时段
    - CLOSED 收盘
    - PRE_MARKET_BEGIN 美股盘前交易时段开始
    - PRE_MARKET_END 美股盘前交易时段结束
    - AFTER_HOURS_BEGIN 美股盘后交易时段开始
    - AFTER_HOURS_END 美股盘后交易时段结束
    - OVERNIGHT 美股夜盘交易时段
    - NIGHT_OPEN 夜市交易时段开始
    - NIGHT_END 夜市交易时段结束
    - NIGHT 美指期权夜市交易时段
    - TRADE_AT_LAST 美指期权盘尾交易时段
    - FUTURE_DAY_OPEN 日市交易时段
    - FUTURE_DAY_BREAK 日市休市
    - FUTURE_DAY_CLOSE 日市收盘
    - FUTURE_DAY_WAIT_OPEN 期货待开盘
    - HK_CAS 港股盘后竞价
    - FUTURE_NIGHT_WAIT 夜市等待开盘（已废弃）
    - FUTURE_AFTERNOON 期货下午开盘（已废弃）
    - FUTURE_SWITCH_DATE 美期待开盘
    - FUTURE_OPEN 美期交易时段
    - FUTURE_BREAK 美期中盘休息
    - FUTURE_BREAK_OVER 美期休息后交易时段
    - FUTURE_CLOSE 美期收盘

KLType:
  type: string
  description: |
    - NONE 未知
    - K_1M 1分钟K线
    - K_DAY 日K
    - K_WEEK 周K
    - K_MON 月K
    - K_YEAR 年K
    - K_5M 5分钟K线
    - K_15M 15分钟K线
    - K_30M 30分钟K线
    - K_60M 60分钟K线
    - K_3M 3分钟K线
    - K_QUARTER 季K
  enum:
    - NONE
    - K_1_M
    - K_DAY
    - K_WEEK
    - K_MON
    - K_YEAR
    - K_5_M
    - K_15_M
    - K_30_M
    - K_60_M
    - K_120_M
    - K_QUARTER

PeriodType:
  type: string
  description: |
    - INTRADAY 实时
    - DAY 日
    - WEEK 周
    - MONTH 月
  enum:
    - INTRADAY
    - DAY
    - WEEK
    - MONTH
  example: DAY

# ---------- 衍生品（参考 Futu OpenAPI） ----------
OptionCondType:
  type: string
  description: 期权价内外类型
  enum:
    - ALL
    - IN
    - OUT

WarrantSortField:
  type: string
  description: 窝轮筛选排序字段
  enum:
    - CODE
    - CUR_PRICE
    - PREMIUM
    - LEVERAGE_RATIO
    - DELTA
    - IMPLIED
    - MATURITY_TIME
    - STRIKE_PRICE
    - VOLUME
    - TURNOVER

# 全市场筛选
Market:
  type: string
  description: 市场（Futu 行情）
  enum:
    - HK
    - US
    - SH
    - SZ
    - BK
    - SG
    - JPN
    - FRA
    - GER
    - FX
    - BKHK
    - BKUS
    - UK
    - CC
    - PJ

PlateClass:
  type: string
  description: 板块分类（get_plate_list）
  enum:
    - ALL
    - INDUSTRY
    - REGION
    - CONCEPT
    - OTHER

SecurityType:
  type: string
  description: 证券类型（get_stock_basicinfo）
  enum:
    - STOCK
    - IDX
    - ETF
    - WARRANT
    - BOND
    - ALL

PlateStockSortField:
  description: 板块内股票排序字段（get_plate_stock）
  type: string
  enum:
    - 2070001
    - 2070002
    - 2070003
    - 2070004
    - 2070005
    - 2070006
    - 2070007
    - 2070101
    - 2070102
    - 2070103
    - 2070201
    - 2070202
    - 2070203
    - 2070204
    - 2070205
    - 2070210
    - 2070220
    - 2070230
    - 2070240

PlateCode:
  type: string
  description: 板块代码（listed_sector_code）
  enum:
    - 2070001
    - 2070002
    - 2070003
    - 2070004
    - 2070005
    - 2070006
    - 2070007
    - 2070101
    - 2070102
    - 2070103
    - 2070201
    - 2070202
    - 2070203
    - 2070204
    - 2070205
    - 2070210
    - 2070220
    - 2070230
    - 2070240

StockField:
  type: string
  description: |
    股票字段
    - NONE: 未知
    - STOCK_CODE: 股票代码，不能填区间上下限值。
    - STOCK_NAME: 股票名称，不能填区间上下限值。
    - CUR_PRICE: 最新价
    - CUR_PRICE_TO_HIGHEST52_WEEKS_RATIO: 离 52 周高点百分比
    - CUR_PRICE_TO_LOWEST52_WEEKS_RATIO: 离 52 周低点百分比
    - HIGH_PRICE_TO_HIGHEST52_WEEKS_RATIO: (今日最高-52周最高)/52周最高
    - LOW_PRICE_TO_LOWEST52_WEEKS_RATIO: (今日最低-52周最低)/52周最低
    - VOLUME_RATIO: 量比
    - BID_ASK_RATIO: 委比
    - LOT_PRICE: 每手价格
    - MARKET_VALUE: 市值
    - PE_ANNUAL: 市盈率（静态）
    - PE_TTM: 市盈率TTM
    - PB_RATIO: 市净率
    - CHANGE_RATE_5MIN: 5分钟涨跌幅
    - CHANGE_RATE_BEGIN_YEAR: 年初至今涨跌幅
    - PS_TTM: 市销率TTM
    - PCF_TTM: 市现率TTM
    - TOTAL_SHARE: 总股本
    - FLOAT_SHARE: 流通股本
    - FLOAT_MARKET_VAL: 流通市值
    - CHANGE_RATE: 涨跌幅
    - AMPLITUDE: 振幅
    - VOLUME: 日均成交量
    - TURNOVER: 日均成交额
    - TURNOVER_RATE: 换手率
  enum:
    - NONE
    - STOCK_CODE
    - STOCK_NAME
    - CUR_PRICE
    - CUR_PRICE_TO_HIGHEST52_WEEKS_RATIO
    - CUR_PRICE_TO_LOWEST52_WEEKS_RATIO
    - HIGH_PRICE_TO_HIGHEST52_WEEKS_RATIO
    - LOW_PRICE_TO_LOWEST52_WEEKS_RATIO
    - VOLUME_RATIO
    - BID_ASK_RATIO
    - LOT_PRICE
    - MARKET_VALUE
    - PE_ANNUAL
    - PE_TTM
    - PB_RATIO
    - CHANGE_RATE_5MIN
    - CHANGE_RATE_BEGIN_YEAR
    - PS_TTM
    - PCF_TTM
    - TOTAL_SHARE
    - FLOAT_SHARE
    - FLOAT_MARKET_VAL
    - CHANGE_RATE
    - AMPLITUDE
    - VOLUME
    - TURNOVER
    - TURNOVER_RATE

SortDir:
  type: string
  description: 排序方向（SortDir）
  enum:
    - ASCEND
    - DESCEND

RelativePosition:
  type: string
  description: 相对位置（RelativePosition）
  enum:
    - UNKNOWN
    - MORE
    - LESS
    - CROSS_UP
    - CROSS_DOWN

FinancialQuarter:
  type: string
  description: 财报累积时间（FinancialQuarter）
  enum:
    - UNKNOWN
    - ANNUAL
    - FIRST_QUARTER
    - INTERIM
    - THIRD_QUARTER
    - MOST_RECENT_QUARTER

FinancialStockField:
  type: string
  description: |
    财务过滤属性
    - NONE: 未知
    - NET_PROFIT: 净利润
    - NET_PROFIT_GROWTH: 净利润增长率
    - SUM_OF_BUSINESS: 营业收入
    - SUM_OF_BUSINESS_GROWTH: 营收同比增长率
    - NET_PROFIT_RATE: 净利率
    - GROSS_PROFIT_RATE: 毛利率
    - DEBT_ASSET_RATE: 资产负债率
    - RETURN_ON_EQUITY_RATE: 净资产收益率
    - ROIC: 投入资本回报率
    - ROA_TTM: 资产回报率 TTM
    - EBIT_TTM: 息税前利润 TTM
    - EBITDA: 税息折旧及摊销前利润
    - OPERATING_MARGIN_TTM: 营业利润率 TTM
    - EBIT_MARGIN: EBIT 利润率
    - EBITDA_MARGIN: EBITDA 利润率
    - FINANCIAL_COST_RATE: 财务成本率
    - OPERATING_PROFIT_TTM: 营业利润 TTM
    - SHAREHOLDER_NET_PROFIT_TTM: 归属于母公司的净利润
    - NET_PROFIT_CASH_COVER_TTM: 盈利中的现金收入比例
    - CURRENT_RATIO: 流动比率
    - QUICK_RATIO: 速动比率
    - CURRENT_ASSET_RATIO: 流动资产率
    - CURRENT_DEBT_RATIO: 流动负债率
    - EQUITY_MULTIPLIER: 权益乘数
    - PROPERTY_RATIO: 产权比率
    - CASH_AND_CASH_EQUIVALENTS: 现金和现金等价物
    - TOTAL_ASSET_TURNOVER: 总资产周转率
    - FIXED_ASSET_TURNOVER: 固定资产周转率
    - INVENTORY_TURNOVER: 存货周转率
    - OPERATING_CASH_FLOW_TTM: 经营活动现金流 TTM
    - ACCOUNTS_RECEIVABLE: 应收账款净额
    - EBIT_GROWTH_RATE: EBIT 同比增长率
    - OPERATING_PROFIT_GROWTH_RATE: 营业利润同比增长率
    - TOTAL_ASSETS_GROWTH_RATE: 总资产同比增长率
    - PROFIT_TO_SHAREHOLDERS_GROWTH_RATE: 归母净利润同比增长率
    - PROFIT_BEFORE_TAX_GROWTH_RATE: 总利润同比增长率
    - EPS_GROWTH_RATE: EPS 同比增长率
    - ROE_GROWTH_RATE: ROE 同比增长率
    - ROIC_GROWTH_RATE: ROIC 同比增长率
    - NOCF_GROWTH_RATE: 经营现金流同比增长率
    - NOCF_PER_SHARE_GROWTH_RATE: 每股经营现金流同比增长率
    - OPERATING_REVENUE_CASH_COVER: 经营现金收入比
    - OPERATING_PROFIT_TO_TOTAL_PROFIT: 营业利润占比
    - BASIC_EPS: 基本每股收益
    - DILUTED_EPS: 稀释每股收益
    - NOCF_PER_SHARE: 每股经营现金净流量
  enum:
    - NONE
    - NET_PROFIT
    - NET_PROFIT_GROWTH
    - SUM_OF_BUSINESS
    - SUM_OF_BUSINESS_GROWTH
    - NET_PROFIT_RATE
    - GROSS_PROFIT_RATE
    - DEBT_ASSET_RATE
    - RETURN_ON_EQUITY_RATE
    - ROIC
    - ROA_TTM
    - EBIT_TTM
    - EBITDA
    - OPERATING_MARGIN_TTM
    - EBIT_MARGIN
    - EBITDA_MARGIN
    - FINANCIAL_COST_RATE
    - OPERATING_PROFIT_TTM
    - SHAREHOLDER_NET_PROFIT_TTM
    - NET_PROFIT_CASH_COVER_TTM
    - CURRENT_RATIO
    - QUICK_RATIO
    - CURRENT_ASSET_RATIO
    - CURRENT_DEBT_RATIO
    - EQUITY_MULTIPLIER
    - PROPERTY_RATIO
    - CASH_AND_CASH_EQUIVALENTS
    - TOTAL_ASSET_TURNOVER
    - FIXED_ASSET_TURNOVER
    - INVENTORY_TURNOVER
    - OPERATING_CASH_FLOW_TTM
    - ACCOUNTS_RECEIVABLE
    - EBIT_GROWTH_RATE
    - OPERATING_PROFIT_GROWTH_RATE
    - TOTAL_ASSETS_GROWTH_RATE
    - PROFIT_TO_SHAREHOLDERS_GROWTH_RATE
    - PROFIT_BEFORE_TAX_GROWTH_RATE
    - EPS_GROWTH_RATE
    - ROE_GROWTH_RATE
    - ROIC_GROWTH_RATE
    - NOCF_GROWTH_RATE
    - NOCF_PER_SHARE_GROWTH_RATE
    - OPERATING_REVENUE_CASH_COVER
    - OPERATING_PROFIT_TO_TOTAL_PROFIT
    - BASIC_EPS
    - DILUTED_EPS
    - NOCF_PER_SHARE

PatternStockField:
  type: string
  description: |
    形态技术指标属性
    - NONE: 未知
    - MA_ALIGNMENT_LONG: MA多头排列（连续两天MA5>MA10>MA20>MA30>MA60，且当日收盘价大于前一天收盘价）
    - MA_ALIGNMENT_SHORT: MA空头排列（连续两天MA5<MA10<MA20<MA30<MA60，且当日收盘价小于前一天收盘价）
    - EMA_ALIGNMENT_LONG: EMA多头排列（连续两天EMA5>EMA10>EMA20>EMA30>EMA60，且当日收盘价大于前一天收盘价）
    - EMA_ALIGNMENT_SHORT: EMA空头排列（连续两天EMA5<EMA10<EMA20<EMA30<EMA60，且当日收盘价小于前一天收盘价）
    - RSI_GOLD_CROSS_LOW: RSI低位金叉（50以下，短线RSI上穿长线RSI）
    - RSI_DEATH_CROSS_HIGH: RSI高位死叉（50以上，短线RSI下穿长线RSI）
    - RSI_TOP_DIVERGENCE: RSI顶背离
    - RSI_BOTTOM_DIVERGENCE: RSI底背离
    - KDJ_GOLD_CROSS_LOW: KDJ低位金叉
    - KDJ_DEATH_CROSS_HIGH: KDJ高位死叉
    - KDJ_TOP_DIVERGENCE: KDJ顶背离
    - KDJ_BOTTOM_DIVERGENCE: KDJ底背离
    - MACD_GOLD_CROSS_LOW: MACD低位金叉
    - MACD_DEATH_CROSS_HIGH: MACD高位死叉
    - MACD_TOP_DIVERGENCE: MACD顶背离
    - MACD_BOTTOM_DIVERGENCE: MACD底背离
    - BOLL_BREAK_UPPER: BOLL突破上轨
    - BOLL_BREAK_LOWER: BOLL突破下轨
    - BOLL_CROSS_MIDDLE_UP: BOLL向上破中轨
    - BOLL_CROSS_MIDDLE_DOWN: BOLL向下破中轨
  enum:
    - NONE
    - MA_ALIGNMENT_LONG
    - MA_ALIGNMENT_SHORT
    - EMA_ALIGNMENT_LONG
    - EMA_ALIGNMENT_SHORT
    - RSI_GOLD_CROSS_LOW
    - RSI_DEATH_CROSS_HIGH
    - RSI_TOP_DIVERGENCE
    - RSI_BOTTOM_DIVERGENCE
    - KDJ_GOLD_CROSS_LOW
    - KDJ_DEATH_CROSS_HIGH
    - KDJ_TOP_DIVERGENCE
    - KDJ_BOTTOM_DIVERGENCE
    - MACD_GOLD_CROSS_LOW
    - MACD_DEATH_CROSS_HIGH
    - MACD_TOP_DIVERGENCE
    - MACD_BOTTOM_DIVERGENCE
    - BOLL_BREAK_UPPER
    - BOLL_BREAK_LOWER
    - BOLL_CROSS_MIDDLE_UP
    - BOLL_CROSS_MIDDLE_DOWN

CustomStockField:
  type: string
  description: |
    自定义技术指标属性（stock_field1）
    - NONE: 未知
    - PRICE: 最新价格
    - MA: 简单均线
    - MA5: 5日简单均线（不建议使用）
    - MA10: 10日简单均线（不建议使用）
    - MA20: 20日简单均线（不建议使用）
    - MA30: 30日简单均线（不建议使用）
    - MA60: 60日简单均线（不建议使用）
    - MA120: 120日简单均线（不建议使用）
    - MA250: 250日简单均线（不建议使用）
    - RSI: RSI（默认参数为[12]）
    - EMA: 指数移动均线
    - EMA5: 5日指数移动均线（不建议使用）
    - EMA10: 10日指数移动均线（不建议使用）
    - EMA20: 20日指数移动均线（不建议使用）
    - EMA30: 30日指数移动均线（不建议使用）
    - EMA60: 60日指数移动均线（不建议使用）
    - EMA120: 120日指数移动均线（不建议使用）
    - EMA250: 250日指数移动均线（不建议使用）
    - KDJ_K: KDJ 指标的 K 值（默认参数[9,3,3]）
    - KDJ_D: KDJ 指标的 D 值（默认参数[9,3,3]）
    - KDJ_J: KDJ 指标的 J 值（默认参数[9,3,3]）
    - MACD_DIFF: MACD DIFF 值（默认参数[12,26,9]）
    - MACD_DEA: MACD DEA 值（默认参数[12,26,9]）
    - MACD: MACD 值（默认参数[12,26,9]）
    - BOLL_UPPER: BOLL UPPER 值（默认参数[20,2]）
    - BOLL_MIDDLER: BOLL MIDDLER 值（默认参数[20,2]）
    - BOLL_LOWER: BOLL LOWER 值（默认参数[20,2]）
  enum:
    - NONE
    - PRICE
    - MA
    - MA5
    - MA10
    - MA20
    - MA30
    - MA60
    - MA120
    - MA250
    - RSI
    - EMA
    - EMA5
    - EMA10
    - EMA20
    - EMA30
    - EMA60
    - EMA120
    - EMA250
    - KDJ_K
    - KDJ_D
    - KDJ_J
    - MACD_DIFF
    - MACD_DEA
    - MACD
    - BOLL_UPPER
    - BOLL_MIDDLER
    - BOLL_LOWER

PeriodMark:
  type: integer
  format: int32
  description: |
    报告期类型编码（周期），对应 infos-api `PeriodMarkEnum`。
    - 13140001: 1个月 (T13140001)
    - 13140002: 2个月 (T13140002)
    - 13140003: 3个月 (T13140003)
    - 13140004: 4个月 (T13140004)
    - 13140005: 5个月 (T13140005)
    - 13140006: 6个月 (T13140006)；Java 中 T13140007 也使用该 code，解析 `of(code)` 时与 6 个月相同
    - 13140008: 8个月 (T13140008)
    - 13140009: 9个月 (T13140009)
    - 13140010: 10个月 (T13140010)
    - 13140011: 11个月 (T13140011)
    - 13140012: 年度 (T13140012)
    - 13140013: 13个月 (T13140013)
    - 13140014: 14个月 (T13140014)
    - 13140015: 15个月 (T13140015)
    - 13140016: 16个月 (T13140016)
    - 13140017: 17个月 (T13140017)
    - 13140018: 18个月 (T13140018)
    - 13140090: 季度 (T13140090)
    - 13140099: 其他 (T13140099)
  enum:
    - 13140001
    - 13140002
    - 13140003
    - 13140004
    - 13140005
    - 13140006
    - 13140008
    - 13140009
    - 13140010
    - 13140011
    - 13140012
    - 13140013
    - 13140014
    - 13140015
    - 13140016
    - 13140017
    - 13140018
    - 13140090
    - 13140099
  x-enum-varnames:
    - T13140001
    - T13140002
    - T13140003
    - T13140004
    - T13140005
    - T13140006
    - T13140008
    - T13140009
    - T13140010
    - T13140011
    - T13140012
    - T13140013
    - T13140014
    - T13140015
    - T13140016
    - T13140017
    - T13140018
    - T13140090
    - T13140099

InfoSourceEnum:
  type: integer
  format: int32
  description: |
    信息来源编码，对应 infos-api `InfoSourceEnum`（info_source_code）。
    - 19260002: 第一季报 (T19260002)
    - 19260003: 中期报告 (T19260003)
    - 19260004: 第三季报 (T19260004)
    - 19260005: 年度报告 (T19260005)
    - 19260006: 第二季报 (T19260006)
    - 19260007: 第四季报 (T19260007)
    - 19260008: 第五季报 (T19260008)
    - 19260009: 定期报告 (T19260009)
    - 19260010: 申请版本 (T19260010)
    - 19260011: 聆讯后资料集 (T19260011)
    - 19260012: 招股章程 (T19260012)
    - 19260013: 临时公告 (T19260013)
    - 19260027: 配发结果 (T19260027)
    - 19260028: 修改已刊发的财务报表及报告 (T19260028)
    - 19260029: 修正重大错误而做出的前期调整 (T19260029)
    - 19260030: 修订已刊发初步业绩的资料 (T19260030)
    - 19260032: 内幕消息-年度报告 (T19260032)
    - 19260033: 内幕消息-第一季报 (T19260033)
    - 19260034: 内幕消息-第二季报 (T19260034)
    - 19260035: 内幕消息-第三季报 (T19260035)
    - 19260036: 内幕消息-第四季报 (T19260036)
    - 19260037: 内幕消息-中期报告 (T19260037)
    - 19260038: 内幕消息-申请版本 (T19260038)
    - 19260039: 内幕消息-招股章程 (T19260039)
    - 19260040: 内幕消息-聆讯后资料集 (T19260040)
    - 19260041: 内幕消息-其他 (T19260041)
  enum:
    - 19260002
    - 19260003
    - 19260004
    - 19260005
    - 19260006
    - 19260007
    - 19260008
    - 19260009
    - 19260010
    - 19260011
    - 19260012
    - 19260013
    - 19260027
    - 19260028
    - 19260029
    - 19260030
    - 19260032
    - 19260033
    - 19260034
    - 19260035
    - 19260036
    - 19260037
    - 19260038
    - 19260039
    - 19260040
    - 19260041
  x-enum-varnames:
    - T19260002
    - T19260003
    - T19260004
    - T19260005
    - T19260006
    - T19260007
    - T19260008
    - T19260009
    - T19260010
    - T19260011
    - T19260012
    - T19260013
    - T19260027
    - T19260028
    - T19260029
    - T19260030
    - T19260032
    - T19260033
    - T19260034
    - T19260035
    - T19260036
    - T19260037
    - T19260038
    - T19260039
    - T19260040
    - T19260041

DateTypeConvertUtil:
  type: integer
  format: int32
  description: |
    - 1 第一季报
    - 2 中期报告
    - 3 第三季报
    - 4 年报
    - 5 第二季报
    - 7 第四季报
  enum:
    - 1
    - 2
    - 3
    - 4
    - 5
    - 7
  x-enum-varnames:
    - DT1
    - DT2
    - DT3
    - DT4
    - DT5
    - DT7

ShareholderRedHoldEnum:
  type: integer
  format: int32
  description: |
    股东增减持排序/展示字段（ShareholderRedHoldEnum）
    - 1001 事件日期
    - 1002 变动股数
    - 1003 变动金额
    - 1004 近N个月涨跌幅
  enum:
    - 1001
    - 1002
    - 1003
    - 1004
  x-enum-varnames:
    - EVENT_DATE
    - ADJ_SHARES_TRADED
    - CHANGE_AMOUNT
    - RAISE_PERCENT

path: references/error-catalog.md
content: # Error Catalog

## 1. ConfigError
### Typical User-facing Message
- `NOAH_MARKET_APIKEY is missing`
- `NOAH_API_BASE_URL` 未配置

### Typical Cause
- 本地环境变量未配置
- `.secrets/noah-market.env` 未加载
- 变量名拼写错误

### Suggested Recovery Action
- 检查并配置：
  - `NOAH_API_BASE_URL`
  - `NOAH_MARKET_APIKEY`
- 确认配置文件位置与变量名正确

---

## 2. WrongCredentialType
### Typical User-facing Message
- 配置了 key，但仍无法鉴权
- 实际填入的是 GitHub token 等非行情 API key

### Typical Cause
- 把 `ghp_...` GitHub token 当成行情 API key
- 把 OpenClaw token 或其他平台凭证误用为行情接口鉴权

### Suggested Recovery Action
- 必须使用公司证券行情服务 API key
- 不要使用 GitHub token、OpenClaw token 或其他平台凭证

---

## 3. AuthError
### Typical User-facing Message
- `鉴权失败或权限不足，请检查本地 API key 配置。`

### Typical Cause
- API key 失效
- API key 权限不足
- key 与当前环境不匹配

### Suggested Recovery Action
- 更新本地 API key
- 确认 key 对当前环境有权限
- 不要在聊天或截图中回显 key

---

## 4. NotFound404
### Typical User-facing Message
- `当前环境下，该标的或该查询参数暂不可用（接口返回 404）。`

### Typical Cause
- 当前环境不支持该市场 / 标的 / 周期组合
- 路由正确，但后端当前环境未返回数据
- 期权或部分美股 K 线能力当前环境不可用

### Suggested Recovery Action
- 先确认是否属于已知环境限制
- 可尝试改查快照、分时、日 K 或港股主路径
- 结合 `current-availability.md` 与 `edge-cases.md` 查看

---

## 5. UnsupportedInCurrentEnv
### Typical User-facing Message
- `这个能力接口已定义，但当前环境暂不支持。`

### Typical Cause
- 接口在文档中存在，但当前环境未开放
- 例如：板块接口、部分期权接口

### Suggested Recovery Action
- 视为当前环境限制
- 不将其作为当前一期主承诺能力

---

## 6. ClarificationRequired
### Typical User-facing Message
- `“百度”同时存在港股和美股，请先确认你要查哪个市场。`

### Typical Cause
- 中文名称同时对应港股与美股
- 用户未明确市场

### Suggested Recovery Action
- 请用户直接回复“港股”或“美股”
- 或直接输入标准代码

---

## 7. NameResolutionMiss
### Typical User-facing Message
- 中文名称能理解查询意图，但无法正确落到具体标的

### Typical Cause
- 该中文名称尚未加入本地映射表
- 当前系统仍以本地 hints 为主，未接正式搜索接口

### Suggested Recovery Action
- 优先使用标准代码：如 `HK-00700`、`US-AAPL`
- 或补充明确市场与完整名称

---

## 8. NoUsableData
### Typical User-facing Message
- `查询成功，但当前没有可展示的数据。`

### Typical Cause
- 接口请求成功，但数据为空
- 后端返回结构可用，但当前无有效结果

### Suggested Recovery Action
- 更换周期 / 市场 / 标的再试
- 改查快照、分时、基础信息等更稳能力

---

## 9. ZeroTailTrimmed
### Typical User-facing Message
- `说明：已自动忽略尾部 0 值占位记录。`

### Typical Cause
- 资金流向原始返回末尾带有全 0 占位记录

### Suggested Recovery Action
- 无需额外处理
- 系统已自动按有效记录展示

---

## 10. DetailTruncated
### Typical User-facing Message
- `说明：仅展示最近 10 条记录。`

### Typical Cause
- detail mode 返回记录过多
- 为避免用户阅读负担，系统自动截断

### Suggested Recovery Action
- 当前属于预期产品行为
- 如后续需要更长输出，可扩展为显式范围控制

---

## 11. PathNotFound
### Typical User-facing Message
- `python3: can't open file ... run_query.py: [Errno 2] No such file or directory`

### Typical Cause
- 执行脚本时使用了错误路径
- 安装后 skill 实际目录与预期不同

### Suggested Recovery Action
- 先确认 skill 实际安装目录
- 再进入对应模块目录执行脚本

---

## 12. Reading This Catalog Together with Other References
建议与以下文档配合查看：
- `references/install-troubleshooting.md`
- `references/current-availability.md`
- `references/edge-cases.md`
- `references/output-policy.md`


path: references/kline-and-intraday.md
content: # Kline and Intraday

核心接口：
- `/quotes/get_rt_data` → 分时
- `/quotes/get_cur_kline` → K 线

## Intraday

当用户询问：
- 实时分时
- 盘中走势
- 今天走势如何

优先使用 `/quotes/get_rt_data`。

默认摘要：
- 当前价
- 均价
- 昨收
- 成交量 / 成交额
- 当前时间点
- 简短走势观察

## Kline

当用户询问：
- 日K / 周K / 月K
- 最近 N 天走势
- 5 分钟 K / 15 分钟 K / 60 分钟 K

使用 `/quotes/get_cur_kline`。

关键参数：
- `code`：优先传标准代码
- `num`：返回 K 线个数
- `ktype`：K 线周期
- `autype`：复权方式

## KType Mapping

自然语言到 `KLType` 的常见映射：
- 1分钟K → `K_1_M`
- 5分钟K → `K_5_M`
- 15分钟K → `K_15_M`
- 30分钟K → `K_30_M`
- 60分钟K → `K_60_M`
- 日K → `K_DAY`
- 周K → `K_WEEK`
- 月K → `K_MON`

## AuType Guidance

- 不特别说明时，可优先用 `NONE`
- 用户明确要求前复权 → `QFQ`
- 用户明确要求后复权 → `HFQ`

## Output Guidance

默认不要逐根回吐全部 K 线；先做摘要：
- 最近区间涨跌
- 区间高低点
- 最近成交活跃度
- 若用户明确要明细，再展开最近 N 根


path: references/known-limitations.md
content: # Known Limitations

基于当前真实 smoke test，以下情况已确认：

## 已验证可用
- `/quotes/get_market_snapshot`
- `/infos/get_market_state`
- `/quote/get_global_state`
- `/quotes/get_rt_data`
- `/quotes/get_rt_ticker`
- `/quotes/get_broker_queue`
- `/quotes/get_cur_kline`
- `/quotes/get_cur_kline_date`
- `/infos/get_capital_flow`
- `/quote/get_stock_basicinfo`
- `/quote/request_trading_days`
- `/infos/get_us_analysis`
- `/quote/get_ipo_list`
- `/rank/get_stock_rank`

## 当前环境暂不支持或未验证通过
- `/infos/shareholder_inc_red_hold_by_date`
  - 当前主脚本尚未接入按时间范围查询入口；按市场与按股票两条主路径已验证可用

- 美股 K 线（如 `US-AAPL`, `US-NVDA`）
  - 自然语言路由已能正确识别为 `kline`
  - 但当前接口调用返回 HTTP 404
  - 初步判断：问题更可能在后端环境、代码格式或市场支持范围，而不是前端路由逻辑

## Implementation Guidance

- 对未验证通过的能力，不要在主路径里强承诺。
- 如果用户问到这些能力，可以尝试调用；若失败，直接说明当前环境暂不支持，而不是误导成“没有数据”。
- 对 404 场景，优先解释为“当前环境下该标的或该参数暂不可用”，不要直接把原始 message 当成用户提示。
- 后续如环境开放或拿到正确入参规范，再升级这些能力为正式支持。


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)