账户与真实交易
选择账户、查询持仓,核对交易预览后提交,并通过订单详情确认最终状态。
账户与持仓
先运行 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 输出约定。