| name | futu-trades |
| description | 查询富途证券最近的交易记录、持仓和账户信息。需要本地运行 FutuOpenD 服务。 |
富途交易查询 Skill
通过调用富途 OpenD API 获取交易数据。
使用场景
当用户想要查看交易记录时使用:
- "查看最近的交易记录"
- "我最近买卖了什么股票"
- "查看持仓"
- "账户情况怎么样"
前置条件
- 本地需要运行 FutuOpenD 服务(默认端口 11111)
- 已安装
futu-api Python 包
命令结构
python3 /Users/liuyishou/.claude/skills/futu-trades/scripts/futu_trades.py [OPTIONS]
参数说明
| 参数 | 说明 | 默认值 |
|---|
--days N | 获取最近 N 天的交易记录 | 7 |
--positions | 获取当前持仓 | - |
--account | 获取账户信息 | - |
--market | 交易市场:US/HK/CN | US |
--test | 测试连接 | - |
使用示例
- 查看最近 7 天交易记录(默认)
python3 /Users/liuyishou/.claude/skills/futu-trades/scripts/futu_trades.py
- 查看最近 30 天交易记录
python3 /Users/liuyishou/.claude/skills/futu-trades/scripts/futu_trades.py --days 30
- 查看当前持仓
python3 /Users/liuyishou/.claude/skills/futu-trades/scripts/futu_trades.py --positions
- 查看账户信息
python3 /Users/liuyishou/.claude/skills/futu-trades/scripts/futu_trades.py --account
- 查看港股交易记录
python3 /Users/liuyishou/.claude/skills/futu-trades/scripts/futu_trades.py --market HK
输出格式
脚本输出 JSON 格式数据,方便解析和展示。
交易记录示例
{
"trades": [
{
"order_id": "123456",
"stock_code": "US.AAPL",
"stock_name": "苹果",
"trade_time": "2025-01-20 10:30:00",
"trade_type": "BUY",
"price": 150.5,
"quantity": 100,
"amount": 15050.0
}
],
"summary": {
"total_trades": 10,
"buy_count": 5,
"sell_count": 5
}
}
注意事项
- 需要确保 FutuOpenD 已启动并登录
- 默认连接 127.0.0.1:11111
- 默认查询实盘环境,如需模拟盘请修改脚本配置