賬户與真實交易

選擇賬户、查詢持倉，核對交易預覽後提交，並通過訂單詳情確認最終狀態。

賬户與持倉

先運行 futu account list，使用輸出中的 Account ID 指定賬户。以下示例中的佔位文本需替換為實際賬户或訂單信息。

# 列出賬户，並選擇要使用的 Account ID
futu account list

# 查詢賬户資產
futu account funds --account "替換為賬户ID" --currency USD

# 查看持倉
futu position --account "替換為賬户ID" --format json

# 查詢美股未完成訂單
futu order list --account "替換為賬户ID" --market US

# 查詢當日成交
futu deal --account "替換為賬户ID" --market US

持倉查詢參數

僅查看一個標的的持倉：

futu position --account "替換為賬户ID" --symbol US.AAPL --format json

參數	説明
--account / -a	賬户 ID；未提供時讀取 default_account，兩者都沒有時返回錯誤
--symbol	可選，按證券代碼篩選
--pl-ratio-min	可選，盈虧比例下限；例如 -0.1 表示 -10%
--pl-ratio-max	可選，盈虧比例上限；例如 0.2 表示 +20%

表格中的 Qty、Can Sell、Cost Price、Mkt Value、P/L 與 Currency 分別表示數量、可賣數量、成本價、市值、盈虧和幣種。成本或盈虧無有效值時顯示 -，不能視作 0。

默認賬户

可通過配置設置默認證券交易賬户，後續省略 --account 時使用該賬户：

futu config set default_account "替換為賬户ID"

交易預覽與提交

WARNING

證券和加密貨幣的真實下單、改單、撤單默認先預覽請求，返回三位確認碼，此時不會提交交易操作。核對賬户、標的、方向、數量和價格後，保持原命令參數一致，添加 --execute 和返回的確認碼執行。

# 第一步：預覽限價買單，讀取結構化預覽
futu order buy US.AAPL 1 --account "替換為賬户ID" --type limit --price 180 --format json

預覽 JSON 包含以下狀態字段（節選示意）：

{
  "dry_run": true,
  "submitted": false
}

完整響應還包含請求預覽 preview 和確認碼 confirmation_code。submitted: false 表示尚未提交；使用本次響應中的確認碼，不要從示例中填寫固定數字。

# 第二步：核對預覽後，填寫第一步返回的確認碼並提交
futu order buy US.AAPL 1 --account "替換為賬户ID" --type limit --price 180 --format json --execute "替換為確認碼"

--price 180 僅用於演示參數。賣出使用 futu order sell；改單使用 futu order modify，需指定 --qty 和 --exchange；撤單使用 futu order cancel，需指定 --exchange。確認碼的作用是控制是否提交請求，最終結果以交易接口響應及訂單查詢為準。

TIP

提交後，券商還可能要求二次確認。此時 CLI 會顯示確認信息並等待 y/n 輸入，--format json 不會關閉該交互。由 AI 工具調用時，應把提示交回用户處理。

提交後查詢訂單

使用提交結果中的訂單 ID 查詢詳情；提交成功不代表訂單已成交：

futu order detail "替換為訂單ID" --account "替換為賬户ID" --exchange US --format json

也可查詢當前未完成訂單。已成交、已撤銷的訂單可能不在未完成訂單列表中，應以訂單詳情和歷史記錄核驗：

futu order list --account "替換為賬户ID" --market US --format json
futu order history --account "替換為賬户ID" --market US --format json

當前真實證券撤單提交成功後返回 Order cancelled: … 文本，即使指定 --format json 也應按文本處理。其他解析注意事項見 JSON 輸出約定。