fosun-trading

Trade stocks (query price, check funds/holdings/cash flows, place/cancel orders) using Fosun OpenAPI SDK via command-line scripts. Supports HK (L2), US (L1), and A-share (Shanghai-HK/Shenzhen-HK Stock Connect, L1) markets. Supports limit and market order types. Use when the user wants to check stock prices, query account balance, check cash flow history, buy/sell stocks, or manage orders.

3,767 stars

byopenclaw

View on GitHub Installation ↓

Best use case

fosun-trading is best used when you need a repeatable AI agent workflow instead of a one-off prompt. It is especially useful for teams working in multi. Trade stocks (query price, check funds/holdings/cash flows, place/cancel orders) using Fosun OpenAPI SDK via command-line scripts. Supports HK (L2), US (L1), and A-share (Shanghai-HK/Shenzhen-HK Stock Connect, L1) markets. Supports limit and market order types. Use when the user wants to check stock prices, query account balance, check cash flow history, buy/sell stocks, or manage orders.

Users should expect a more consistent workflow output, faster repeated execution, and less time spent rewriting prompts from scratch.

Practical example

Example input

Use the "fosun-trading" skill to help with this workflow task. Context: Trade stocks (query price, check funds/holdings/cash flows, place/cancel orders) using Fosun OpenAPI SDK via command-line scripts. Supports HK (L2), US (L1), and A-share (Shanghai-HK/Shenzhen-HK Stock Connect, L1) markets. Supports limit and market order types. Use when the user wants to check stock prices, query account balance, check cash flow history, buy/sell stocks, or manage orders.

Example output

A structured workflow result with clearer steps, more consistent formatting, and an output that is easier to reuse in the next run.

When to use this skill

Use this skill when you want a reusable workflow rather than writing the same prompt again and again.

When not to use this skill

Do not use this when you only need a one-off answer and do not need a reusable workflow.
Do not use it if you cannot install or maintain the related files, repository context, or supporting tools.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/fosun-trading/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/2023andrewyang/fw-trading/fosun-trading/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/fosun-trading/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How fosun-trading Compares

Feature / Agent	fosun-trading	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

AI Agent for YouTube Script Writing

Find AI agent skills for YouTube script writing, video research, content outlining, and repeatable channel production workflows.

AI Agent for Product Research

Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.

AI Agent for SaaS Idea Validation

Use AI agent skills for SaaS idea validation, market research, customer discovery, competitor analysis, and documenting startup hypotheses.

SKILL.md Source

# 复星交易工具集

通过命令行脚本完成港股/美股/A 股（港股通）的行情查询、资金查询、资金流水查询、下单和订单管理。所有脚本位于 `code/` 目录下。

## 前置条件

1. SDK 已安装（参考 `fosun-sdk-setup` skill）
2. 环境变量已配置：
   - `FSOPENAPI_SERVER_PUBLIC_KEY` — 服务端公钥（PEM）
   - `FSOPENAPI_CLIENT_PRIVATE_KEY` — 客户端私钥（PEM）
   - `FSOPENAPI_API_KEY` — API Key（也可通过 `--api-key` 传入）
   - `FSOPENAPI_BASE_URL` — 网关地址（可选，默认 `https://openapi-sit.fosunxcz.com`）

> 如果工作区或 `/tmp` 下存在 `fosun.env`，脚本会自动加载其中的凭证。

---

## 环境约束（必须遵守）

- **优先复用现有虚拟环境**：如果 `{workspace_root}/.venv-fosun` 存在，必须使用它。
- **禁止擅自新建虚拟环境**：未经用户明确要求，**不得**执行 `python -m venv ...`、`uv venv ...`、`conda create ...` 等命令。
- **禁止安装到系统 Python 或其他临时环境**。
- **不要使用裸 `python` / `pip`**；统一使用目标虚拟环境里的绝对路径解释器与 pip。

当前 workspace 的标准环境为：

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python
/Users/admin/.openclaw/workspace/.venv-fosun/bin/pip
```

所有脚本运行示例应使用：

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python <脚本名>.py <子命令> [参数]
```

如果 `.venv-fosun` 不存在：
- 先检查记忆文件（`memory/YYYY-MM-DD.md` 或 `MEMORY.md`）里是否记录了其他既有环境路径；
- 若存在既有环境，则复用该环境；
- 若不存在既有环境，**不要自行创建新环境**，先向用户确认。

## 支持的市场

| 市场代码 | 说明 | 行情级别 | 币种 |
|----------|------|----------|------|
| `hk` | 港股 | L2（含盘口、经纪商队列） | HKD |
| `us` | 美股 | L1（支持盘前/盘中/盘后） | USD |
| `sh` | 上交所（港股通） | L1 | CNH |
| `sz` | 深交所（港股通） | L1 | CNH |

**标的代码格式**：`marketCode + stockCode`

| 示例 | 说明 |
|------|------|
| `hk00700` | 腾讯控股（港股） |
| `usAAPL` | 苹果（美股） |
| `sh600519` | 贵州茅台（A 股-沪） |
| `sz000001` | 平安银行（A 股-深） |

## 支持的订单类型

| 名称 | order_type 值 | CLI 参数 | 是否需要 price | 适用市场 | 说明 |
|------|---------------|----------|----------------|----------|------|
| 竞价限价单 | `1` | `auction_limit` | 是 | 港股 | 竞价时段以指定价格参与竞价 |
| 竞价单 | `2` | `auction` | 否 | 港股 | 竞价时段以市场价参与竞价 |
| 限价单 | `3` | `limit`（默认） | 是 | 港/美/A | 普通限价委托 |
| 增强限价单 | `4` | `enhanced_limit` | 是 | 港股 | 最多配对 10 个价位，未成交部分保留为限价单 |
| 特别限价单 | `5` | `special_limit` | 是 | 港股 | 最多配对 10 个价位，未成交部分自动取消 |
| 市价单 | `9` | `market` | 否 | 港/美 | 以当前市场价成交 |

## 运行方式

所有脚本在 `code/` 目录下运行：

```bash
cd /Users/admin/.openclaw/workspace/skills/fosun_skills/fosun-trading/code
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python <脚本名>.py <子命令> [参数]
```

或者使用完整路径：

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python /Users/admin/.openclaw/workspace/skills/fosun_skills/fosun-trading/code/<脚本名>.py <子命令> [参数]
```

所有脚本支持公共参数：`--api-key`、`--base-url`、`--sub-account-id`。

---

## 1. 查询行情 — query_price.py

> **仅支持主动拉取（API 调用），不支持推送。**
>
> - 港股：L2 行情（含盘口、经纪商队列）
> - 美股：L1 行情（支持盘前/盘中/盘后）
> - A 股（港股通）：L1 行情

### 批量报价（最常用）

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_price.py quote hk00700 usAAPL sh600519
```

### 盘口/买卖档

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_price.py orderbook hk00700 --count 5
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_price.py orderbook sh600519 --count 5
```

### K 线

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_price.py kline hk00700 --ktype day -n 30
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_price.py kline sh600519 --ktype min5 -n 60
```

`ktype` 可选：`day` / `week` / `month` / `year` / `min1` / `min5` / `min15` / `min30` / `min60`

### 分时

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_price.py min hk00700 --count 5
```

### 逐笔成交

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_price.py tick hk00700 -n 20
```

### 经纪商队列（仅港股 L2）

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_price.py broker hk00700
```

---

## 2. 查询买卖信息 — query_bidask.py

> 查询某只股票的**每手股数（lotSize）**、最大可买/可卖数量、购买力等信息。
> 对应 API 接口：`POST /api/v1/trade/BidAskInfo`

### 查询每手股数

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 00700                           # 港股（默认限价买入）
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 00700 --lot-size-only           # 仅输出 lotSize 数值
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock AAPL --market us --lot-size-only
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 600519 --market sh --lot-size-only
```

### 查询可买/可卖数量

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 00700 --price 350.000           # 指定价格查更精确的可买数量
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 00700 --direction sell           # 查可卖数量
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock AAPL --market us                 # 美股
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 600519 --market sh               # A 股（沪）
```

### 指定订单类型查询

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 00700 --order-type market           # 市价单
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 00700 --order-type enhanced_limit   # 增强限价单
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 00700 --order-type special_limit    # 特别限价单
```

### 全部参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `--stock` | 是 | 股票代码（不含市场前缀） |
| `--market` | 否 | `hk`（默认）/ `us` / `sh` / `sz` |
| `--direction` | 否 | `buy`（默认）/ `sell` |
| `--order-type` | 否 | `limit`（默认）/ `enhanced_limit` / `special_limit` / `market` |
| `--price` | 否 | 委托价格（传入可得到更精确的可买数量） |
| `--quantity` | 否 | 委托数量 |
| `--lot-size-only` | 否 | 仅输出每手股数数值 |

### 响应关键字段

| 字段 | 类型 | 说明 |
|------|------|------|
| `maxPurchasePower` | string | 最大购买力（含融资） |
| `cashPurchasePower` | string | 现金购买力 |
| `availableWithdrawBalance` | string | 总账户可用现金 |
| `singleWithdrawBalance` | string | 当前币种可提现金 |
| `currency` | string | 币种（HKD/USD/CNH） |
| `lotSize` | int | **每手股数**（如港股腾讯 = 100，即一手 100 股） |
| `cashQuantityBuy` | int | 现金可买数量 |
| `maxQuantityBuy` | int | 最大可买数量 |
| `baseQuantitySell` | int | 本币种可卖数量 |
| `maxQuantitySell` | int | 持仓可卖数量（含关联币种） |

> **⚠️ 每手股数（lotSize）说明**
>
> 不同股票的每手股数不同，**必须通过此接口动态查询**，不可硬编码。
>
> | 市场 | 每手规则 | 示例 |
> |------|----------|------|
> | 港股 | 每只股票不同，由交易所定义 | 腾讯(00700) = 100 股/手 |
> | 美股 | 通常 1 股起买，无整手限制 | AAPL lotSize = 1 |
> | A 股（港股通） | 通常 100 股/手 | 贵州茅台(600519) = 100 股/手 |
>
> 港股下单时 quantity 必须是 lotSize 的整数倍，否则会被拒单。

---

## 3. 查询资金/持仓 — query_funds.py

### 资金汇总（可用资金/冻结资金/总资产）

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_funds.py summary
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_funds.py summary --currency HKD
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_funds.py summary --currency CNH     # A 股人民币资金
```

关键字段：

| 字段 | 说明 |
|------|------|
| `summary.cashPurchasingPower` | 现金购买力（可用资金） |
| `summary.frozenBalance` | 冻结资金 |
| `summary.ledgerBalance` | 账面余额（总资产） |
| `summary.maxPurchasingPower` | 最大购买力 |
| `breakdown[]` | 分币种明细（HKD/USD/CNH） |

完整字段见 [docs/CashSummary.md](docs/CashSummary.md)。

### 持仓列表（持仓数量/当前市值/成本价）

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_funds.py holdings
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_funds.py holdings --symbols hk00700 --currencies HKD USD
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_funds.py holdings --symbols sh600519 --currencies CNH
```

关键字段：

| 字段 | 说明 |
|------|------|
| `list[].stockCode` | 股票代码 |
| `list[].quantity` | 持仓数量 |
| `list[].quantityAvail` | 可用数量 |
| `list[].price` | 当前市价 |
| `list[].avgCost` | 平均成本 |
| `list[].dilutedCost` | 摊薄成本 |

完整字段见 [docs/Holdings.md](docs/Holdings.md)。

> **⚠️ 成本字段说明：持仓有两种成本，务必区分，没有明确说明哪个成本就必须都告诉用户且区分**
>
> | 字段 | 含义 | 计算方式 |
> |------|------|----------|
> | `avgCost` | **平均成本** | 所有买入交易的加权平均价格，不因卖出而变化 |
> | `dilutedCost` | **摊薄成本** | 在平均成本基础上，将已实现盈亏摊薄到剩余持仓中 |
>
> - 如果只买入未卖出过，两者相同。
> - 一旦部分卖出且产生盈利，`dilutedCost` 会低于 `avgCost`（盈利被摊薄到剩余持仓）；反之亏损卖出时 `dilutedCost` 会高于 `avgCost`。
> - **查看买入均价**用 `avgCost`；**评估真实持仓成本（含已实现盈亏）**用 `dilutedCost`。

### 账户列表

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_funds.py accounts
```

---

## 4. 查询资金流水 — query_cashflows.py

> 查询账户的资金进出明细（交易结算、出入金、利息、费用等）。
> 对应 API 接口：`POST /api/v1/trade/CashFlows`

### 查询全部流水

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_cashflows.py
```

### 按日期范围查询

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_cashflows.py --from-date 2025-01-01 --to-date 2025-01-31
```

### 查询指定日期

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_cashflows.py --date 2025-03-15
```

### 按类型筛选

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_cashflows.py --flow-type 1
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_cashflows.py --business-type 1 2
```

### 全部参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `--from-date` | 否 | 开始日期 yyyy-mm-dd |
| `--to-date` | 否 | 结束日期 yyyy-mm-dd |
| `--date` | 否 | 指定日期 yyyy-mm-dd（查询单日流水） |
| `--flow-type` | 否 | 流水类型 |
| `--business-type` | 否 | 业务类型（可多个） |

---

## 5. 下单 — place_order.py

> 支持限价单、增强限价单、特别限价单、竞价单、竞价限价单和市价单，覆盖港/美/A 股市场。

> **⚠️ 重要：下单前必须与用户二次确认！**
> 当已解析出明确的订单参数（股票代码、方向、数量、价格等）后，**禁止直接执行下单命令**。
> 必须先将完整的订单参数汇总展示给用户（适合用户阅读的格式），等待用户明确确认后才能执行。
> 这是一项涉及真实资金的操作，任何情况下都不得跳过确认步骤。

> **⚠️ 重要：用户说"买/卖 N 手"时，必须先查询每手股数再换算成股数！**
> 当用户的指令中使用"手"作为数量单位（如"帮我买 1 手腾讯"、"卖 3 手 00700"），**必须先调用 `query_bidask.py --lot-size-only` 查询该股票的每手股数（lotSize）**，再将手数换算为股数（quantity = 手数 × lotSize），最终以股数下单。
>
> ```bash
> # 示例：用户说"买 2 手腾讯 (00700)"
> # 第一步：查询每手股数
> /Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 00700 --lot-size-only
> # 假设输出 100，即一手 = 100 股
> # 第二步：计算 quantity = 2 × 100 = 200
> # 第三步：下单时 --quantity 200
> ```
>
> **禁止假设每手股数**，不同股票的 lotSize 不同，必须动态查询。

> **⚠️ 重要：最大可买/可卖数量必须通过接口查询，禁止自行计算！**
> 下单前需要确认可买/可卖数量时，**必须调用 `query_bidask.py` 接口查询**，不得根据资金余额、股价、持仓数量等信息自行推算。
> 接口返回的 `maxQuantityBuy`（最大可买）和 `maxQuantitySell`（最大可卖）已综合考虑购买力、保证金、风控规则等因素，手动计算无法覆盖这些逻辑，极易导致下单失败或数量错误。
>
> ```bash
> # 查询最大可买数量（指定价格更精确）
> /Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 00700 --price 350.000
> # 查询最大可卖数量
> /Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 00700 --direction sell
> ```

### 港股限价买入（默认 order_type=limit）

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 00700 --direction buy --quantity 100 --price 350.000
```

### 港股增强限价买入

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 00700 --direction buy --quantity 100 --price 350.000 --order-type enhanced_limit
```

### 港股特别限价买入

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 00700 --direction buy --quantity 100 --price 350.000 --order-type special_limit
```

### 港股市价买入

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 00700 --direction buy --quantity 100 --order-type market
```

### 港股竞价限价买入

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 00700 --direction buy --quantity 100 --price 350.000 --order-type auction_limit
```

### 港股竞价买入

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 00700 --direction buy --quantity 100 --order-type auction
```

### 美股市价买入（盘中）

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock AAPL --market us --direction buy --quantity 5 --order-type market
```

### 美股限价卖出

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock AAPL --market us --direction sell --quantity 5 --price 180.00 --currency USD
```

### A 股（港股通）限价买入

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 600519 --market sh --direction buy --quantity 100 --price 1800.00
```

### A 股（港股通）市价买入

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 000001 --market sz --direction buy --quantity 100 --order-type market
```

### 下单前校验（不实际下单）

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 00700 --direction buy --quantity 100 --price 350.000 --check-only
```

`--check-only` 返回可买/可卖数量、购买力、每手股数等信息。

### 全部参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `--stock` | 是 | 股票代码（不含市场前缀） |
| `--direction` | 是 | `buy` / `sell` |
| `--quantity` | 是 | 委托数量 |
| `--order-type` | 否 | `auction_limit`(1) / `auction`(2) / `limit`(3,默认) / `enhanced_limit`(4) / `special_limit`(5) / `market`(9) |
| `--price` | 条件 | 委托价格。市价单可不传，限价单必填 |
| `--market` | 否 | `hk`（默认）/ `us` / `sh` / `sz` |
| `--currency` | 否 | 自动根据 market 选择（HKD/USD/CNH） |
| `--check-only` | 否 | 仅校验，不下单 |
| `--exp-type` | 否 | `1`=当日有效（默认），`2`=GTC |

### price 小数位规则

- 港股：3 位小数（如 `350.000`）
- 美股：2 位小数（如 `180.00`）
- A 股：2 位小数（如 `1800.00`）

---

## 6. 查询订单 — list_orders.py

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python list_orders.py
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python list_orders.py --stock 00700 --status 20 40
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python list_orders.py --status-group pending             # 快捷: 未成交
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python list_orders.py --status-group filled              # 快捷: 已成交
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python list_orders.py --status-group cancelled           # 快捷: 已撤销
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python list_orders.py --from-date 2025-01-01 --to-date 2025-01-31
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python list_orders.py --direction buy --market hk
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python list_orders.py --market sh sz                     # A 股订单
```

| 参数 | 说明 |
|------|------|
| `--stock` | 按股票代码筛选 |
| `--status` | 按状态筛选（可多个） |
| `--status-group` | 快捷状态分组（与 `--status` 互斥） |
| `--from-date` / `--to-date` | 日期范围 |
| `--direction` | `buy` / `sell` |
| `--market` | `hk` / `us` / `sh` / `sz`（可多个） |
| `--count` | 返回数量（默认 20） |

### 状态分组快捷筛选

| --status-group | 包含状态 | 说明 |
|----------------|----------|------|
| `pending` | 10, 20, 21, 40, 60 | 未成交（未报/待报/条件单待触发/已报/部成） |
| `filled` | 50 | 已成交（全部成交） |
| `cancelled` | 70, 80, 90, 100 | 已撤销（已撤/部撤/废单/已失效） |

### 订单状态枚举

| 值 | 说明 |
|----|------|
| `10` | 未报 |
| `20` | 待报 |
| `21` | 条件单-待触发 |
| `40` | 已报 |
| `50` | 全成 |
| `60` | 部成 |
| `70` | 已撤 |
| `80` | 部撤 |
| `90` | 废单 |
| `100` | 已失效 |

### 订单响应关键字段

| 字段 | 说明 |
|------|------|
| `orderId` | 订单 ID |
| `stockCode` | 股票代码 |
| `orderType` | 订单类型 (3=限价单, 9=市价单) |
| `orderStatus` | 订单状态 |
| `price` | 委托价格 |
| `quantity` | 委托数量 |
| `filledPrice` | 成交价格 |
| `filledQuantity` | 成交数量 |
| `canCancel` | 是否可撤单 (0=否, 1=是) |

---

## 7. 撤单 — cancel_order.py

> **⚠️ 重要：撤单前必须与用户二次确认！**
> 撤单同样是不可逆操作，执行前必须向用户展示待撤订单的详情（订单号、股票、方向、数量等），等待用户明确确认后才能执行。

```bash
/Users/admin/.openclaw/workspace/.venv-fosun/bin/python cancel_order.py <ORDER_ID>
```

支持港/美/A 股所有市场的订单撤销。

---

## 下单工作流（推荐步骤）

```
1. 查询行情      → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_price.py quote hk00700
2. 查看盘口      → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_price.py orderbook hk00700
3. 查询每手股数  → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 00700 --lot-size-only
4. 确认资金      → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_funds.py summary
5. 下单前校验    → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 00700 --direction buy --quantity 100 --price 350.000 --check-only
6. 提交订单      → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 00700 --direction buy --quantity 100 --price 350.000
7. 确认结果      → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python list_orders.py --stock 00700
```

**A 股下单示例：**

```
1. 查询行情      → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_price.py quote sh600519
2. 查询每手股数  → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_bidask.py --stock 600519 --market sh --lot-size-only
3. 确认资金      → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python query_funds.py summary --currency CNH
4. 下单前校验    → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 600519 --market sh --direction buy --quantity 100 --price 1800.00 --check-only
5. 提交订单      → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python place_order.py --stock 600519 --market sh --direction buy --quantity 100 --price 1800.00
6. 确认结果      → /Users/admin/.openclaw/workspace/.venv-fosun/bin/python list_orders.py --market sh
```

---

## ⛔ AI 交易限制（必须遵守）

> 通用调用频率、IP 白名单等基础限制见 `fosun-sdk-setup` skill。

### 下单频率限制

| 维度 | 限制 | 超限处理 |
|------|------|---------|
| 每小时下单次数（买卖一起） | 单个客户 ≤ 10 笔/小时 | 该小时内拒绝新委托 |
| 每日总下单次数（买卖一起） | 单个客户 ≤ 50 笔/天 | 当日拒绝新委托 |

### 美股市场

| 限制项 | 具体规则 |
|--------|---------|
| 可交易品种 | 仅开放美股正股交易 |
| 交易单位 | 1 股起买，仅支持整股，不允许碎股委托 |
| 单笔委托买入 | ≤ 10 股 且 ≤ 50 USD（市价单没有价格，只有股数限制） |
| 委托类型 | 仅支持限价单、市价单 |

### 港股市场

| 限制项 | 具体规则 |
|--------|---------|
| 交易单位 | 必须按手交易，每手股数以交易所官方定义为准 |
| 单笔委托买入 | 仅允许委托 1 手，不允许多手 且 ≤ 2000 HKD（竞价单、市价单没有价格，仅检验手数股数） |
| 委托类型 | 仅支持：港股限价单(3)、特别限价单(5)、增强限价单(4)、竞价单、竞价限价单、市价单(9) |

### A 股市场（中华通 / 港股通）

| 限制项 | 具体规则 |
|--------|---------|
| 交易单位 | 必须按手交易，每手股数以交易所官方定义为准 |
| 单笔委托买入 | 仅允许委托 1 手，不允许多手 且 ≤ 2000 CNH |
| 委托类型 | 仅支持限价单 |

> 市场代码：上交所 `sh`，深交所 `sz`。币种为 CNH（人民币），价格保留 2 位小数。

### 统一客户额度限制

| 限制项 | 具体规则 |
|--------|---------|
| 单日累计交易金额（成交 + 未完成订单总额） | 单个客户 AI 渠道买卖总和 ≤ 15000 HKD（港美A不区分） |
| 每小时下单次数（买卖一起） | 单个客户 AI 渠道 ≤ 10 笔/小时 |

## 常见错误处理

| 场景 | 处理方式 |
|------|---------|
| 鉴权过期 | SDK 自动续期，一般无需处理 |
| 资金不足 | 先用 `query_funds.py summary` 确认 |
| 价格不合法 | 先用 `query_price.py quote` 获取最新价 |
| 数量不合法 | 港股注意整手（用 `--check-only` 查 `lotSize`），美股可 1 股起 |
| 订单类型不支持 | 仅支持竞价限价单(1)、竞价单(2)、限价单(3)、增强限价单(4)、特别限价单(5)和市价单(9)，参考上方订单类型表 |

Related Skills

universal-trading

3891

from openclaw/skills

Execute cross-chain token trading on EVM and Solana with Particle Network Universal Account SDK. Use when users ask to set up universal-account-example, buy or sell tokens, run convert/swap flows, transfer assets, call custom transactions, query balances/history, or monitor transaction status via WebSocket.

Cryptocurrency & DeFi

paper-trading-plan

3891

from openclaw/skills

Generates structured paper trading plans with entry, stop loss, take profit, position size, and failure conditions for SPX, indices, and US equity options.

Trading

3891

from openclaw/skills

Trading analysis and education. Technical analysis, chart patterns, risk management, and position sizing for stocks, forex, and crypto.

trading-coach

3891

from openclaw/skills

🏆 AI交易复盘教练 — 把你的券商CSV变成可执行的改进洞察！自动FIFO配对持仓，8维度质量评分(入场/出场/趋势/风险...)，10维度AI洞察。支持富途(中/英)、老虎、中信、华泰等主流券商。触发条件: 用户提供交易CSV、要求分析交易表现、评估交易质量、生成复盘报告、计算盈亏统计、识别交易模式问题、"帮我复盘"、"分析我的交易"。

convertible-bond-trading-bot

3891

from openclaw/skills

可转债自动交易机器人，止跌企稳智能选股，上涨趋势自动高抛低吸，自带回测功能，年化收益30%+。每次调用0.01USDT。

trading-analyzer

3891

from openclaw/skills

Multi-source trading analyzer (`/drunk-trading-analyzer`) combining crypto data (TradingView), stock data (Alpha Vantage), and market intelligence (Yahoo Finance) into unified analysis reports with price trends, technical indicators, and sentiment analysis.

trading-signal

3891

from openclaw/skills

Subscribe and retrieve on-chain Smart Money signals. Monitor trading activities of smart money addresses, including buy/sell signals, trigger price, current price, max gain, and exit rate. Use this skill when users are looking for investment opportunities — smart money signals can serve as valuable references for potential trades.

DEX Agent — Direct DeFi Trading Skill

3891

from openclaw/skills

**Zero-fee DeFi trading for OpenClaw agents. Bankr alternative.**

defi-trading-engine

3891

from openclaw/skills

DeFi Trading Engine - Autonomous DeFi trading bot with self-improving review system for OpenClaw agents. Use when setting up DeFi trading, crypto trading bot, automated trading, Base chain trading, Bankr integration, trading engine, self-improving bot, or trading strategy execution.

lse-trading-agent

3891

from openclaw/skills

FTSE 350 trading analysis agent. Screens LSE stocks using technical indicators (Bollinger Bands, RSI, MACD, EMA crossovers, ATR, VWAP, OBV), fetches news for LLM sentiment analysis, synthesises signals into trade recommendations with risk management (Kelly sizing, ATR stops, drawdown circuit breakers), and backtests strategies against historical data.

polymarket-copytrading

3891

from openclaw/skills

Mirror positions from top Polymarket traders using Simmer API. Size-weighted aggregation across multiple wallets.

openmm-grid-trading

3891

from openclaw/skills

Create and manage grid trading strategies with OpenMM. Automated buy/sell around center price.