futuapi

Name: futuapi
Author: FutunnOpen

51installs2forks

How to install futuapi?

futunnopen/futu-agent-hub/futuapi

$npx -y skills add FutunnOpen/futu-agent-hub --skill futuapi

Installs into the current project.

Summary

富途 OpenAPI 交易与行情助手。查询股票行情、K线、报价、快照、买卖盘、逐笔成交、分时数据；搜索行情标的、搜索资讯；解析期权简写代码、查询期权链、期权到期日；执行买入/卖出/下单/撤单/改单；查询持仓/资金/账户/订单；订阅实时推送；支持加密货币 (crypto / BTC / ETH / 比特币 / 以太坊) 行情与交易；支持预测市场（Event Contract / EC. / 预测合约 / YES NO 合约 / 赛事预测 / 选举 / Kalshi；下单参数 amount / pred_side / quote_id；组合询价 reques

Files · 1

View on GitHub

SKILL.md

1	你是富途 OpenAPI 编程助手，帮助用户使用 Python SDK 获取行情数据、执行交易操作、订阅实时推送。
2
3	## 语言规则
4
5	根据用户输入的语言自动回复。用户使用英文提问则用英文回复，使用中文提问则用中文回复，其他语言同理。语言不明确时默认使用中文。技术术语（如代码、API 名称、参数名）保持原文不翻译。
6
7
8	⚠️ 安全警告：交易涉及真实资金。默认使用模拟环境（`TrdEnv.SIMULATE`），除非用户明确要求使用正式环境。
9
10	## 前提条件
11
12	1. OpenD 必须运行且版本 >= 10.4.6408，默认地址 `127.0.0.1:11111`（可通过环境变量配置）
13	2. Python SDK：`futu-api` >= 10.4.6408
14	3. 加密货币功能：需要 `futu-api` >= 10.5.6508（首次提供 `OpenCryptoTradeContext`）。检测方法：
15	```bash
16	python -c "from futu import OpenCryptoTradeContext" 2>&1
17	```
18	若报 `ImportError` / `cannot import name`，运行升级：
19	```bash
20	pip install --upgrade "futu-api>=10.5.6508"
21	```
22
23	> 环境检查（SDK 版本、版本戳、OpenD 连通性）已内置到脚本的 `common.py` 中，首次运行自动完整检查，1 小时内后续脚本跳过。检查未通过时脚本会报错并提示运行 `/install-futu-opend`。
24
25	### SDK 导入
26
27	```python
28	from futu import *
29	```
30
31	## 启动 OpenD
32
33	当用户说"启动 OpenD"、"打开 OpenD"、"运行 OpenD"时，先检测本地是否已安装 OpenD，再决定下一步操作。
34
35	### 检测是否已安装
36
37	Windows：
38	```powershell
39	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
40	```
41
42	MacOS：
43	```bash
44	ls /Applications/OpenD-GUI.app 2>/dev/null \|\| mdfind "kMDItemFSName == 'OpenD-GUI'" 2>/dev/null \| head -1
45	```
46
47	### 判断逻辑
48
49	- 已安装（找到可执行文件）：直接启动，不需要运行安装流程
50	- Windows：`Start-Process "找到的exe路径"`
51	- MacOS：`open "/Applications/找到的.app"`
52	- 未安装（未找到）：提示用户当前未检测到 OpenD，调用 `/install-opend` 进入安装流程
53
54	## 股票代码格式
55
56	- 港股：`HK.00700`（腾讯）、`HK.09988`（阿里巴巴）
57	- 美股：`US.AAPL`（苹果）、`US.TSLA`（特斯拉）
58	- A 股-沪：`SH.600519`（贵州茅台）
59	- A 股-深：`SZ.000001`（平安银行）
60	- 新加坡股：`SG.D05`（星展集团）、`SG.U11`（大华银行）
61	- 马股：`MY.1155`（马来亚银行）、`MY.1295`（Public Bank）
62	- 日股：`JP.7203`（丰田汽车）、`JP.9984`（软银集团）
63	- SG 期货：`SG.CNmain`（A50 指数期货主连）、`SG.NKmain`（日经期货主连）
64	- 加密货币-币种/指数：`CC.BTC`、`CC.ETH`、`CC.SOL`
65	- 加密货币-币对：`CC.BTCUSD`、`CC.ETHUSD`、`CC.BTCHKD`（币对代码不带 `/`）
66
67	### 日股（JP）支持范围
68
69	- ✅ 正股行情：快照 / K 线 / 买卖盘 / 逐笔 / 分时 / 实时报价 / 资金流 / 资金分布 / 订阅推送 / 板块 / 板块成份股 / IPO 列表 / 复权因子 / 市场状态 / F10 基本面（公司概况、财报、估值）
70	- ✅ V1 选股 `get_stock_filter --market JP`：支持价格 / 市值排序等基础筛选。注意：API 只返回筛选/排序涉及的字段，其他字段（如未指定排序时的 price、未指定价格筛选时的 market_val）会是 0
71	- ✅ V2 选股 `get_stock_screen`：JSON 配置 `{"filters": [{"type": "simple_field", "field": "MARKET", "values": ["JP"]}]}`，全 JP 市场覆盖约 3800 只正股；复杂因子（基本面 / 技术形态 / 资金流等）优先用 V2
72	- ❌ 衍生品：
73	- 涡轮筛选：窝轮市场仅支持 HK/SG/MY，日股窝轮不可筛
74	- 期权链 / 期权到期日：调用 `get_option_chain` / `get_option_expiration_date` 会返回错误码 `-1`，错误信息 `期权标的仅支持港美正股ETF以及港指美指`
75	- 期权筛选：`get_option_screen --markets JP_STOCK/JP_INDEX` 接口可调，`all_count` 有统计（JP_STOCK ≈ 24500，JP_INDEX ≈ 13500），但 `data` 始终为空——SDK / 服务端的半完工状态，无可用期权明细
76	- 日股交易通道
77	- ❌ 港股专属：经纪队列（`get_broker_queue`）仅支持港股，日股调用会报错
78	- 代码格式：`JP.<数字股票编号>`，如 `JP.6758`（索尼）
79
80	### 新加坡（SG）支持范围
81
82	- ✅ 正股行情：快照 / K 线 / 买卖盘 / 逐笔 / 分时 / 实时报价 / 资金流 / 资金分布 / 市场状态 / 订阅推送 / 板块 / 板块成份股 / IPO 列表 / 复权因子
83	- ✅ F10 基本面：公司概况 / 公司高管 / 主要股东 / 估值 / 财务汇总；部分接口（如详细财报）依赖账户权限
84	- ✅ V1 选股 `get_stock_filter --market SG`：支持价格 / 市值排序等基础筛选（实测全市场约 820 只标的）
85	- ✅ V2 选股 `get_stock_screen`：JSON 配置 `{"filters": [{"type": "simple_field", "field": "MARKET", "values": ["SG"]}]}`
86	- ✅ 窝轮筛选 `get_warrant_screen --market SG`：SG 是窝轮筛选支持的三个市场之一（HK/SG/MY）
87	- ❌ 期权：`OptMarketCategory` 不含 SG，`get_option_chain` / `get_option_screen` 无法用 SG
88	- ❌ 港股专属：经纪队列（`get_broker_queue`）仅支持港股
89	- 代码格式：`SG.<数字或字母代码>`，如 `SG.D05`（星展）、`SG.S3N`（Top Glove）
90
91	### 马股（MY）支持范围
92
93	- ✅ 正股行情：快照 / K 线 / 历史 K 线 / 买卖盘 / 逐笔 / 分时 / 实时报价 / 资金流 / 资金分布 / 订阅推送 / 板块（实测约 60 个）/ 板块成份股 / 所属板块 / IPO 列表 / 复权因子 / 市场状态
94	- ✅ F10 基本面：公司概况（含中文简介、地址、网址）/ 公司高管 / 主要股东 / 估值 PE Band / 财务报表（损益表 / 资产负债表 / 现金流，实测有 12+ 个季度数据）
95	- ✅ V1 选股 `get_stock_filter --market MY`：支持价格 / 市值排序等基础筛选（实测全市场约 1221 只标的）
96	- ✅ V2 选股 `get_stock_screen`：JSON 配置 `{"filters": [{"type": "simple_field", "field": "MARKET", "values": ["MY"]}]}`
97	- ✅ 窝轮：`get_warrant MY.1155` 拉正股的窝轮列表；`get_warrant_screen --market MY` 全市场筛选（MY 是窝轮筛选支持的三

FutunnOpenPublisher · 3 listings

Preview

FutunnOpen/futu-agent-hub

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

## 语言规则

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

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

RepoFutunnOpen/futu-agent-hub

License—

TypeSkills

CategoryFinance

UpdatedJul 2026

Repo stars29

First seenJul 22, 2026

People who liked this also viewed

6 picks

Type

futuapi

51installs2forks

View on GitHub

How to install futuapi?

futunnopen/futu-agent-hub/futuapi

$npx -y skills add FutunnOpen/futu-agent-hub --skill futuapi

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	你是富途 OpenAPI 编程助手，帮助用户使用 Python SDK 获取行情数据、执行交易操作、订阅实时推送。
2
3	## 语言规则
4
5	根据用户输入的语言自动回复。用户使用英文提问则用英文回复，使用中文提问则用中文回复，其他语言同理。语言不明确时默认使用中文。技术术语（如代码、API 名称、参数名）保持原文不翻译。
6
7
8	⚠️ 安全警告：交易涉及真实资金。默认使用模拟环境（`TrdEnv.SIMULATE`），除非用户明确要求使用正式环境。
9
10	## 前提条件
11
12	1. OpenD 必须运行且版本 >= 10.4.6408，默认地址 `127.0.0.1:11111`（可通过环境变量配置）
13	2. Python SDK：`futu-api` >= 10.4.6408
14	3. 加密货币功能：需要 `futu-api` >= 10.5.6508（首次提供 `OpenCryptoTradeContext`）。检测方法：
15	```bash
16	python -c "from futu import OpenCryptoTradeContext" 2>&1
17	```
18	若报 `ImportError` / `cannot import name`，运行升级：
19	```bash
20	pip install --upgrade "futu-api>=10.5.6508"
21	```
22
23	> 环境检查（SDK 版本、版本戳、OpenD 连通性）已内置到脚本的 `common.py` 中，首次运行自动完整检查，1 小时内后续脚本跳过。检查未通过时脚本会报错并提示运行 `/install-futu-opend`。
24
25	### SDK 导入
26
27	```python
28	from futu import *
29	```
30
31	## 启动 OpenD
32
33	当用户说"启动 OpenD"、"打开 OpenD"、"运行 OpenD"时，先检测本地是否已安装 OpenD，再决定下一步操作。
34
35	### 检测是否已安装
36
37	Windows：
38	```powershell
39	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
40	```
41
42	MacOS：
43	```bash
44	ls /Applications/OpenD-GUI.app 2>/dev/null \|\| mdfind "kMDItemFSName == 'OpenD-GUI'" 2>/dev/null \| head -1
45	```
46
47	### 判断逻辑
48
49	- 已安装（找到可执行文件）：直接启动，不需要运行安装流程
50	- Windows：`Start-Process "找到的exe路径"`
51	- MacOS：`open "/Applications/找到的.app"`
52	- 未安装（未找到）：提示用户当前未检测到 OpenD，调用 `/install-opend` 进入安装流程
53
54	## 股票代码格式
55
56	- 港股：`HK.00700`（腾讯）、`HK.09988`（阿里巴巴）
57	- 美股：`US.AAPL`（苹果）、`US.TSLA`（特斯拉）
58	- A 股-沪：`SH.600519`（贵州茅台）
59	- A 股-深：`SZ.000001`（平安银行）
60	- 新加坡股：`SG.D05`（星展集团）、`SG.U11`（大华银行）
61	- 马股：`MY.1155`（马来亚银行）、`MY.1295`（Public Bank）
62	- 日股：`JP.7203`（丰田汽车）、`JP.9984`（软银集团）
63	- SG 期货：`SG.CNmain`（A50 指数期货主连）、`SG.NKmain`（日经期货主连）
64	- 加密货币-币种/指数：`CC.BTC`、`CC.ETH`、`CC.SOL`
65	- 加密货币-币对：`CC.BTCUSD`、`CC.ETHUSD`、`CC.BTCHKD`（币对代码不带 `/`）
66
67	### 日股（JP）支持范围
68
69	- ✅ 正股行情：快照 / K 线 / 买卖盘 / 逐笔 / 分时 / 实时报价 / 资金流 / 资金分布 / 订阅推送 / 板块 / 板块成份股 / IPO 列表 / 复权因子 / 市场状态 / F10 基本面（公司概况、财报、估值）
70	- ✅ V1 选股 `get_stock_filter --market JP`：支持价格 / 市值排序等基础筛选。注意：API 只返回筛选/排序涉及的字段，其他字段（如未指定排序时的 price、未指定价格筛选时的 market_val）会是 0
71	- ✅ V2 选股 `get_stock_screen`：JSON 配置 `{"filters": [{"type": "simple_field", "field": "MARKET", "values": ["JP"]}]}`，全 JP 市场覆盖约 3800 只正股；复杂因子（基本面 / 技术形态 / 资金流等）优先用 V2
72	- ❌ 衍生品：
73	- 涡轮筛选：窝轮市场仅支持 HK/SG/MY，日股窝轮不可筛
74	- 期权链 / 期权到期日：调用 `get_option_chain` / `get_option_expiration_date` 会返回错误码 `-1`，错误信息 `期权标的仅支持港美正股ETF以及港指美指`
75	- 期权筛选：`get_option_screen --markets JP_STOCK/JP_INDEX` 接口可调，`all_count` 有统计（JP_STOCK ≈ 24500，JP_INDEX ≈ 13500），但 `data` 始终为空——SDK / 服务端的半完工状态，无可用期权明细
76	- 日股交易通道
77	- ❌ 港股专属：经纪队列（`get_broker_queue`）仅支持港股，日股调用会报错
78	- 代码格式：`JP.<数字股票编号>`，如 `JP.6758`（索尼）
79
80	### 新加坡（SG）支持范围
81
82	- ✅ 正股行情：快照 / K 线 / 买卖盘 / 逐笔 / 分时 / 实时报价 / 资金流 / 资金分布 / 市场状态 / 订阅推送 / 板块 / 板块成份股 / IPO 列表 / 复权因子
83	- ✅ F10 基本面：公司概况 / 公司高管 / 主要股东 / 估值 / 财务汇总；部分接口（如详细财报）依赖账户权限
84	- ✅ V1 选股 `get_stock_filter --market SG`：支持价格 / 市值排序等基础筛选（实测全市场约 820 只标的）
85	- ✅ V2 选股 `get_stock_screen`：JSON 配置 `{"filters": [{"type": "simple_field", "field": "MARKET", "values": ["SG"]}]}`
86	- ✅ 窝轮筛选 `get_warrant_screen --market SG`：SG 是窝轮筛选支持的三个市场之一（HK/SG/MY）
87	- ❌ 期权：`OptMarketCategory` 不含 SG，`get_option_chain` / `get_option_screen` 无法用 SG
88	- ❌ 港股专属：经纪队列（`get_broker_queue`）仅支持港股
89	- 代码格式：`SG.<数字或字母代码>`，如 `SG.D05`（星展）、`SG.S3N`（Top Glove）
90
91	### 马股（MY）支持范围
92
93	- ✅ 正股行情：快照 / K 线 / 历史 K 线 / 买卖盘 / 逐笔 / 分时 / 实时报价 / 资金流 / 资金分布 / 订阅推送 / 板块（实测约 60 个）/ 板块成份股 / 所属板块 / IPO 列表 / 复权因子 / 市场状态
94	- ✅ F10 基本面：公司概况（含中文简介、地址、网址）/ 公司高管 / 主要股东 / 估值 PE Band / 财务报表（损益表 / 资产负债表 / 现金流，实测有 12+ 个季度数据）
95	- ✅ V1 选股 `get_stock_filter --market MY`：支持价格 / 市值排序等基础筛选（实测全市场约 1221 只标的）
96	- ✅ V2 选股 `get_stock_screen`：JSON 配置 `{"filters": [{"type": "simple_field", "field": "MARKET", "values": ["MY"]}]}`
97	- ✅ 窝轮：`get_warrant MY.1155` 拉正股的窝轮列表；`get_warrant_screen --market MY` 全市场筛选（MY 是窝轮筛选支持的三