name: xtrade-futu-paper-trade description: 使用富途纸面交易API查询行情、持仓并下单 metadata: {"openclaw":{"requires":{"bins":["python3"]},"os":["darwin","linux","win32"]}}

富途纸面交易 Skill

当用户需要查询行情、持仓、订单、成交或下单时，调用此技能。使用本技能时：

• 统一通过 {baseDir}/xtrade_xtrade_futu_skill.py 执行
• 首次执行会自动创建虚拟环境并安装依赖
• 依赖本地 FutuOpenD 服务

自动安装与引导

• 本技能会自动创建虚拟环境并安装 Python 依赖
• 若系统缺少 python3，请先安装后再重试
• 自动选择兼容 futu-api 的 Python 3.10/3.11/3.12 并重建虚拟环境
• FutuOpenD 属于官方程序，无法由技能自动下载安装
• 可使用 check 指令自动检测并给出引导步骤
• 完成后仅需设置 FUTU_TRADE_PWD 即可交易
• 安全限制：仅允许纸面交易，检测到 REAL 会拒绝执行

FutuOpenD 下载与登录

• 下载入口：https://www.futuhk.com/en/support/topic1_464
• 安装后解压，按文档启动 OpenD（Mac/Windows/Linux）并保持运行
• 登录方式：使用命令行参数 -login_account 与 -login_pwd 启动，不落盘保存密码
• 安全特性：默认不要求在本地保存账号密码

环境变量

• FUTU_HOST：FutuOpenD 地址，默认 127.0.0.1
• FUTU_PORT：FutuOpenD 端口，默认 11111
• FUTU_TRD_ENV：交易环境，仅支持 PAPER（或 SIMULATE）
• FUTU_TRD_MARKET：交易市场，默认 HK
• FUTU_TRADE_PWD：交易解锁密码
• FUTU_ACCOUNT：账号标识，可选
• FUTU_PASSWORD：账号密码，可选

常用命令

• 环境检查： python3 {baseDir}/xtrade_xtrade_futu_skill.py check
• 查询账户资金与资产： python3 {baseDir}/xtrade_xtrade_futu_skill.py funds
• 查询实时行情： python3 {baseDir}/xtrade_xtrade_futu_skill.py quote --symbols HK.00700 HK.09988
• 查询持仓： python3 {baseDir}/xtrade_xtrade_futu_skill.py positions
• 查询今日盈亏： python3 {baseDir}/xtrade_xtrade_futu_skill.py today-pnl
• 下单买入： python3 {baseDir}/xtrade_xtrade_futu_skill.py buy --symbol HK.00700 --qty 100 --price 320.5
• 下单卖出： python3 {baseDir}/xtrade_xtrade_futu_skill.py sell --symbol HK.00700 --qty 100 --price 321.0
• 查询订单： python3 {baseDir}/xtrade_xtrade_futu_skill.py orders --status all
• 撤单： python3 {baseDir}/xtrade_xtrade_futu_skill.py cancel --order-id 8851102695472794941
• 查询成交（默认当日）： python3 {baseDir}/xtrade_xtrade_futu_skill.py fills --days 1
• 获取历史 K 线（日线）： python3 {baseDir}/xtrade_xtrade_futu_skill.py historical-kline --code HK.00700 --start 2025-01-01 --end 2025-01-31 --ktype DAY
• 获取历史 K 线（周线）： python3 {baseDir}/xtrade_xtrade_futu_skill.py historical-kline --code HK.00700 --start 2024-01-01 --end 2025-01-31 --ktype WEEK
• 获取历史 K 线（月线）： python3 {baseDir}/xtrade_xtrade_futu_skill.py historical-kline --code HK.00700 --start 2020-01-01 --end 2025-01-31 --ktype MONTH
• 获取历史 K 线（分钟线）： python3 {baseDir}/xtrade_xtrade_futu_skill.py historical-kline --code HK.00700 --start 2025-01-01 --end 2025-01-02 --ktype 1M
• 获取历史 K 线（分页）： python3 {baseDir}/xtrade_xtrade_futu_skill.py historical-kline --code HK.00700 --start 2025-01-01 --end 2025-01-31 --ktype DAY --max-count 200 --page-req-key <page_req_key>
• 查询财务报表： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-report --code SH.600519 --start 2024-01-01 --end 2024-12-31
• 查询财务指标（季度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-indicators --code SH.600519 --period QUARTER
• 查询财务指标（半年度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-indicators --code SH.600519 --period HALF
• 查询财务指标（年度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-indicators --code SH.600519 --period YEAR
• 查询资产负债表（季度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-balance --code SH.600519 --period QUARTER
• 查询利润表（半年度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-income --code SH.600519 --period HALF
• 查询现金流量表（年度）： python3 {baseDir}/xtrade_xtrade_futu_skill.py financial-cashflow --code SH.600519 --period YEAR

替代接口说明

• financial-report、financial-indicators、financial-balance、financial-income、financial-cashflow 默认优先使用 futu-api
• 当 futu-api 缺失相关接口时，A 股与港股回退 AkShare
• A 股财务报表来自新浪财经（SH./SZ.）
• 港股财务指标来自东方财富，港股财务报表依赖 AkShare 港股接口支持

输出说明

• 所有输出为 JSON
• 失败时返回 error 字段，包含原因与建议