Enum Command

Source

pub enum Command {
Show 173 variants    Ping,
    Commands(CommandsArgs),
    Version(VersionArgs),
    LangPack(LanguagePackArgs),
    Quote(QuoteArgs),
    Snapshot(SnapshotArgs),
    Sub(SubArgs),
    Kline(KlineArgs),
    PushSubscriberInfo(PushSubscriberInfoArgs),
    Orderbook(OrderbookArgs),
    Ticker(TickerArgs),
    Rt(RtArgs),
    Static(StaticArgs),
    StaticStatus(StaticStatusArgs),
    StaticWarmup(StaticWarmupArgs),
    Broker(BrokerArgs),
    PlateList(PlateListArgs),
    PlateStocks(PlateStocksArgs),
    Reference(ReferenceArgs),
    Account(AccountArgs),
    Funds(FundsArgs),
    Position(PositionArgs),
    Order(OrderArgs),
    Deal(DealArgs),
    UnlockTrade(UnlockTradeArgs),
    SetTradePwd(SetTradePwdArgs),
    ClearTradePwd(ClearTradePwdArgs),
    SetLoginPwd(SetLoginPwdArgs),
    ClearLoginPwd(ClearLoginPwdArgs),
    Repl,
    GenKey(GenKeyArgs),
    BindKey(BindKeyArgs),
    MachineId(MachineIdArgs),
    ListKeys(ListKeysArgs),
    RevokeKey(RevokeKeyArgs),
    PlaceOrder(PlaceOrderArgs),
    ModifyOrder(ModifyOrderArgs),
    CancelOrder(CancelOrderArgs),
    ReconfirmOrder(ReconfirmOrderArgs),
    HistoryOrders(HistoryOrdersArgs),
    HistoryDeals(HistoryDealsArgs),
    MaxQtys(MaxQtysArgs),
    TradeCheck(TradeCheckArgs),
    ComboMaxTrdQtys(ComboMaxTrdQtysArgs),
    ComboOrder(ComboOrderArgs),
    MarginRatio(MarginRatioArgs),
    OrderFee(OrderFeeArgs),
    CapitalFlow(CapitalFlowArgs),
    CapitalDistribution {
        symbol: String,
    },
    CompanyProfile(CompanyProfileArgs),
    CompanyExecutives(CompanyExecutivesArgs),
    CompanyExecutiveBackground(CompanyExecutiveBackgroundArgs),
    CompanyOperationalEfficiency(CompanyOperationalEfficiencyArgs),
    FinancialsEarningsPriceMove(FinancialsEarningsPriceMoveArgs),
    FinancialsEarningsPriceHistory(FinancialsEarningsPriceHistoryArgs),
    FinancialCalendar(FinancialCalendarArgs),
    FinancialCalendarTarget(FinancialCalendarTargetArgs),
    FinancialsStatements(FinancialsStatementsArgs),
    FinancialsRevenueBreakdown(FinancialsRevenueBreakdownArgs),
    ResearchAnalystConsensus(ResearchAnalystConsensusArgs),
    ResearchRatingSummary(ResearchRatingSummaryArgs),
    ResearchMorningstarReport(ResearchMorningstarReportArgs),
    ValuationDetail(ValuationDetailArgs),
    ValuationPlateStockList(ValuationPlateStockListArgs),
    StockScreen(StockScreenArgs),
    OptionScreen(OptionScreenArgs),
    WarrantScreen(WarrantScreenArgs),
    TechnicalUnusual(TechnicalUnusualArgs),
    FinancialUnusual(FinancialUnusualArgs),
    DerivativeUnusual(DerivativeUnusualArgs),
    CorporateActionsBuybacks(CorporateActionsBuybacksArgs),
    CorporateActionsDividends(CorporateActionsDividendsArgs),
    CorporateActionsStockSplits(CorporateActionsStockSplitsArgs),
    DailyShortVolume(DailyShortVolumeArgs),
    ShortInterest(ShortInterestArgs),
    TopTenBuySellBrokers(TopTenBuySellBrokersArgs),
    ShareholdersOverview(ShareholdersOverviewArgs),
    ShareholdersHoldingChanges(ShareholdersHoldingChangesArgs),
    ShareholdersHolderDetail(ShareholdersHolderDetailArgs),
    ShareholdersInstitutional(ShareholdersInstitutionalArgs),
    InsiderHolderList(InsiderHolderListArgs),
    InsiderTradeList(InsiderTradeListArgs),
    OptionVolatility(OptionVolatilityArgs),
    OptionExerciseProbability(OptionExerciseProbabilityArgs),
    OptionQuote(ProtoJsonArgs),
    OptionStrategy(ProtoJsonArgs),
    OptionStrategyAnalysis(ProtoJsonArgs),
    OptionStrategySpread(ProtoJsonArgs),
    EarningsCalendar(ProtoJsonArgs),
    MacroIndicatorList(ProtoJsonArgs),
    MacroIndicatorHistory(ProtoJsonArgs),
    FedWatchTargetRate(ProtoJsonArgs),
    FedWatchDotPlot(ProtoJsonArgs),
    EarningsBeatRank(ProtoJsonArgs),
    DividendRank(ProtoJsonArgs),
    DividendCalendar(ProtoJsonArgs),
    EconomicCalendar(ProtoJsonArgs),
    UsPreMarketRank(ProtoJsonArgs),
    UsAfterHoursRank(ProtoJsonArgs),
    UsOvernightRank(ProtoJsonArgs),
    TopMoversRank(ProtoJsonArgs),
    HotList(ProtoJsonArgs),
    ShortSellingRank(ProtoJsonArgs),
    PeriodChangeRank(ProtoJsonArgs),
    HighDividendSoeRank(ProtoJsonArgs),
    InstitutionList(ProtoJsonArgs),
    InstitutionProfile(ProtoJsonArgs),
    InstitutionDistribution(ProtoJsonArgs),
    InstitutionHoldingChange(ProtoJsonArgs),
    InstitutionHoldingList(ProtoJsonArgs),
    ArkFundHolding(ProtoJsonArgs),
    ArkStockDynamic(ProtoJsonArgs),
    ArkActiveTransaction(ProtoJsonArgs),
    RatingChange(ProtoJsonArgs),
    IndustrialChainList(ProtoJsonArgs),
    IndustrialChainDetail(ProtoJsonArgs),
    IndustrialChainByPlate(ProtoJsonArgs),
    IndustrialPlateInfo(ProtoJsonArgs),
    IndustrialPlateStock(ProtoJsonArgs),
    HeatMapData(ProtoJsonArgs),
    RiseFallDistribution(ProtoJsonArgs),
    MarketState {
        symbols: String,
    },
    OwnerPlate {
        symbols: String,
    },
    OptionChain {Show 17 fields
        owner: Option<String>,
        owner_arg: Option<String>,
        begin: String,
        end: String,
        option_type: String,
        delta_min: Option<f64>,
        delta_max: Option<f64>,
        iv_min: Option<f64>,
        iv_max: Option<f64>,
        oi_min: Option<f64>,
        oi_max: Option<f64>,
        gamma_min: Option<f64>,
        gamma_max: Option<f64>,
        vega_min: Option<f64>,
        vega_max: Option<f64>,
        theta_min: Option<f64>,
        theta_max: Option<f64>,
    },
    TradingDays {
        market: String,
        begin: String,
        end: String,
    },
    Rehab {
        symbol: String,
    },
    Suspend {
        symbols: Option<String>,
        symbols_arg: Option<String>,
        begin: String,
        end: String,
    },
    UserSecurity {
        group: Option<String>,
        group_arg: Option<String>,
    },
    UserSecurityGroups {
        group_type: i32,
    },
    Warrant {
        owner: Option<String>,
        begin: i32,
        num: i32,
    },
    IpoList {
        market: String,
    },
    IpoCalendar(IpoCalendarArgs),
    FutureInfo {
        symbols: String,
    },
    StockFilter {
        market: String,
        begin: i32,
        num: i32,
    },
    CancelAllOrder {
        acc_id: Option<u64>,
        card_num: Option<String>,
        env: String,
        market: Option<String>,
        jp_acc_type: Option<i32>,
        confirm: bool,
    },
    GlobalState,
    UserInfo,
    QuoteRights(QuoteRightsArgs),
    QuoteCapability(QuoteCapabilityArgs),
    DelayStatistics,
    TokenState,
    RiskFreeRate,
    SpreadTable,
    TickerStatistic(TickerStatisticArgs),
    TickerStatisticDetail(TickerStatisticDetailArgs),
    QuerySubscription(QuerySubscriptionArgs),
    UsedQuota,
    Unsubscribe(UnsubscribeArgs),
    Surface(SurfaceArgs),
    HistoryKlQuota(HistoryKlQuotaArgs),
    HoldingChange {
        symbol: String,
        category: i32,
        begin: Option<String>,
        end: Option<String>,
    },
    ModifyUserSecurity {
        group: String,
        op: i32,
        symbols: String,
    },
    CodeChange {
        symbols: String,
    },
    SetPriceReminder {
        symbol: String,
        op: i32,
        key: Option<i64>,
        type: Option<i32>,
        freq: Option<i32>,
        value: Option<f64>,
        note: Option<String>,
        session: Vec<i32>,
    },
    PriceReminder {
        symbol: Option<String>,
        market: Option<String>,
    },
    OptionExpirationDate {
        owner: Option<String>,
        owner_arg: Option<String>,
        index_type: Option<i32>,
    },
    SubAccPush {
        acc_ids: String,
    },
    UnsubAccPush {
        acc_ids: String,
    },
    AccCashFlow(AccCashFlowArgs),
    DaemonStatus(DaemonStatusArgs),
    Doctor(DoctorArgs),
    DaemonShutdown(DaemonShutdownArgs),
    DaemonReload(DaemonReloadArgs),
    CashLog(CashLogArgs),
    CashDetail(CashDetailArgs),
    BizGroup(BizGroupArgs),
    MarginInfo(MarginInfoArgs),
    AccountFlag(AccountFlagArgs),
    BondTotalAsset(BondTotalAssetArgs),
    BondSingleAsset(BondSingleAssetArgs),
    BondPositionList(BondPositionListArgs),
    BondAnswerState(BondAnswerStateArgs),
    BondTradeReminder(BondTradeReminderArgs),
}

Variants§

§

Ping

探活：连接网关并测一次 RTT

§

Sub(SubArgs)

订阅行情推送并持续打印（Ctrl-C 停止）

v1.4.83 §10 新增 aliases: subscribe / subscription

§

Kline(KlineArgs)

获取历史 K 线

v1.4.83 §10: --symbol / --code / --stock flag alias 替代 positional

§

PushSubscriberInfo(PushSubscriberInfoArgs)

REST push 订阅者诊断快照

§

Orderbook(OrderbookArgs)

获取摆盘

v1.4.83 §10: --symbol / --code / --stock flag alias 替代 positional

§

Ticker(TickerArgs)

获取逐笔成交

v1.4.83 §10: --symbol / --code / --stock flag alias

§

Rt(RtArgs)

获取分时数据

v1.4.83 §10: --symbol / --code / --stock flag alias

§

StaticStatus(StaticStatusArgs)

查看 daemon 静态数据缓存 / stock-list 同步状态

§

StaticWarmup(StaticWarmupArgs)

显式 warmup 指定证券的静态信息缓存

§

Broker(BrokerArgs)

获取经纪队列

v1.4.83 §10: --symbol / --code / --stock flag alias

§

UnlockTrade(UnlockTradeArgs)

解锁 / 锁定交易（gateway 进程级，重启失效）

密码来源优先级：–from-stdin > FUTU_TRADE_PWD 环境变量 > OS keychain > 交互式 prompt（无回显）。解锁成功后所有连同一网关的客户端（futucli / futu-mcp / Python）都可下单。

§

SetTradePwd(SetTradePwdArgs)

把交易密码存到 OS keychain（v1.4+）

存完后 futucli unlock-trade --trade-pwd-account <account> 与 futu-mcp 的 futu_unlock_trade 工具都可以按账号读取，不需要再手输明文。默认以交互式 tty prompt 读入（无回显），自动化脚本可用 --from-stdin 从 stdin 读一行。

后端：macOS Keychain / Linux DBus Secret Service / Windows Credential Manager。每个登录账号一条独立条目（username = trade-password.<account>），避免多账号互相覆盖。

§

ClearTradePwd(ClearTradePwdArgs)

清除 keychain 里某登录账号的交易密码

§

SetLoginPwd(SetLoginPwdArgs)

把登录密码写入 OS keychain（v1.4.18+）

存完后 futu-opend 启动时如果没传 --login-pwd / FUTU_PWD，会自动从 keychain 读该账号的密码。每个账号一条独立条目（username = login-password.<account>），避免多账号互相覆盖。

默认以交互式 tty prompt 读入（无回显，不进 shell history），自动化脚本可用 --from-stdin 从 stdin 读一行。

§

ClearLoginPwd(ClearLoginPwdArgs)

清除 keychain 里某账号的登录密码

§

Repl

进入交互式 REPL（共享一条长连接，历史记录，推送实时显示）

§

BindKey(BindKeyArgs)

就地编辑已有 key 的机器绑定（不重新生成明文）

用法示例：

futucli bind-key --id sim-bot --this-machine
futucli bind-key --id sim-bot --machines aabb...,ccdd...
futucli bind-key --id sim-bot --replace --this-machine
futucli bind-key --id sim-bot --clear
futucli bind-key --id sim-bot --freeze

改完记得 SIGHUP 网关：kill -HUP $(pgrep futu-opend)。

§

MachineId(MachineIdArgs)

打印本机 machine-id 或指定 key_id 的绑定指纹

无 --for-key 时打印原始 machine-id（仅用于确认是不是同一台机器）。加 --for-key <id> 时打印指纹（可复制给签发者，写进该 key 的 allowed_machines）。

§

ListKeys(ListKeysArgs)

列出 keys.json 中所有 API Key（不含明文，明文只在 gen-key 时打印一次）

默认输出短表格（含 ID / STATUS / SCOPES / MARKETS / SYMBOLS / ACCOUNTS / LIMITS / DAILY / WINDOW / BOUND / EXPIRES / NOTE）。加 --json 输出机读 JSON（字段全，含 hash / created_at / allowed_machines 等）。

§

RevokeKey(RevokeKeyArgs)

吊销一条 API Key（按 id 从 keys.json 删除；需要运行中的网关 SIGHUP 才生效）

§

PlaceOrder(PlaceOrderArgs)

下单（Python SDK OpenTradeContext.place_order）

real env 必须带 --confirm，防复制粘贴 / 回车误触。建议先在 simulate env 测通再走 real。

Market session（v1.4.111 修正 v1.4.35 表述）：协议层是否支持非交易时段下单取决于 backend 行为, daemon 透传不主动拦. 常见交易时段:

HK 主板: 周一至五 09:30-16:00 HKT（开盘前 09:00-09:30 可用 --order-type AUCTION）
HK 暗盘: 16:00-19:00 HKT (部分 blue chip / ETF, backend 接受)
US 主板: 周一至五 09:30-16:00 ET（HKT 冬令 22:30-05:00，夏令 21:30-04:00）
US 盘前/盘后: 4:00-9:30 ET / 16:00-20:00 ET (backend 接受)
CN: 周一至五 09:30-11:30 + 13:00-15:00 CST
SG: 周一至五 09:00-17:00 SGT
JP: 周一至五 09:00-11:30 + 12:30-15:00 JST
AU: 周一至五 10:00-16:00 AEST/AEDT
CA: 周一至五 09:30-16:00 EST/EDT

真实行为 (v1.4.110 真机 verify, essentials/2026-05-26-1800-v1.4.110-hk00700): HK 主板已收盘 (market status=6) 时 backend 仍可能接受订单 (暗盘 / GTC 预提交 queue), daemon 透传 + 完整 push trail. daemon 仅在 backend 显式拒时追加 [hint] 说明 (e.g. backend 110005). 不要试图换 --order-type 绕过 backend 拒绝 — 如果 backend 接受订单, daemon 返 ret_type=0 + 真实 order_id, 可通过 /api/orders 查最终 order_status (5=Submitted, 15=Cancelled_All).

§

ModifyOrder(ModifyOrderArgs)

改单 / 撤单 / 启停订单（Python SDK OpenTradeContext.modify_order）

响应语义（v1.4.111 P2-5 doc 沉淀,对齐 C++ APIServer_Trd_ModifyOrder by-design）： ret_type=0 仅表示 backend 接受了 modify 操作（operation ACK），不是最终成交 / 撤单状态证明；最终状态仍来自 UpdateOrder push 或后续查询。

正确 client pattern（ack-based）:

modify-order 返 ret_type=0 → assume backend 接受
订阅 push event 或 retry futucli order 看最终状态
单笔 cancel-order 成功时，Rust 会在返回 ACK 前做 bounded authoritative orders refresh；这不是本地 patch，也不改变 ACK 语义，只是让立即 follow-up order read 更稳定。can_sell_qty 仍以后续 push 或显式 refresh_cache=true 持仓查询为准。

§

CancelOrder(CancelOrderArgs)

撤单（modify-order 的常用快捷方式，op=CANCEL）

§

ReconfirmOrder(ReconfirmOrderArgs)

二次确认订单（Python SDK OpenTradeContext.reconfirm_order）

§

HistoryOrders(HistoryOrdersArgs)

查询历史订单（Python SDK OpenTradeContext.history_order_list_query）

§

HistoryDeals(HistoryDealsArgs)

查询历史成交（Python SDK OpenTradeContext.history_deal_list_query）

§

MaxQtys(MaxQtysArgs)

查最大可买/可卖（Python SDK OpenTradeContext.acctradinginfo_query）

§

TradeCheck(TradeCheckArgs)

只读交易预检：静态信息 warmup + max-qtys 试算，不下单

§

ComboMaxTrdQtys(ComboMaxTrdQtysArgs)

查询组合订单最大可交易数量（Futu API v10.7 get_combo_max_trd_qtys，proto-json）

§

ComboOrder(ComboOrderArgs)

组合期权下单（Futu API v10.7 place_combo_order，proto-json）

§

MarginRatio(MarginRatioArgs)

查询融资融券比率（对齐 py-futu-api get_margin_ratio；v1.4.31）

§

OrderFee(OrderFeeArgs)

查询订单费用明细（对齐 py-futu-api order_fee_query；v1.4.31）

§

CapitalFlow(CapitalFlowArgs)

资金流向时间序列

§

CapitalDistribution

资金分布快照（超大/大/中/小单流入流出）

Fields

§symbol: String

§

CompanyProfile(CompanyProfileArgs)

公司详情标签（Futu API v10.6 get_company_profile）

§

CompanyExecutives(CompanyExecutivesArgs)

公司高管信息（Futu API v10.6 get_company_executives）

§

CompanyExecutiveBackground(CompanyExecutiveBackgroundArgs)

公司高管背景（Futu API v10.6 get_company_executive_background）

§

CompanyOperationalEfficiency(CompanyOperationalEfficiencyArgs)

公司经营效率（Futu API v10.6 get_company_operational_efficiency）

§

FinancialsEarningsPriceMove(FinancialsEarningsPriceMoveArgs)

财报日前后价格表现（Futu API v10.6 get_financials_earnings_price_move）

§

FinancialsEarningsPriceHistory(FinancialsEarningsPriceHistoryArgs)

财报日前后股价历史（Futu API v10.6 get_financials_earnings_price_history）

§

FinancialCalendar(FinancialCalendarArgs)

财报日历（Rust 增强只读 endpoint，不是 C++ FTAPI parity）

§

FinancialCalendarTarget(FinancialCalendarTargetArgs)

指定股票财报日历搜索（Rust 增强只读 endpoint，不是 C++ FTAPI parity）

§

FinancialsStatements(FinancialsStatementsArgs)

财务报表（Futu API v10.6 get_financials_statements）

§

FinancialsRevenueBreakdown(FinancialsRevenueBreakdownArgs)

主营构成（Futu API v10.6 get_financials_revenue_breakdown）

§

ResearchAnalystConsensus(ResearchAnalystConsensusArgs)

分析师评级概述（Futu API v10.6 get_research_analyst_consensus）

§

ResearchRatingSummary(ResearchRatingSummaryArgs)

评级汇总/详情（Futu API v10.6 get_research_rating_summary）

§

ResearchMorningstarReport(ResearchMorningstarReportArgs)

晨星研究报告（Futu API v10.6 get_research_morningstar_report）

§

ValuationDetail(ValuationDetailArgs)

个股/指数估值详情（Futu API v10.6 get_valuation_detail）

§

ValuationPlateStockList(ValuationPlateStockListArgs)

板块/指数成分股估值列表（Futu API v10.6 get_valuation_plate_stock_list）

§

StockScreen(StockScreenArgs)

股票筛选（Futu API v10.6 stock_screen）

§

OptionScreen(OptionScreenArgs)

期权筛选（Futu API v10.6 option_screen）

§

WarrantScreen(WarrantScreenArgs)

窝轮筛选（Futu API v10.6 warrant_screen）

§

TechnicalUnusual(TechnicalUnusualArgs)

技术指标异动（Futu API v10.6 get_technical_unusual）

§

FinancialUnusual(FinancialUnusualArgs)

财务异动（Futu API v10.6 get_financial_unusual）

§

DerivativeUnusual(DerivativeUnusualArgs)

衍生品异动（Futu API v10.6 get_derivative_unusual）

§

CorporateActionsBuybacks(CorporateActionsBuybacksArgs)

回购记录（Futu API v10.6 get_corporate_actions_buybacks）

§

CorporateActionsDividends(CorporateActionsDividendsArgs)

分红派息（Futu API v10.6 get_corporate_actions_dividends）

§

CorporateActionsStockSplits(CorporateActionsStockSplitsArgs)

拆合股（Futu API v10.6 get_corporate_actions_stock_splits）

§

DailyShortVolume(DailyShortVolumeArgs)

每日卖空成交（Futu API v10.6 get_daily_short_volume）

§

ShortInterest(ShortInterestArgs)

空头持仓（Futu API v10.6 get_short_interest）

§

TopTenBuySellBrokers(TopTenBuySellBrokersArgs)

十大买卖经纪（Futu API v10.6 get_top_ten_buy_sell_brokers）

§

ShareholdersOverview(ShareholdersOverviewArgs)

持股统计（Futu API v10.6 get_shareholders_overview）

§

ShareholdersHoldingChanges(ShareholdersHoldingChangesArgs)

股东持股变动（Futu API v10.6 get_shareholders_holding_changes）

§

ShareholdersHolderDetail(ShareholdersHolderDetailArgs)

股东持股明细（Futu API v10.6 get_shareholders_holder_detail）

§

ShareholdersInstitutional(ShareholdersInstitutionalArgs)

机构持股统计（Futu API v10.6 get_shareholders_institutional）

§

InsiderHolderList(InsiderHolderListArgs)

内部人持股列表（Futu API v10.6 get_insider_holder_list）

§

InsiderTradeList(InsiderTradeListArgs)

内部人交易列表（Futu API v10.6 get_insider_trade_list）

§

OptionVolatility(OptionVolatilityArgs)

期权波动率分析（Futu API v10.6 get_option_volatility）

§

OptionExerciseProbability(OptionExerciseProbabilityArgs)

期权行权概率（Futu API v10.6 get_option_exercise_probability）

§

OptionQuote(ProtoJsonArgs)

组合/单腿期权行情（Futu API v10.7 get_option_quote，proto-json）

§

OptionStrategy(ProtoJsonArgs)

组合期权策略列表（Futu API v10.7 get_option_strategy，proto-json）

§

OptionStrategyAnalysis(ProtoJsonArgs)

组合期权策略分析（Futu API v10.7 get_option_strategy_analysis，proto-json）

§

OptionStrategySpread(ProtoJsonArgs)

组合期权有效价差（Futu API v10.7 get_option_strategy_spread，proto-json）

§

EarningsCalendar(ProtoJsonArgs)

财报日历（Public QOT 3401，proto-json）

§

MacroIndicatorList(ProtoJsonArgs)

宏观指标列表（Public QOT 3402，proto-json）

§

MacroIndicatorHistory(ProtoJsonArgs)

宏观指标历史（Public QOT 3403，proto-json）

§

FedWatchTargetRate(ProtoJsonArgs)

FedWatch 目标利率（Public QOT 3404，proto-json）

§

FedWatchDotPlot(ProtoJsonArgs)

FedWatch 点阵图（Public QOT 3405，proto-json）

§

EarningsBeatRank(ProtoJsonArgs)

盈利超预期排行（Public QOT 3406，proto-json）

§

DividendRank(ProtoJsonArgs)

分红排行（Public QOT 3407，proto-json）

§

DividendCalendar(ProtoJsonArgs)

分红日历（Public QOT 3408，proto-json）

§

EconomicCalendar(ProtoJsonArgs)

经济日历（Public QOT 3409，proto-json）

§

UsPreMarketRank(ProtoJsonArgs)

美股盘前排行（Public QOT 3410，proto-json）

§

UsAfterHoursRank(ProtoJsonArgs)

美股盘后排行（Public QOT 3411，proto-json）

§

UsOvernightRank(ProtoJsonArgs)

美股夜盘排行（Public QOT 3412，proto-json）

§

TopMoversRank(ProtoJsonArgs)

异动排行（Public QOT 3413，proto-json）

§

HotList(ProtoJsonArgs)

热门榜单（Public QOT 3414，proto-json）

§

ShortSellingRank(ProtoJsonArgs)

沽空排行（Public QOT 3415，proto-json）

§

PeriodChangeRank(ProtoJsonArgs)

区间涨跌排行（Public QOT 3416，proto-json）

§

HighDividendSoeRank(ProtoJsonArgs)

高股息央企排行（Public QOT 3417，proto-json）

§

InstitutionList(ProtoJsonArgs)

机构列表（Public QOT 3418，proto-json）

§

InstitutionProfile(ProtoJsonArgs)

机构资料（Public QOT 3419，proto-json）

§

InstitutionDistribution(ProtoJsonArgs)

机构持仓分布（Public QOT 3420，proto-json）

§

InstitutionHoldingChange(ProtoJsonArgs)

机构持股变动（Public QOT 3421，proto-json）

§

InstitutionHoldingList(ProtoJsonArgs)

机构持仓列表（Public QOT 3422，proto-json）

§

ArkFundHolding(ProtoJsonArgs)

ARK 基金持仓（Public QOT 3423，proto-json）

§

ArkStockDynamic(ProtoJsonArgs)

ARK 个股交易动态（Public QOT 3424，proto-json）

§

ArkActiveTransaction(ProtoJsonArgs)

ARK 主动交易（Public QOT 3425，proto-json）

§

RatingChange(ProtoJsonArgs)

评级变动（Public QOT 3426，proto-json）

§

IndustrialChainList(ProtoJsonArgs)

产业链列表（Public QOT 3427，proto-json）

§

IndustrialChainDetail(ProtoJsonArgs)

产业链详情（Public QOT 3428，proto-json）

§

IndustrialChainByPlate(ProtoJsonArgs)

板块关联产业链（Public QOT 3429，proto-json）

§

IndustrialPlateInfo(ProtoJsonArgs)

产业板块信息（Public QOT 3430，proto-json）

§

IndustrialPlateStock(ProtoJsonArgs)

产业板块成分股（Public QOT 3431，proto-json）

§

HeatMapData(ProtoJsonArgs)

热力图数据（Public QOT 3432，proto-json）

§

RiseFallDistribution(ProtoJsonArgs)

涨跌分布（Public QOT 3433，proto-json）

§

MarketState

市场状态查询（开盘/休市/午休）

Fields

§symbols: String

证券列表，逗号分隔，如 HK.00700,US.AAPL

§

OwnerPlate

股票所属板块

Fields

§symbols: String

证券列表，逗号分隔

§

OptionChain

期权链（按到期日列出 call/put 合约）

Fields

§owner: Option<String>

正股 MARKET.CODE，如 HK.00700 / US.AAPL（位置参数或 –owner / –code 二选一）

§owner_arg: Option<String>

v1.4.52 BUG-9: REST/MCP 风格命名参数 alias

§begin: String

到期日范围开始 YYYY-MM-DD

§end: String

到期日范围结束 YYYY-MM-DD

§option_type: String

期权类型：all|call|put（默认 all）

§delta_min: Option<f64>

Greek filter: delta 下限

§delta_max: Option<f64>

Greek filter: delta 上限

§iv_min: Option<f64>

Greek filter: implied volatility 下限（小数，如 0.3 = 30%）

§iv_max: Option<f64>

Greek filter: implied volatility 上限（小数，如 0.3 = 30%）

§oi_min: Option<f64>

Greek filter: open interest 下限

§oi_max: Option<f64>

Greek filter: open interest 上限

§gamma_min: Option<f64>

Greek filter: gamma 下限

§gamma_max: Option<f64>

Greek filter: gamma 上限

§vega_min: Option<f64>

Greek filter: vega 下限

§vega_max: Option<f64>

Greek filter: vega 上限

§theta_min: Option<f64>

Greek filter: theta 下限

§theta_max: Option<f64>

Greek filter: theta 上限

§

TradingDays

交易日列表（对齐 py-futu-api request_trading_days）

Fields

§market: String

市场：HK / US / CN / NT / ST / JP / SG

§begin: String

起始日期 YYYY-MM-DD

§end: String

结束日期 YYYY-MM-DD

§

Rehab

复权因子（对齐 py-futu-api get_rehab；长期 K 线对齐 / 回测必用）

Fields

§symbol: String

证券 MARKET.CODE，如 HK.00700 / US.AAPL

§

Suspend

停牌日查询（对齐 py-futu-api get_suspend）

Fields

§symbols: Option<String>

证券列表，逗号分隔（位置参数或 –code / –symbols 二选一）

§symbols_arg: Option<String>

v1.4.52 BUG-9: REST/MCP 风格命名参数 alias

§begin: String

起始日期 YYYY-MM-DD

§end: String

结束日期 YYYY-MM-DD

§

UserSecurity

自选股分组下的股票（对齐 py-futu-api get_user_security）

Fields

§group: Option<String>

分组名（位置参数或 –group 二选一，用 user-security-groups 先看可用分组）

§group_arg: Option<String>

v1.4.52 BUG-9: REST/MCP 风格命名参数 alias

§

UserSecurityGroups

自选股分组列表（对齐 py-futu-api get_user_security_group）

Fields

§group_type: i32

分组类型：1=自定义 / 2=系统 / 3=全部（默认 3）

§

Warrant

涡轮列表（对齐 py-futu-api get_warrant；按成交量降序）

Fields

§owner: Option<String>

可选正股 MARKET.CODE（不传则全市场）

§begin: i32

分页起始 index (默认 0). v1.4.106 codex 0635 ζ36 F1: 暴露分页参数, 拿下一页用 --begin 20 --num 20 (响应含 last_page / all_count)

§num: i32

最大行数（0-200，默认 20；0 表示空页请求）

§

IpoList

新股 IPO 列表（对齐 py-futu-api get_ipo_list）

Fields

§market: String

市场：HK=1 / HK_FUTURE=2 / US=11 / CN/SH=21 / SZ=22 / SG=31 / JP=41 / MY=61

§

IpoCalendar(IpoCalendarArgs)

IPO 日历视图（Rust 增强只读视图，复用 IPO 列表数据）

§

FutureInfo

期货合约资料（对齐 py-futu-api get_future_info）

Fields

§symbols: String

期货代码列表，逗号分隔（如 HK.HSImain / US.MNQmain）

§

StockFilter

条件选股最小版（对齐 py-futu-api get_stock_filter；高级过滤走 REST）

Fields

§market: String

市场：HK=1 / HK_FUTURE=2 / US=11 / CN/SH=21 / SZ=22

§begin: i32

分页起始（默认 0）

§num: i32

返回行数（0-200，默认 50；0 表示空页请求）

§

CancelAllOrder

全部撤单（对齐 py-futu-api cancel_all_order）

风险：立即撤该账户指定市场（不传 --market 则全账户）所有 pending 订单，不可恢复。 real env 必须带 --confirm。

Fields

§acc_id: Option<u64>

账户 id；也可改用 –card-num 传 App 显示卡号

§card_num: Option<String>

App 显示卡号：4 位末尾或 16 位完整卡号

§env: String

环境：simulate（默认）/ real

§market: Option<String>

市场：HK / US / HKCC / CN（可选，不传则全账户）

§jp_acc_type: Option<i32>

JP 子账户类型（TrdHeader.jpAccType / TrdSubAccType）

§confirm: bool

real 环境必须带此 flag 确认（防误触）

§

GlobalState

网关全局状态（市场开闭 / 服务器版本 / 登录状态）

§

UserInfo

用户信息（昵称 / 各市场行情权限 / 订阅配额 / 历史 K 线配额）

§

QuoteRights(QuoteRightsArgs)

行情权限概览（C++ OpenD GUI 风格分组；可选刷新最高行情权限）

§

QuoteCapability(QuoteCapabilityArgs)

单只股票行情能力诊断（摆盘深度 / Lv2 接收 gate / 权限 raw 字段）

§

DelayStatistics

延迟统计（行情推送 / 请求 / 下单三类延迟分布概要）

§

TokenState

v1.4.98 T2-8: NN+MM token 启用/绑定状态查询. unlock-trade -20011 时第一线诊断 (NN=Futu Token app, MM=moomoo Token app, 同协议异 app brand). 输出 4 字段: nn/mm × enable/bind (1=已启用/绑定, 0=未启用/未绑定).

§

RiskFreeRate

v1.4.98 T2-2: 无风险利率 (HK/US/JP, 期权定价基准). backend cmd 20231. 输出 3 市场利率 (百分比 + raw uint64) + update_time.

§

SpreadTable

v1.4.98 T2-1: 摆盘步长 (价位表) — backend cmd 6503. PlaceOrder/ModifyOrder 校验价格合法性必备.

§

TickerStatistic(TickerStatisticArgs)

v1.4.98 T2-3: 逐笔统计 (avg_price / 主买/主卖/中性量等) — cmd 6365. 前置: symbol 必须先 subscribe / get_static_info 触发 stock_id 缓存.

v1.4.102 A3 alias: 加 positional [SYMBOL] 短写, 跟其他行情类 command (quote / snapshot / kline) 一致. futucli ticker-statistic HK.00700 等同 --symbol HK.00700.

§

TickerStatisticDetail(TickerStatisticDetailArgs)

v1.4.106 codex 0500 ζ23-redo: 逐笔统计 Detail (价位级分布) — cmd 6366. 配套 ticker-statistic (Info, cmd 6365): 先调 Info 拿 ticker_time, 再调 Detail 同 ticker_time 拿这个时点的 DetailItem 列表 (price / buy_volume / sell_volume / volume / ratio / neutral_volume). 前置: symbol 必须先 subscribe / get_static_info 触发 stock_id 缓存.

§

QuerySubscription(QuerySubscriptionArgs)

查询当前订阅状态（已用 / 剩余额度 + 订阅清单）

§

UsedQuota

查询当前 daemon 已用订阅额度与历史 K 线额度

§

Unsubscribe(UnsubscribeArgs)

反订阅行情数据（也可 –all 清空本连接所有订阅）

§

Surface(SurfaceArgs)

从 EndpointSpec 输出 REST/MCP/CLI/Gateway surface 覆盖视图

§

HistoryKlQuota(HistoryKlQuotaArgs)

历史 K 线已用 / 剩余下载配额

§

HoldingChange

持股变动（高管 / 机构 / 基金）

Fields

§symbol: String

证券 MARKET.CODE

§category: i32

持有者类别：1=机构 / 2=基金 / 3=高管

§begin: Option<String>

开始时间 YYYY-MM-DD HH:MM:SS（可选）

§end: Option<String>

结束时间（可选）

§

ModifyUserSecurity

修改自选股分组（add / del / move_out）

Fields

§group: String

分组名

§op: i32

操作：1=AddInto / 2=Delete / 3=MoveOut

§symbols: String

证券列表，逗号分隔

§

CodeChange

股票代码变更 / 临时代码信息（目前仅港股）

Fields

§symbols: String

证券列表，逗号分隔

§

SetPriceReminder

设置到价提醒

op：1=Add / 2=Del / 3=Enable / 4=Disable / 5=Modify / 6=DelAll。 type：1=PriceUp、2=PriceDown、3=ChangeRateUp、4=ChangeRateDown、5=5MinChangeRateUp、 6=5MinChangeRateDown、7=VolumeUp、8=TurnoverUp、9=TurnoverRateUp、10=BidPriceUp、 11=AskPriceDown、12=BidVolUp、13=AskVolUp、14=3MinChangeRateUp、15=3MinChangeRateDown。

美股 --session 留空时 daemon 默认补 Open、USPre、USAfter（对齐 C++）。

Fields

§symbol: String

证券 MARKET.CODE

§op: i32

操作码

§key: Option<i64>

提醒 key（modify/del/enable/disable 时必填）

§type: Option<i32>

提醒类型码

§freq: Option<i32>

频率（1=Always 2=OncePerDay 3=Once）

§value: Option<f64>

阈值（add/modify 必填）

§note: Option<String>

备注 (最多 40 半角字节 / 20 中文字符, 对齐 C++ NoteMaxLen)

§session: Vec<i32>

reminder session list，逗号分隔

§

PriceReminder

查询到价提醒（按 symbol 或 market）

Fields

§symbol: Option<String>

证券（和 –market 二选一）

§market: Option<String>

C++ 到价提醒市场桶：HK=1 HK_FUTURE=6 US=11 SH/CN=21 SZ=22（和 –symbol 二选一）

§

OptionExpirationDate

期权到期日列表

Fields

§owner: Option<String>

标的股 MARKET.CODE（位置参数或 –owner 二选一）

§owner_arg: Option<String>

v1.4.52 BUG-9: REST/MCP 风格命名参数 alias

§index_type: Option<i32>

指数期权类型（仅恒指/国指）

§

SubAccPush

订阅账户推送（订单 / 成交）

Fields

§acc_ids: String

账户 id 列表，逗号分隔

§

UnsubAccPush

取消订阅账户推送（订单 / 成交）

Fields

§acc_ids: String

账户 id 列表，逗号分隔；与 sub-acc-push 对称

§

AccCashFlow(AccCashFlowArgs)

账户资金流水（对齐 get_acc_cash_flow）

§

DaemonStatus(DaemonStatusArgs)

v1.4.32+ daemon 健康状态快照（GET /api/admin/status）。同事提议的“快速看 daemon 在线不、broker 通不通、解锁没“工具。 scope 模式下 key 必须持 admin scope，否则被 bearer_auth 拒。

§

Doctor(DoctorArgs)

聚合 REST 健康、订阅、push、quota、metrics 的一键体检。

§

DaemonShutdown(DaemonShutdownArgs)

v1.4.32+ 优雅退出 daemon（POST /api/admin/shutdown）。 daemon 响应 200 表示已接收 shutdown 请求；实际退出走 opend 统一 graceful shutdown 路径。是否重启由进程 supervisor（systemd / Docker）决定。

§

DaemonReload(DaemonReloadArgs)

v1.4.32+ 重置 trade cipher 缓存（POST /api/admin/reload）。用于“解锁状态错乱 / 换了交易密码“场景——清空 cipher 缓存后客户端必须重新 unlock-trade。不重启 daemon 进程，不影响 Platform / broker TCP 连接。

§