futu_cache/
qot_market.rs

1//! v1.4.106 codex 1148 F2 (P2): 公共 `Qot_Common.QotMarket` → symbol suffix
2//! 转换。
3//!
4//! 此前 `crates/futu-gateway-qot/src/handlers/qot/option.rs::qot_market_to_symbol_suffix`
5//! 与 `crates/futu-gateway-core/src/bridge/mkt_id_refresh.rs` 各有一份 inline 表，
6//! 后者跑漂移 (`51 → HK_Future`、`62 → MY`、`72 → CA`、漏 `81 → FX`)。
7//! 收敛为单一 source of truth，对齐 proto 枚举:
8//!
9//! 来源: `proto/Qot_Common.proto:8-21`
10//!   ```text
11//!   QotMarket_Unknown        = 0;
12//!   QotMarket_HK_Security    = 1;   // 香港市场
13//!   QotMarket_HK_Future      = 2;   // 港期货 (已废弃, 使用 HK_Security)
14//!   QotMarket_US_Security    = 11;  // 美国市场
15//!   QotMarket_CNSH_Security  = 21;  // 沪股市场
16//!   QotMarket_CNSZ_Security  = 22;  // 深股市场
17//!   QotMarket_SG_Security    = 31;  // 新加坡市场
18//!   QotMarket_JP_Security    = 41;  // 日本市场
19//!   QotMarket_AU_Security    = 51;  // 澳大利亚市场
20//!   QotMarket_MY_Security    = 61;  // 马来西亚市场
21//!   QotMarket_CA_Security    = 71;  // 加拿大市场
22//!   QotMarket_FX_Security    = 81;  // 外汇市场
23//!   ```
24//!
25//! 后端 CMD 20106 `SecuritiesReq.symbols` 用 `"CODE.SUFFIX"` 格式 (e.g.
26//! `"AAPL.US"` / `"00700.HK"`)。本 helper 把 FTAPI QotMarket 值转为对应的
27//! 后端 symbol 后缀。
28//!
29//! 注意: 后端真正的"symbol_suffix"是从 `quote_config_svr.proto:82` 下发的
30//! 配置而不是硬编码 (C++ 不在源码内 hardcode 这个表)。daemon 直连 backend
31//! 时不查 quote_config，因此这里维护一份硬编码版作 cache-first 路由。下次
32//! backend 增加新市场时此处需同步更新。
33
34/// FTAPI `Qot_Common.QotMarket` (proto enum 值) → backend symbol suffix
35/// (`"CODE.{SUFFIX}"` 用于 CMD 20106 `SecuritiesReq.symbols`).
36///
37/// 返 `None` 表示 daemon 当前不支持的 market — caller 应**显式** skip /
38/// reject 而非 fallthrough。
39///
40/// **支持的市场**:
41/// - `1` (HK_Security) → `"HK"`
42/// - `2` (HK_Future, 已废弃) → `"HK"` (alias HK_Security, 与 option.rs
43///   既有行为一致, 因为 backend 把 HK_Future symbol 当 HK 处理)
44/// - `11` (US_Security) → `"US"`
45/// - `21` (CNSH_Security) → `"SH"`
46/// - `22` (CNSZ_Security) → `"SZ"`
47/// - `31` (SG_Security) → `"SG"`
48/// - `41` (JP_Security) → `"JP"`
49/// - `51` (AU_Security) → `"AU"`
50/// - `61` (MY_Security) → `"MY"`
51/// - `71` (CA_Security) → `"CA"`
52/// - `81` (FX_Security) → `"FX"`
53///
54/// **不支持的市场返 None**: 0 (Unknown) / 任何其他值。
55#[must_use]
56pub fn qot_market_to_symbol_suffix(market: i32) -> Option<&'static str> {
57    match market {
58        1 | 2 => Some("HK"), // HK_Security / HK_Future (deprecated alias)
59        11 => Some("US"),    // US_Security
60        21 => Some("SH"),    // CNSH_Security
61        22 => Some("SZ"),    // CNSZ_Security
62        31 => Some("SG"),    // SG_Security
63        41 => Some("JP"),    // JP_Security
64        51 => Some("AU"),    // AU_Security
65        61 => Some("MY"),    // MY_Security
66        71 => Some("CA"),    // CA_Security
67        81 => Some("FX"),    // FX_Security
68        _ => None,           // Unknown / 未支持
69    }
70}
71
72#[cfg(test)]
73mod tests;
futu_cache/qot_market.rs

futu_cache/
qot_market.rs
