futu_trd/
lib.rs

1//! FutuOpenD 交易业务模块
2//!
3//! 实装 "交易侧" 所有业务：账户列表 / 解锁 / 下单 / 改单 / 撤单 / 资金 / 持仓
4//! / 订单查询 / 历史订单 / 流水 / 费率 / 最大可交易量 / 推送订阅，对齐 C++
5//! OpenD 的 `NN_ProtoCmd_Trd_*` 全集。
6//!
7//! 主要模块：
8//! - [`account`] — 账户列表 / 解锁 / 资金 / 持仓（[`account::unlock_trade`]）
9//! - [`order`] — 下单 / 改单 / 撤单（[`order::place_order`]）
10//! - [`query`] — 今日订单 / 今日成交
11//! - [`misc`] — 历史订单 / 历史成交 / 费率 / 最大可交易量 / 反确认
12//! - [`push`] — 交易推送分发（[`push::TradePushDispatcher`]）
13//! - [`types`] — 核心类型（[`types::TrdHeader`] / [`types::TrdMarket`] / [`types::TrdSide`] / ...）
14
15pub mod account;
16pub mod currency;
17pub mod market;
18pub mod misc;
19pub mod order;
20pub mod parsing;
21pub mod projection;
22pub mod push;
23pub mod query;
24pub mod read_plan;
25pub mod types;
26
27/// 把服务端 `ret_type / ret_msg / err_code` 三元组汇成一个可读 `FutuError::ServerError`。
28///
29/// v1.4.27 BUG-2 修复首版：仅在 `err_code != 0` 时加前缀。
30///
31/// v1.4.30 BUG-2b 修复（external reviewer v1.4.29 回归测试发现）：sim 下单服务端经常
32/// 返回 `err_code=None`，首版逻辑会吞掉这个信号——用户看到
33/// "PlaceOrder: 错误，请稍后重试或联系客服"完全不知道是我们代码吞了还是
34/// 服务端就返这个。改成**永远**把 err_code 原始值（含 `none` / `0`）体现
35/// 在 msg 前缀里，让用户看到完整的 `[err_code=none]` / `[err_code=10001]`，
36/// 和 `ret_type` 一起构成完整的服务端诊断三元组。
37#[inline]
38pub(crate) fn server_err(
39    ret_type: i32,
40    ret_msg: Option<String>,
41    err_code: Option<i32>,
42) -> futu_core::error::FutuError {
43    let raw = ret_msg.unwrap_or_default();
44    let err_code_label = match err_code {
45        Some(code) => code.to_string(),
46        None => "none".to_string(),
47    };
48    let msg = if raw.is_empty() {
49        format!("[err_code={err_code_label}]")
50    } else {
51        format!("[err_code={err_code_label}] {raw}")
52    };
53    futu_core::error::FutuError::ServerError { ret_type, msg }
54}
55
56// Re-export 常用类型
57pub use account::{
58    PositionListOptions, TrdAcc, get_acc_list, get_funds, get_position_list,
59    get_position_list_with_filter_market, get_position_list_with_options, unlock_trade,
60};
61pub use misc::{
62    HistoryFilterConditions, MaxTrdQtysParams, get_history_order_fill_list, get_history_order_list,
63    get_max_trd_qtys, reconfirm_order, sub_acc_push, unsub_acc_push,
64};
65pub use order::{cancel_order, modify_order, place_order, place_order_with_options};
66pub use push::{TradeHandler, TradePushDispatcher, TrdNotifyInfo};
67pub use query::{Order, OrderFill, get_order_fill_list, get_order_list};
68pub use types::{
69    Funds, ModifyOrderOp, ModifyOrderParams, OrderType, PlaceOrderOptions, PlaceOrderParams,
70    PlaceOrderResult, Position, TrdEnv, TrdHeader, TrdMarket, TrdSide,
71};
72
73#[cfg(test)]
74mod server_err_tests;
futu_trd/lib.rs

futu_trd/
lib.rs
