| 市场 |
品类 |
市场状态 |
时间段（当地时间） |
| 香港市场 |
证券类产品（含股票、ETFs、窝轮、牛熊、界内证） |
* NONE：无交易 |
CST 08:55 - 09:00 |
| * AUCTION：盘前竞价 |
CST 09:00 - 09:20 |
| * WAITING_OPEN：等待开盘 |
CST 09:20 - 09:30 |
| * MORNING：早盘 |
CST 09:30 - 12:00 |
| * REST: 午间休市 |
CST 12:00 - 13:00 |
| * AFTERNOON：午盘 |
CST 13:00 - 16:00 |
| * HK_CAS：港股盘后竞价（港股市场增加 CAS 机制对应的市场状态） |
CST 16:00 - 16:08 |
| * CLOSED：收盘 |
CST 16:08 - 08:55（T+1） |
| 期权、期货（仅日市） |
* NONE：期权待开盘 |
CST 08:55 - 09:30 |
| * MORNING：早盘 |
CST 09:30 - 12:00 |
| * REST: 午间休市 |
CST 12:00 - 13:00 |
| * AFTERNOON：午盘 |
CST 13:00 - 16:00 |
| * CLOSED：收盘 |
CST 16:00 - 08:55（T+1） |
| 期货（日夜市） |
* FUTURE_DAY_WAIT_FOR_OPEN：期货待开盘 |
不同品种交易时间不同 |
| * NIGHT_OPEN: 夜市交易时段 |
| * NIGHT_END：夜市收盘 |
| * FUTURE_DAY_WAIT_FOR_OPEN：期货待开盘 |
| * FUTURE_DAY_OPEN：日市交易时段 |
| * FUTURE_DAY_CLOSE：日市收盘 |
| 美国市场 |
证券类产品（含股票、ETFs） |
* PRE_MARKET_BEGIN：美股盘前交易时段 |
EST 04:00 - 09:30 |
| * AFTERNOON：美股持续交易时段 |
EST 09:30 - 16:00 |
| * AFTER_HOURS_BEGIN：美股盘后交易时段 |
EST 16:00 - 20:00 |
| * AFTER_HOURS_END：美股盘后收盘 |
EST 20:00 - 04:00（T+1） |
| * OVERNIGHT：美股夜盘交易时段 |
EST 20:00 - 04:00（T+1） |
| 期权 |
* NONE：期权待开盘 |
不同品种交易时间不同 |
| * REST：美指期权午间休市 |
| * AFTERNOON：美股持续交易时段 |
| * TRADE_AT_LAST：美指期权盘尾交易时段 |
| * NIGHT：美指期权夜市交易时段 |
| * CLOSED：收盘 |
| 期货 |
* FUTURE_SWITCH_DATE：美期待开盘 |
不同品种交易时间不同 |
| * FUTURE_OPEN：美期交易时段 |
| * FUTURE_BREAK：美期中盘休息 |
| * FUTRUE_BREAK_OVER：美期休息后交易时段 |
| * FUTURE_CLOSE：美期收盘 |
| A股市场 |
证券类产品（含股票、ETFs） |
* NONE：无交易 |
CST 08:55 - 09:15 |
| * Auction：盘前竞价 |
CST 09:15 - 09:25 |
| * WAITING_OPEN：等待开盘 |
CST 09:25 - 09:30 |
| * MORNING：早盘 |
CST 09:30 - 11:30 |
| * REST：午间休市 |
CST 11:30 - 13:00 |
| * AFTERNOON：午盘 |
CST 13:00 - 15:00 |
| * CLOSED：收盘 |
CST 15:00 - 08:55（T+1） |
| 新加坡市场 |
期货 |
* FUTURE_DAY_WAIT_FOR_OPEN：期货待开盘 |
不同品种交易时间不同 |
| * NIGHT_OPEN：夜市交易时段 |
| * NIGHT_END：夜市收盘 |
| * FUTURE_DAY_OPEN：日市交易时段 |
| * FUTURE_DAY_CLOSE：日市收盘 |
| 日本市场 |
期货 |
* FUTURE_DAY_WAIT_FOR_OPEN：期货待开盘 |
JST 16:25（T-1）- 16:30（T-1） |
| * NIGHT_OPEN：夜市交易时段 |
JST 16:30（T-1） - 05:30 |
| * NIGHT_END：夜市收盘 |
JST 05:30 - 08:45 |
| * FUTURE_DAY_OPEN：日市交易时段 |
JST 08:45 - 15:15 |
| * FUTURE_DAY_CLOSE：日市收盘 |
JST 15:15 - 16:25 |
| 加密货币市场 |
加密货币 |
* NONE：未交易 |
不同币对可交易时间不同 |
| * MORNING：早盘 |
| * CLOSED：收盘 |
\* CST, EST, JST 分别表示中国时间，美东时间，日本时间
## Q15：接口参数股票代码的格式
A：
* 使用不同编程语言的用户，需要的股票代码的格式不同：
* **Python 用户**
标的代码 code 使用 `exchange_market.symbol`格式，`exchange_market`表示交易所市场，`symbol`表示标的代码。支持订阅的标的如下：
| 市场 |
标的类别 |
exchange_market |
example |
| 香港市场 |
证券类产品（含股票、ETFs、窝轮、牛熊、界内证） |
HK |
腾讯控股：HK.00700 |
| 指数 |
HK |
恒生指数：HK.800000 |
| 期货 |
HK |
恒指期货2606：HK.HSI2606 |
| 期权 |
HK |
* 股票期权 腾讯 260330 450.00购：HK.TCH260330C450000
* 指数期权 恒指 260330 24000.00购：HK.HSI260330C24000000 |
| 板块 (建议使用 get_plate_list 先获取板块列表) |
HK |
AI应用股：HK.LIST24037 |
| 美国市场 |
证券类产品（含纽交所、美交所、纳斯达克上市的股票、ETFs） |
US |
英伟达：US.NVDA |
| 期权 |
US |
* 股票期权 NVDA 260330 160.00C：US.NVDA260330C160000
* 指数期权 SPXW 260330 6330.00C: US..SPXW260330C6330000 |
| 期货 |
US |
标普500指数期货2606：US.ES2606 |
| 板块 (建议使用 get_plate_list 先获取板块列表) |
US |
半导体精选：US.LIST20077 |
| 指数（暂不支持获取） |
US |
标普500指数：US..SPX |
| A股市场 |
证券类产品（含股票、ETFs） |
SH/SZ |
贵州茅台：SH.600519 |
| 指数 |
SH/SZ |
上证指数：SH.000001 |
| 板块 (建议使用 get_plate_list 先获取板块列表) |
SH/SZ |
汽车电子概念：SH.LIST0301 |
| 新加坡市场 |
期货（暂不支持获取） |
SG |
A50指数期货2606：SG.CN2606 |
| 日本市场 |
期货（暂不支持获取） |
JP |
大阪日经指数期货2606：JP.NK2252606 |
| 加密货币市场 |
加密货币指数及币对 |
CC |
* 指数：CC.BTC
* 可交易币对: CC.BTCUSD |
* **非 Python 用户**
股票结构参见 [Security](../quote/quote.html#1377)。
例如：腾讯控股，参数 market 传入 QotMarket_HK_Security，参数 code 传入'00700'。
* 查询方式：
通过 APP 查看代码和行情市场：行情 > 自选 > 全部。
行情市场定义，请参考 [这里](../quote/quote.html#427)。
## Q16：复权因子相关
A：
### 概述
所谓 [复权](../quote/get-rehab.html#770) 就是对股价和成交量进行权息修复，按照股票的实际涨跌绘制股价走势图，并把成交量调整为相同的股本口径。
公司行动（如：拆股、合股、送股、转增股、配股、增发股、分红）均可能对股价产生影响，而复权计算可对量价进行调整，剔除公司行动的影响，保持股价走势的连续性。
### 名词解释
- 公司行动：上市公司进行一些股权、股票等影响公司股价和股东持仓变化的行为。
- 前复权：保持现有的股价不变，以当前的股价为基准，对以前的股价进行复权计算。
- 后复权：保持先前的股价不变，以过去的股价为基准，对以后的股价进行复权计算。
- 复权因子：即权息修复比例，用于计算复权后的价格及持仓数量。
- 除权除息日：即股权登记日下一个交易日。在股票的除权除息日，证券交易所都要计算出股票的除权除息价，以作为股民在除权除息日开盘的参考。其意义是股票股利分配给股东的日期。
### 复权方法
主流的复权计算方法分为两种：事件法和连乘法；而 Futu API 针对不同市场使用不同的计算方法。
- 事件复权法：通过还原除权除息的各类事件进行复权；存在两个复权因子（复权因子 A 和 复权因子 B），复权因子 B 主要调整现金分红对股价的影响，而复权因子 A 调整其他公司行动对股价的影响。
- 连乘复权法：通过复权因子连乘的方式进行复权，只保留 复权因子 A（或将 复权因子 B 置为0），复权因子 A 为 除权除息日前收盘价/该日经权息调整后的前收盘价。
::: tip 提示
* API 对美股前复权使用连乘法，即将 复权因子 B 置为0。
* API 对除美股以外的标的（A股、港股、新加坡股票等）及美股后复权使用事件法。
:::
### 计算公式
#### 单次复权
- 前复权：
前复权价格 = 不复权价格 × 前复权因子 A + 前复权因子 B
- 后复权：
后复权价格 = 不复权价格 × 后复权因子 A + 后复权因子 B
#### 多次复权
- 前复权：按照时间顺序，筛选出大于计算日期的复权因子，优先使用时间较早的复权因子进行复权计算。以两次复权为例：
- 后复权：按照时间倒序，筛选出小于等于计算日期的复权因子，优先使用时间较晚的复权因子进行复权计算。以两次复权为例：
### 示例
#### 单次前复权示例
以牧原股份为例：
- 筛选复权因子如下：
除权除息日|股票代码|方案说明|前复权因子 A |前复权因子 B
:-|:-|:-|:-|:-
2021/06/03|SZ.002714|10转4.0股派14.61元（含税）|0.71429|-1.04357
- 不复权数据如下：
日期|股票代码|不复权收盘价
:-|:-|:-
2021/06/02|SZ.002714|93.11
2021/06/03|SZ.002714|66.25
- 前复权数据如下：
日期|股票代码|前复权收盘价
:-|:-|:-
2021/06/02|SZ.002714|65.4639719
2021/06/03|SZ.002714|66.25
- 前复权数据计算方法：
牧原股份在 2021/06/03 进行拆股及现金分红行动（10转4.0股派14.61元），根据前复权计算公式对 2021/06/02 的收盘价进行调整计算，则：前复权价格（65.4639719） = 不复权价格（93.11） × 前复权因子 A（0.71429） + 前复权因子 B（-1.04357）
#### 多次后复权示例
接上一个例子，计算牧原股份在 2021/06/02 的后复权价格：
- 筛选复权因子如下：
除权除息日|股票代码|方案说明|后复权因子 A |后复权因子 B
:-|:-|:-|:-|:-|
2014/07/04|SZ.002714|10派2.34元（含税）|1|0.234
2015-06-10|SZ.002714|10转10.0股派0.61元（含税）|2|0.061
2016-07-08|SZ.002714|10转10.0股派3.53元（含税）|2|0.353
2017-07-11|SZ.002714|10转8.0股派6.9元（含税）|1.8|0.69
2018-07-03|SZ.002714|10派6.91元（含税）|1|0.691
2019-07-04|SZ.002714|10派0.5元（含税）|1|0.05
2020-06-04|SZ.002714|10转7.0股派5.5元（含税）|1.7|0.55
- 不复权数据如下：
日期|股票代码|不复权收盘价
:-|:-|:-
2021/06/02|SZ.002714|93.11
- 后复权数据如下：
日期|股票代码|后复权收盘价
:-|:-|:-
2021/06/02|SZ.002714|1152.7226
- 后复权数据计算方法：
为了计算牧原股份在 2021/06/02 的后复权价格，需要将早于 2021/06/02 的复权事件进行一一复权，得到最后的后复权价格，具体计算如下：
## Q17：加密货币多券商行情相关
#### 1. 为什么加密货币行情会因券商不同而有所差异？
A：由于各券商对接的行情上游不同，同一币对在不同券商下可能存在行情数据差异。API支持根据券商切换行情数据源（OpenQuoteContext 指定 security_firm），确保您看到的行情与实际交易一致。
#### 2. 如果我没有指定券商，会展示哪个数据源的行情？
A：未指定券商时，API默认返回您的主推券商行情上游数据。
#### 3. 我有多个券商账户都支持加密货币交易，应该如何选择？
A：建议选择您实际交易账户所对应的券商来获取行情。这样可以确保所见行情与下单时的撮合价格一致，避免因行情数据源不同导致的价格偏差。
---
---
# 交易相关
## Q1：模拟交易相关
A:
### 概述
模拟交易是在真实的市场环境中，用虚拟资金做交易，不会对您的真实账户的资产造成影响。
#### 交易时间
模拟交易支持的时段：常规交易时段（所有市场）、美股盘中时段、美股盘前盘后时段（仅美股融资融券模拟账户支持）
模拟交易不支持的时段：美股夜盘时段、A股竞价时段、港股竞价时段
详情可点击 [模拟交易规则](https://support.futunn.com/topic692)
#### 支持品类
Futu API 支持模拟交易的品类请参考 [这里](../intro/intro.md#1396)。
#### 解锁
与真实交易不同，模拟交易无需对账户进行解锁，即可下单或改单撤单。
#### 订单
1. 订单类型：限价单和市价单。
2. 改单操作类型：模拟交易不支持使生效、使失效、删除，仅支持修改订单、 撤单。
3. 成交：模拟交易不支持成交相关操作，包括 [查询今日成交](../trade/get-order-fill-list.md#2621)、[查询历史成交](../trade/get-history-order-fill-list.md#9015)、[响应成交推送回调](../trade/update-order-fill.md#210)。
4. 有效期限：模拟交易有效期限仅支持当日有效。
5. 卖空：期权和期货支持卖空。股票仅美股支持卖空。
6. 模拟交易账户不支持查询订单费用。
7. 模拟交易账户不支持查询现金流水。
8. 在组合期权订单场景下，支持持仓查询，暂不支持组合订单查询。
#### 操作平台
1. 移动端：我的 — 模拟交易
2. 桌面端：左侧模拟 tab
3. 网页端：[模拟交易界面](https://m-match.futunn.com/simulate/)
4. Futu API：在调用接口时，设置参数交易环境为模拟环境即可。详见 [如何使用 Futu API 进行模拟交易](../qa/trade.md#8728)。
::: tip 提示
* 以上四种方式只是操作平台不同，四种方式操作的模拟账户是共通的。
:::
### 如何使用 Futu API 进行模拟交易？
#### 创建连接
先根据交易品种 [创建相应的连接](../trade/base.md#7902) 。当交易品种是股票或期权时，请使用 `OpenSecTradeContext`。当交易品种是期货时，请使用 `OpenFutureTradeContext`。
#### 获取交易业务账户列表
使用 [获取交易业务账户列表](../trade/get-acc-list.md#5754) 查看交易账户（包括模拟账户、真实账户）。以 Python 为例：返回字段交易环境 `trd_env` 为 `SIMULATE`，表示模拟账户。
获取港股模拟交易账户，需要指定 filter_trdmarket 为 TrdMarket.HK，此时会返回2个模拟交易账号。其中 sim_acc_type = STOCK 为港股模拟账户，sim_acc_type = OPTION 为港股期权模拟账户，sim_acc_type = FUTURES 为港股期货模拟账户。
获取美股模拟交易账户，需要指定 filter_trdmarket 为 TrdMarket.US，sim_acc_type = STOCK_AND_OPTION 代表美股融资融券模拟账户，可以模拟交易股票和期权。sim_acc_type = FUTURES 为美国期货模拟账户。
* **Example：Stocks and Options**
```python
from futu import *
trd_ctx = OpenSecTradeContext(filter_trdmarket=TrdMarket.HK, host='127.0.0.1', port=11111, security_firm=SecurityFirm.FUTUSECURITIES)
#trd_ctx = OpenFutureTradeContext(host='127.0.0.1', port=11111, is_encrypt=None, security_firm=SecurityFirm.FUTUSECURITIES)
ret, data = trd_ctx.get_acc_list()
if ret == RET_OK:
print(data)
print(data['acc_id'][0]) # get the first account id
print(data['acc_id'].values.tolist()) # convert to list format
else:
print('get_acc_list error: ', data)
trd_ctx.close()
```
* **Output**
```python
acc_id trd_env acc_type card_num security_firm \
0 281756480572583411 REAL MARGIN 1001318721909873 FUTUSECURITIES
1 9053218 SIMULATE CASH N/A N/A
2 9048221 SIMULATE MARGIN N/A N/A
sim_acc_type trdmarket_auth
0 N/A [HK, US, HKCC]
1 STOCK [HK]
2 OPTION [HK]
```
::: tip 提示
* 模拟交易中，区分股票账户和期权账户，股票账户只能交易股票，期权账户只能交易期权；以 Python 为例：返回字段中模拟账户类型 `sim_acc_type` 为 `STOCK`，表示股票账户；为`OPTION`，表示期权账户。
:::
* **Example: Futures**
```python
from futu import *
#trd_ctx = OpenSecTradeContext(filter_trdmarket=TrdMarket.HK, host='127.0.0.1', port=11111, security_firm=SecurityFirm.FUTUSECURITIES)
trd_ctx = OpenFutureTradeContext(host='127.0.0.1', port=11111, is_encrypt=None, security_firm=SecurityFirm.FUTUSECURITIES)
ret, data = trd_ctx.get_acc_list()
if ret == RET_OK:
print(data)
print(data['acc_id'][0]) # get the first account id
print(data['acc_id'].values.tolist()) # convert to list format
else:
print('get_acc_list error: ', data)
trd_ctx.close()
```
* **Output**
```python
acc_id trd_env acc_type card_num security_firm sim_acc_type \
0 9497808 SIMULATE MARGIN N/A N/A FUTURES
1 9497809 SIMULATE MARGIN N/A N/A FUTURES
2 9497810 SIMULATE MARGIN N/A N/A FUTURES
3 9497811 SIMULATE MARGIN N/A N/A FUTURES
trdmarket_auth
0 [FUTURES_SIMULATE_HK]
1 [FUTURES_SIMULATE_US]
2 [FUTURES_SIMULATE_SG]
3 [FUTURES_SIMULATE_JP]
```
#### 下单
使用 [下单接口](../trade/place-order.md) 时，设置交易环境为模拟环境即可。以 Python 为例：`trd_env = TrdEnv.SIMULATE`。
* **Example**
```python
from futu import *
trd_ctx = OpenSecTradeContext(filter_trdmarket=TrdMarket.HK, host='127.0.0.1', port=11111, security_firm=SecurityFirm.FUTUSECURITIES)
ret, data = trd_ctx.place_order(price=510.0, qty=100, code="HK.00700", trd_side=TrdSide.BUY, trd_env=TrdEnv.SIMULATE)
if ret == RET_OK:
print(data)
else:
print('place_order error: ', data)
trd_ctx.close()
```
* **Output**
```python
code stock_name trd_side order_type order_status order_id qty price create_time updated_time dealt_qty dealt_avg_price last_err_msg remark time_in_force fill_outside_rth
0 HK.00700 腾讯控股 BUY NORMAL SUBMITTING 4642000476506964749 100.0 510.0 2021-10-09 11:34:54 2021-10-09 11:34:54 0.0 0.0 DAY N/A
```
#### 撤单改单
使用 [撤单接口](../trade/modify-order.md) 时，设置交易环境为模拟环境即可。以 Python 为例： `trd_env = TrdEnv.SIMULATE`。
* **Example**
```python
from futu import *
trd_ctx = OpenSecTradeContext(filter_trdmarket=TrdMarket.HK, host='127.0.0.1', port=11111, security_firm=SecurityFirm.FUTUSECURITIES)
order_id = "4642000476506964749"
ret, data = trd_ctx.modify_order(ModifyOrderOp.CANCEL, order_id, 0, 0, trd_env=TrdEnv.SIMULATE)
if ret == RET_OK:
print(data)
else:
print('modify_order error: ', data)
trd_ctx.close()
```
* **Output**
```python
trd_env order_id
0 SIMULATE 4642000476506964749
```
#### 查询历史订单
使用 [查询历史订单接口](../trade/get-history-order-list.md) 时，设置交易环境为模拟环境即可。以 Python 为例：`trd_env = TrdEnv.SIMULATE`。
* **Example**
```python
from futu import *
trd_ctx = OpenSecTradeContext(filter_trdmarket=TrdMarket.HK, host='127.0.0.1', port=11111, security_firm=SecurityFirm.FUTUSECURITIES)
ret, data = trd_ctx.history_order_list_query(trd_env=TrdEnv.SIMULATE)
if ret == RET_OK:
print(data)
else:
print('history_order_list_query error: ', data)
trd_ctx.close()
```
* **Output**
```python
code stock_name trd_side order_type order_status order_id qty price create_time updated_time dealt_qty dealt_avg_price last_err_msg remark time_in_force fill_outside_rth
0 HK.00700 腾讯控股 BUY ABSOLUTE_LIMIT CANCELLED_ALL 4642000476506964749 100.0 510.0 2021-10-09 11:34:54 2021-10-09 11:37:08 0.0 0.0 DAY N/A
```
### 如何重置模拟账户？
目前 Futu API 不支持重置模拟账户，您可在移动端使用复活卡重置指定模拟账户，重置后账户资金将恢复至初始值，历史订单将会被清空。
#### 具体操作
移动端：我的 — 模拟交易 — 我的头像 — 我的道具 — 复活卡。
## Q2：是否支持 A 股交易？
A: 模拟交易支持 A 股交易。但真实交易仅可通过 A 股通交易部分 A 股，具体详见 [A 股通名单](https://www.hkex.com.hk/Mutual-Market/Stock-Connect/Eligible-Stocks/View-All-Eligible-Securities?sc_lang=zh-HK)。
## Q3：各市场支持的交易方向
A: 除了期货，其他股票都只支持传入 BUY 和 SELL 两个交易方向。在空仓情况下传入 SELL，产生的订单交易方向是卖空。
## Q4：真实交易中，各市场支持的订单类型
A: