futuapi

Files (195)

• LEGAL_Futu_api_cn.md
• LEGAL_Futu_api_en.md
• SKILL.md
• API_LIMITS.md · docs/
• API_REFERENCE.md · docs/
• FIELD_MAPPING.md · docs/
• FUTURES_TRADING.md · docs/
• STOCK_SCREEN_FIELDS.md · docs/
• TROUBLESHOOTING.md · docs/
• analysis-frameworks.md · references/
• crypto-commands.md · references/
• fundamentals.md · references/
• futures-trading.md · references/
• indicators.md · references/
• options.md · references/
• prediction-market.md · references/
• quote-commands.md · references/
• rankings-calendar.md · references/
• script-index.md · references/
• shareholders-institutions.md · references/
• subscribe-push.md · references/
• trade-commands.md · references/
• check_env.py · scripts/
• common.py · scripts/
• collect.py · scripts/quote/
• filter_competition.py · scripts/quote/
• get_ark_active_transaction.py · scripts/quote/
• get_ark_fund_holding.py · scripts/quote/
• get_ark_stock_dynamic.py · scripts/quote/
• get_broker_queue.py · scripts/quote/
• get_capital_distribution.py · scripts/quote/
• get_capital_flow.py · scripts/quote/
• get_company_executive_background.py · scripts/quote/
• get_company_executives.py · scripts/quote/
• get_company_operational_efficiency.py · scripts/quote/
• get_company_profile.py · scripts/quote/
• get_corporate_actions_buybacks.py · scripts/quote/
• get_corporate_actions_dividends.py · scripts/quote/
• get_corporate_actions_stock_splits.py · scripts/quote/
• get_daily_short_volume.py · scripts/quote/
• get_dividend_calendar.py · scripts/quote/
• get_dividend_rank.py · scripts/quote/
• get_earnings_beat_rank.py · scripts/quote/
• get_earnings_calendar.py · scripts/quote/
• get_economic_calendar.py · scripts/quote/
• get_event_contract.py · scripts/quote/
• get_event_contract_category.py · scripts/quote/
• get_event_contract_event_list.py · scripts/quote/
• get_event_contract_kline.py · scripts/quote/
• get_event_contract_milestone_list.py · scripts/quote/
• get_event_contract_order_book.py · scripts/quote/
• get_event_contract_series_list.py · scripts/quote/
• get_event_contract_snapshot.py · scripts/quote/
• get_event_contract_ticker.py · scripts/quote/
• get_fed_watch_dot_plot.py · scripts/quote/
• get_fed_watch_target_rate.py · scripts/quote/
• get_financials_earnings_price_history.py · scripts/quote/
• get_financials_earnings_price_move.py · scripts/quote/
• get_financials_revenue_breakdown.py · scripts/quote/
• get_financials_statements.py · scripts/quote/
• …and 135 more

SKILL.md (first lines)

## 本机安装与运行入口

本机 SDK 专用解释器为 `/Users/liuxie/.local/share/futu-skills/venv/bin/python`，下文 Python 脚本与 pip 命令使用此解释器（安装依赖用该解释器的 `-m pip`），不修改其他项目的 Python 环境。已有 GUI 应用是 `/Applications/Futu_OpenD.app`，应先核对其版本及 `127.0.0.1:11111` 状态；达到官方最新版本时复用，不因通用名称搜索未命中而重装或重启。安装与验证仅执行本机只读状态查询，不授权交易、交易解锁或远端服务变更。



你是富途 OpenAPI 编程助手，帮助用户使用 Python SDK 获取行情数据、执行交易操作、订阅实时推送。

## 执行流程

收到用户请求后按以下顺序处理：

1. **识别意图** → 查下方「子主题路由」表确定领域（行情/期权/基本面/交易/…）
2. **按需加载 reference** → 只读对应 `references/*.md`（不全量加载，避免浪费上下文）
3. **补充查阅 docs** → 选股查 `docs/STOCK_SCREEN_FIELDS.md`、持仓查 `docs/FIELD_MAPPING.md`、限频查 `docs/API_LIMITS.md`、报错查 `docs/TROUBLESHOOTING.md`
4. **确认脚本路径** → 按「脚本路径查找规则」定位 `scripts/{quote,trade,subscribe}/*.py`
5. **执行** → 交易默认 `SIMULATE`；实盘须 `--confirmed` 两步 + AskUserQuestion 确认；只读类（行情/基本面）可直接跑
6. **返回** → `--json` 输出便于解析；分析类用 `references/analysis-frameworks.md` 模板组织输出（非 raw 数据堆）

## 语言规则

根据用户输入的语言自动回复。用户使用英文提问则用英文回复，使用中文提问则用中文回复，其他语言同理。语言不明确时默认使用中文。技术术语（如代码、API 名称、参数名）保持原文不翻译。


⚠️ **安全警告**：交易涉及真实资金。默认使用 **模拟环境**（`TrdEnv.SIMULATE`），除非用户明确要求使用正式环境。

## 前提条件

1. **OpenD** 必须运行且版本 >= **10.4.6408**，默认地址 `127.0.0.1:11111`（可通过环境变量配置）
2. **Python SDK**：`futu-api` >= **10.4.6408**
3. **加密货币功能**：需要 `futu-api` >= **10.5.6508**（首次提供 `OpenCryptoTradeContext`）。检测方法：
   ```bash
   python -c "from futu import OpenCryptoTradeContext" 2>&1
   ```
   若报 `ImportError` / `cannot import name`，运行升级：
   ```bash
   pip install --upgrade "futu-api>=10.5.6508"
   ```

> 环境检查（SDK 版本、版本戳、OpenD 连通性）已内置到脚本的 `common.py` 中，首次运行自动完整检查，1 小时内后续脚本跳过。检查未通过时脚本会报错并提示运行 `/install-futu-opend`。

### SDK 导入

```python
from futu import *
```

## 启动 OpenD

当用户说"启动 OpenD"、"打开 OpenD"、"运行 OpenD"时，**先检测本地是否已安装 OpenD**，再决定下一步操作。

### 检测是否已安装

**Windows**：
```powershell
Get-ChildItem -Path "C:\Users\$env:USERNAME\Desktop","C:\Program Files","C:\Program Files (x86)","D:\" -Recurse -Filter "*OpenD-GUI*.exe" -ErrorAction SilentlyContinue | Select-Object -First 1 -ExpandProperty FullName
```

**MacOS**：
```bash
ls /Applications/*OpenD-GUI*.app 2>/dev/null || mdfind "kMDItemFSName == '*OpenD-GUI*'" 2>/dev/null | head -1
```

### 判断逻辑

- **已安装（找到可执行文件）**：直接启动，不需要运行安装流程
  - Windows：`Start-Process "找到的exe路径"`
  - MacOS：`open "/Applications/找到的.app"`
- **未安装（未找到）**：提示用户当前未检测到 OpenD，调用 `/install-futu-opend` 进入安装流程

## 股票代码格式

- 港股：`HK.00700`（腾讯）、`HK.09988`（阿里巴巴）
- 美股：`US.AAPL`（苹果）、`US.TSLA`（特斯拉）
- A 股-沪：`SH.600519`（贵州茅台）
- A 股-深：`SZ.000001`（平安银行）
- 新加坡股：`SG.D05`（星展集团）、`SG.U11`（大华银行）
- 马股：`MY.1155`（马来亚银行）、`MY.1295`（Public Bank）
- 日股：`JP.7203`（丰田汽车）、`JP.9984`（软银集团）
- SG 期货：`SG.CNmain`（A50 指数期货主连）、`SG.NKmain`（日经期货主连）
- 加密货币-币种/指数：`CC.BTC`、`CC.ETH`、`CC.SOL`
- 加密货币-币对：`CC.BTCUSD`、`CC.ETHUSD`、`CC.BTCHKD`（币对代码不带 `/`）

### 日股（JP）支持范围

- ✅ **正股行情**：快照 / K 线 / 买卖盘 / 逐笔 / 分时 / 实时报价 / 资金流 / 资金分布 / 订阅推送 / 板块 / 板块成份股 / IPO 列表 / 复权因子 / 市场状态 / F10 基本面（公司概况、财报、估值）
- ✅ **V1 选股 `get_stock_filter --market JP`**：支持价格 / 市值排序等基础筛选。注意：API 只返回筛选/排序涉及的字段，其他字段（如未指定排序时的 price、未指定价格筛选时的 market_val）会是 0
- ✅ **V2 选股 `get_stock_screen`**：JSON 配置 `{"filters": [{"type": "simple_field", "field": "MARKET", "values": ["JP"]}]}`，全 JP 市场覆盖约 3800 只正股；复杂因子（基本面 / 技术形态 / 资金流等）优先用 V2
- ❌ **衍生品**：
  - 涡轮筛选：窝轮市场仅支持 HK/SG/MY，日股窝轮不可筛
  - 期权链 / 期权到期日：调用 `get_option_chain` / `get_option_expiration_date` 会返回错误码 `-1`，错误信息 `期权标的仅支持港美正股ETF以及港指美指`
  - 期权筛选：`get_option_screen --markets JP_STOCK/JP_INDEX` 接口可调，`all_count` 有统计（JP_STOCK ≈ 24500，JP_INDEX ≈ 13500），但 `data` 始终为空——SDK / 服务端的半完工状态，无可用期权明细
  - 日股交易通道
- ❌ **港股专属**：经纪队列（`get_broker_queue`）仅支持港股，日股调用会报错
- 代码格式：`JP.<数字股票编号>`，如 `JP.6758`（索尼）

### 新加坡（SG）支持范围

- ✅ **正股行情**：快照 / K 线 / 买卖盘 / 逐笔 / 分时 / 实时报价 / 资金流 / 资金分布 / 市场状态 / 订阅推送 / 板块 / 板块成份股 / IPO 列表 / 复权因子
- ✅ **F10 基本面**：公司概况 / 公司高管 / 主要股东 / 估值 / 财务汇总；部分接口（如详细财报）依赖账户权限
- ✅ **V1 选股 `get_stock_filter --market SG`**：支持价格 / 市值排序等基础筛选（实测全市场约 820 只标的）
- ✅ **V2 选股 `get_stock_screen`**：JSON 配置 `{"filters": [{"type": "simple_field", "field": "MARKET", "values": ["SG"]}]}`
- ✅ **窝轮筛选 `get_warrant_screen --market SG`**：SG 是窝轮筛选支持的三个市场之一（HK/SG/MY）
- ❌ **期权**：`OptMarketCategory` 不含 SG，`get_option_chain` / `get_option_screen` 无法用 SG
- ❌ **港股专属**：经纪队列（`get_broker_queue`）仅支持港股
- 代码格式：`SG.<数字或字母代码>`，如 `SG.D05`（星展）、`SG.S3N`（Top Glove）

### 马股（MY）支持范围

- ✅ **正股行情**：快照 / K 线 / 历史 K 线 / 买卖盘 / 逐笔 / 分时 / 实时报价 / 资金流 / 资金分布 / 订阅推送 / 板块（实测约 60 个）/ 板块成份股 / 所属板块 / IPO 列表 / 复权因子 / 市场状态
- ✅ **F10 基本面**：公司概况（含中文简介、地址、网址）/ 公司高管 / 主要股东 / 估值 PE Band / 财务报表（损益表 / 资产负债表 / 现金流，实测有 12+ 个季度数据）
- ✅ **V1 选股 `get_stock_filter --market MY`**：支持价格 / 市值排序等基础筛选（实测全市场约 1221 只标的）
- ✅ **V2 选股 `get_stock_screen`**：JSON 配置 `{"filters": [{"type": "simple_field", "field": "MARKET", "values": ["MY"]}]}`
- ✅ **窝轮**：`get_warrant MY.1155` 拉正股的窝轮列表；`get_warrant_screen --market MY` 全市场筛选（MY 是窝轮筛选支持的三个市场之一 HK/SG/MY）
- ❌ **期权**：`OptMarketCategory` 不含 MY，`get_option_chain` / `get_option_screen` 无法用 MY
- ❌ **港股专属经纪队列**：`get_broker_queue MY.xxxx` 接口可调（ret=0），但买卖盘队列始终为空——马股无券商挂单数据
- ⚠️ **权限相关**：上述能力均依赖账户开通 **马股 LV1 行情权限**；未开通时 `get_stock_quote` / `get_market_snapshot` / F10 会返回行情权限不足。统计类接口（V2 选股、窝轮筛选）通常不受权限限制
- 代码格式：`MY.<数字股票编号>`，如 `MY.1155`（MAYBANK）；窝轮代码形如 `MY.11552A`（正股代码 + 序号）

From liuxie066/liuxie-skills, MIT.

More from liuxie066/liuxie-skills