交易 API¶
回测执行语义:
order*系列 API 只负责在当前回调中提交请求,订单会在下一交易日开盘价统一撮合成交。
成交规则(A 股市场制度)¶
回测引擎默认执行以下市场制度(均可配置,见 配置 API):
- 涨跌停:
check_price_limit默认True。涨停价开盘的买单、跌停价开盘的卖单不可成交,订单取消并在Order.cancel_reason记录"limit-up"/"limit-down"。幅度按板块与日期区分(主板 ±10%、ST ±5%、创业板 2020-08-24 起 ±20%、科创板 ±20%、北交所 ±30%)。 - 停牌:停牌日(无行情或零成交)订单当日取消,
cancel_reason记录"no price data"(缺行情)/"suspended"(零成交),不顺延到复牌。 - 退市:持仓超过
delist_gap_days(默认 30 个交易日)无行情即按最后收盘价强制清算,trade_log记录DELIST_LIQUIDATE;可用delisted_position_handling="keep"改为保留持仓、delisted_liquidation_haircut模拟清算折价。 - 交易日历:以交易所日历为准(内置 2020–2026 日历,越界区间回退在线日历),不再由数据并集推断——个别股票缺数据不会让那一天从日历中消失。
order¶
按股数下单买卖。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
security |
str |
是 | 股票代码,如 '601390' |
amount |
int |
是 | 股数,正数=买入,负数=卖出 |
style |
— | 否 | MarketOrder 或 LimitOrder |
返回 Order 对象(ID 位于 order_id),无效请求返回 None。买入自动取整到 100 的整数倍。
order_value¶
按金额下单买卖。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
security |
str |
是 | 股票代码 |
value |
float |
是 | 金额,正数=买入,负数=卖出 |
style |
— | 否 | 订单类型 |
order_target¶
调整持仓到目标股数。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
security |
str |
是 | 股票代码 |
amount |
int |
是 | 目标持仓股数,0 = 清仓 |
style |
— | 否 | 订单类型 |
order_target_value¶
调整持仓到目标市值。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
security |
str |
是 | 股票代码 |
value |
float |
是 | 目标市值,0 = 清仓 |
style |
— | 否 | 订单类型 |
order_lots¶
按手数下单买卖(A 股 1 手 = 100 股)。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
security |
str |
是 | 股票代码 |
lots |
int |
是 | 手数,正数=买入,负数=卖出 |
style |
— | 否 | 订单类型 |
order_pct¶
按可用资金的百分比下单。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
security |
str |
是 | 股票代码 |
pct |
float |
是 | 资金比例,如 0.5 = 50% 可用资金买入;-0.3 = 卖出当前持仓 30% |
style |
— | 否 | 订单类型 |
手续费说明¶
通过 set_order_cost() 修改(见配置 API)。默认:买入印花税 0%、卖出印花税 0.05%(2023-08-28 起减半)、买卖佣金 0.025%、最低佣金 5 元。OrderCost.close_tax 默认为 None,即按法定税率日期感知:2023-08-28 起 0.05%,此前 0.1%——跨 2023-08-28 的长历史回测无需手动处理;显式传入数值则始终覆盖。
成交、状态和代码规则¶
限价约束作用于含滑点的最终成交价;不满足限价的订单继续等待。同一证券同一交易日的买卖共用成交量预算,拆单或多次撮合不会增加预算;当日无法成交的待单会保留。首次建仓保留传入的代码格式,兼容已有的持仓字典访问方式;后续使用裸代码或带后缀代码下单,均匹配同一已有持仓。
cancel_order(order_obj) 可取消部分成交订单的未成交部分,保留成交记录并进入 cancelled。is_complete() 仅在状态为 filled 时返回 True。金额和目标订单在首次撮合解析股数前,remaining_amount() 返回 None;之后返回最近一次解析的剩余股数,目标金额对应股数可能随报价改变。卖出比例按现有持仓股数计算,order_pct(code, -1) 表示全部清仓请求。
持仓缺少有效报价时沿用上一有效估值价,Position.price_stale=True;收到新报价后恢复为 False。缺行情本身不会使持仓退回成本价。