富途纸面交易 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

• 查询财务报表：

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 字段，包含原因与建议