通盈策略助手除公式指标外,还提供完整的 Python 编写体系:既可编写 Python 策略(自动交易系统),也可编写 Python 指标。所有平台能力封装在内置模块 Ty 中,import Ty 后以 Ty.xxx(...) 调用;用户可自行安装任意 Python 库(如 NumPy、pandas),并在「全局设置」中指定 Python 路径。本文依据官方《通盈策略助手 Python 函数文档》整理,覆盖 9 个分类、235 个条目:程序结构与回调事件、账户与品种、市场数据、交易下单、工具函数与常量,并附 4 个可直接使用的示例代码。
适用范围:通盈策略助手桌面客户端(软件说明书 5.0 对应版本)。文中函数签名、参数、返回字段与备注均取自官方 Python 函数文档;标注「仅指标」的条目只能用于 Python 指标,不能用于 Python 策略。
一、Python 策略与 Python 指标的分工
两种形态共用同一套 Ty 模块,但可用函数与运行方式不同,编写前需先确定目标形态。
| 对比项 |
Python 策略 |
Python 指标 |
| 用途 |
自动交易系统:行情判断、下单与仓位管理 |
在图表上输出自定义指标曲线 |
| 文件头 |
import Ty |
以 #property 起始,再 import Ty |
| 入口 |
OnInit / OnTick / OnTimer / OnTrade / OnOrder / OnDeinit |
InitSeries() + OnCalculate(...) |
| 输出 |
日志、状态面板、下单指令 |
在 InitSeries() 声明序列,在 OnCalculate 填充数值 |
| 参数 |
extern 变量名 = 初值 |
同左 |
| 能力边界 |
不可使用 Indc* 系列函数 |
仅可使用 IndcGetPeriod / IndcGetSymbolID / IndcGetSymbolInfo / IndcLog,不可调用交易接口 |
不可混用:IndcGetPeriod、IndcGetSymbolID、IndcGetSymbolInfo、IndcLog 以及 InitSeries、OnCalculate 只能用于 Python 指标;而 OpenPosition 等交易接口只能用于 Python 策略。Python 指标中调用交易函数、Python 策略中调用指标专用函数均不会生效。
二、新建、检测与运行
1. Python 策略
- 菜单栏「交易系统」→「公式代码管理器」→ 点击「Python 策略」→ 右键菜单选择「新建 Python 策略」。
- 命名后双击打开,粘贴策略代码,点击检测语法无误后保存。
- 在「策略列表」中找到该策略(未出现可右键刷新),双击可修改策略参数。
- 策略右键菜单「历史回测」用于验证盈利表现;点击启动后,策略会自动下载数据并开始运行。
2. Python 指标
- 菜单栏「交易系统」→「公式代码管理器」→ 点击「Python 指标」→ 右键菜单选择「新建 Python 指标」。
- 命名后双击打开,粘贴指标代码,检测语法无误后保存。
- 菜单栏「技术指标」→「Python 指标」,选中新建的指标即可加载到当前图表。
三、程序结构与回调事件
Python 脚本由客户端事件循环驱动,没有 main 入口,也不需要编写 if __name__ == '__main__'。跨回调的状态需使用模块级变量并在函数内以 global 声明后保存。
| 回调 |
触发时机 |
典型用途 |
OnInit() |
策略启动时调用一次 |
获取账户句柄、品种 ID、初始化 K 线与指标句柄、初始化变量 |
OnTick(tick) |
品种价格变动时 |
行情驱动的主逻辑 |
OnTimer() |
定时触发(需 EventSetTimer 激活) |
轮询式逻辑、状态刷新 |
OnTrade(trade) |
有成交发生时 |
成交记录、后续仓位处理 |
OnOrder(order) |
订单状态变化时 |
委托状态跟踪 |
OnDeinit() |
策略停止时 |
释放定时器等资源清理 |
回调参数的数据结构
| 参数 |
主要字段 |
tick |
symbol_id bid ask last last_size day_volume |
trade |
symbol_id symbol_name account account_handle trade_id system_id side offset time filled_price lots ref strg_id system_id_toclose commission order_price order_time mkt_price |
order |
symbol_id symbol_name account account_handle system_id order_id side offset order_type tif total_lots remain_lots create_time update_time order_price mkt_price status statusmsg strg_id ref system_id_toclose |
订单状态 status 常见取值:未成交、部分成交、全部成交、待提交、已撤单、未触发、已触发、错误、准备提交、待取消、未知状态。
四、参数声明 extern 与指标属性 #property
1. extern:声明策略参数
在模块顶层写作 extern 变量名 = 初值,该变量会出现在软件参数面板中,可在不修改代码的前提下调整数值。
extern symbol_name = "ag2601"
extern period = Ty.PERIOD_M5
extern open_lots = 1
2. #property:声明指标属性
Python 指标必须以 #property 起始行声明属性:
| 属性 |
说明 |
#property indicator_chart_window |
指标在主图显示 |
#property indicator_separate_window |
指标在副图显示 |
#property indicator_desc 文字 |
指标的描述文字 |
3. InitSeries:定义输出序列
InitSeries() 返回序列信息列表,支持简写与详细配置两种形式:
# 简写:仅指定名称,其余属性取默认值
def InitSeries():
return ['MA5', 'MA10']
# 详细配置:可指定颜色、画线类型、线型、线宽等
def InitSeries():
top = {'name': 'TOP', 'color': Ty.clrBlue, 'series_type': Ty.DRAW_TYPE_HISTOGRAM}
return [top]
| 字段 |
说明 |
name |
序列名称,必填,同一指标内不可重复 |
color |
默认颜色,如 Ty.clrRed;若设置了 up/down_color 则忽略该字段 |
up_color / down_color |
上涨 / 下跌颜色,未设定时由系统自动分配 |
series_type |
画线类型:DRAW_TYPE_NONE / LINE / HISTOGRAM / POINTS / CANDLES,默认 LINE |
line_style |
线型:LINE_STYLE_SOLID / DASH / DOT / DASHDOT / DASHDOTDOT,默认 SOLID |
line_width |
线宽,默认 1 |
line_breakable |
线状图是否可断开,默认 0 |
4. OnCalculate:指标计算逻辑
支持三种签名形式,按需选用:
def OnCalculate(prev_calculated, rates_total, series_data): ...
def OnCalculate(prev_calculated, rates_total, series_data, rates): ...
def OnCalculate(prev_calculated, rates_total, series_data, rates, series_color): ...
| 参数 |
说明 |
prev_calculated |
上一次计算时返回的已计算 K 线数量,用于增量计算 |
rates_total |
当前 K 线数据总数量 |
series_data |
输出序列字典,Key 为序列名称、Value 为价格列表;蜡烛图序列的 Value 为 {open[], high[], low[], close[]} |
rates |
行情数据字典,含 open[] high[] low[] close[] volume[] opi[] |
series_color |
序列颜色字典,Key 为序列名称、Value 为颜色值列表 |
返回值通常为 rates_total,表示本次计算完成的 K 线数量。
五、API 总览:9 大类 235 个条目
| 分类 |
数量 |
代表条目 |
用途 |
| 常量 |
177 |
PERIOD_M5 PRICE_CLOSE BUY/SELL DRAW_TYPE_LINE clrRed |
周期、价格类型、方向、画线类型、颜色等 |
| 普通函数 |
14 |
StrgLog StrgStatus Alert EventSetTimer CurrentTime |
日志、状态、提醒、定时器、开关 |
| 交易函数 |
12 |
OpenPosition ClosePosition GetPositions OrderModify |
持仓查询、下单、改单、撤单 |
| 市场数据函数 |
11 |
InitSymbolRates CopyRates InitIndicator CopyBuffer |
K 线数据与内置指标取值 |
| Python 指标 |
7 |
#property InitSeries OnCalculate IndcGetSymbolInfo |
仅指标可用 |
| 策略回调事件 |
6 |
OnInit OnTick OnTimer OnTrade OnOrder OnDeinit |
策略生命周期与事件入口 |
| 品种信息函数 |
5 |
GetSymbols GetSymbolID GetSymbolQuotes |
品种查询与实时报价 |
| 账户函数 |
2 |
GetTradeAccount GetFunding |
账户句柄与资金 |
| 特殊标识 |
1 |
extern |
声明策略参数 |
六、账户与品种信息
1. 账户函数
| 函数 |
说明 |
Ty.GetTradeAccount(acct_code, acct_type="") |
获取已登录账户句柄,未登录返回 0。acct_type 可选值:期货CTP / 盈透 / 币安合约 / 币安现货 / A股 / 欧易 等 |
Ty.GetFunding(acct_handle) |
获取账户资金,返回字典 account balance(静态余额) equity(动态净值) margin available commission profit |
账户句柄是所有交易接口的前置参数。账户需先登录才能取得有效句柄,建议取到后存入全局变量,并在每次交易前判断其是否大于 0。
2. 品种信息函数
| 函数 |
说明 |
Ty.GetSymbols() |
获取自选列表中所有品种信息字典 |
Ty.GetSymbolID(symbol_name, mkt_type="", currency="") |
按名称取品种 ID,失败返回 0;同名品种需指定市场类型或货币区分 |
Ty.GetSymbolInfoByName(symbol_name, mkt_type="", currency="") |
按名称取品种信息字典 |
Ty.GetSymbolInfoByID(symbol_id) |
按 ID 取品种信息字典 |
Ty.GetSymbolQuotes(symbol_id) |
获取实时报价:bid bid_size ask ask_size last last_size day_volume market_price open 等 |
品种字典主要字段
symbol_id(品种 ID)、market_type(市场类型)、symbol_name(品种代码)、symbol_type(品种名)、full_name(品种全名)、exchange(交易所)、sec_type(品种类型)、contract_month(合约到期月份)、currency(报价货币)、precision(价格精度)、contract_multiplier(合约乘数)、price_tick(最小变动价位)、commission(佣金)、margin_rate / short_margin_rate(保证金率)。
下单前的两个必取字段:precision 用于委托价格舍入(round(price, precision)),price_tick 用于判断价格是否需要改单(差值大于一个最小变动价位才发起 OrderModify,可避免频繁改单)。
七、市场数据:K 线与内置指标
1. 调用时序
OnInit 中调用 Ty.InitSymbolRates(symbol_id, timeframe) 初始化 K 线数据。
OnInit 中调用 Ty.InitIndicator(...) 取得指标句柄。
OnTick / OnTimer 中调用 CopyRates、CopyClose、CopyBuffer 等取值。
两条硬性约束:① 未调用 InitSymbolRates 就取 K 线数据会失败;② CopyBuffer 只能在 OnTick / OnTimer 等事件中调用,不能在 OnInit 中读取。
2. 市场数据函数
| 函数 |
说明 |
Ty.InitSymbolRates(symbol_id, timeframe) |
初始化 K 线数据,必须在 OnInit 调用,成功返回 True |
Ty.CopyRates(symbol_id, timeframe, count, startpos=0, fromTime=0, toTime=0, bTimeAsc=False) |
取 K 线列表 [{open, high, low, close, time, volume, opi}] |
Ty.CopyOpen / CopyClose / CopyHigh / CopyLow |
取开 / 收 / 高 / 低 价序列 |
Ty.CopyVolume / CopyOpi |
取成交量 / 持仓量序列 |
Ty.CopyTime(...) |
取 K 线开盘时间(时间戳)序列 |
Ty.InitIndicator(indic_name, symbol_id, timeframe, price_type, params) |
初始化内置指标,返回句柄,失败返回 0;必须在 OnInit 调用 |
Ty.CopyBuffer(indic_handle, buffer_number, count, startpos=0, ...) |
取指标指定数据序列的值;只能在 OnTick / OnTimer 调用 |
关于 bTimeAsc:默认 False,即返回序列按时间倒序,下标 0 为当前 K 线;设为 True 则按时间升序。startpos 为起始位置偏移(0 表示从当前 K 线起算)。
3. 内置指标名称与默认参数
InitIndicator 的 indic_name 与 params 需与软件中显示的指标名称、参数列表一致。常用指标如下:
| 指标 |
默认参数 |
说明 |
MA / EMA / WMA |
[20] |
简单 / 指数 / 加权移动平均 |
KAMA |
[10] |
考夫曼自适应均线 |
MAMA |
[0.5, 0.05] |
梅萨自适应均线 |
DMI |
[14] |
趋向指标 |
W_R |
[14] |
威廉百分比指标 |
ATR |
[14] |
真实波幅指标 |
BOLL |
[0, 20, 2] |
布林线指标(缓冲区 0/1/2 分别为上轨、中轨、下轨) |
MACD |
[12, 26, 9] |
指数平滑异动指标 |
RSI |
[7, 14] |
相对强弱指标 |
STOCH |
[5, 3, 3] |
随机指标 |
SAR |
[0.02, 0.2] |
抛物线指标 |
ZIGZAG |
[9] |
之字转向指标(属未来函数,谨慎用于信号) |
均线类指标的 maType 取值:0 = Ty.MATYPE_SMA、1 = Ty.MATYPE_EMA、2 = Ty.MATYPE_WMA;price_type 可用 Ty.PRICE_CLOSE / PRICE_OPEN / PRICE_HIGH / PRICE_LOW,等价字符串写法为 "close" / "open" / "high" / "low"。
八、交易函数:查询与下单
1. 查询类
| 函数 |
说明 |
Ty.GetPositions(acct_handle, symbol_id=0) |
当前持仓列表;symbol_id=0 返回所有品种 |
Ty.GetPositionBySystemId(acct_handle, system_id) |
按系统编号取单笔持仓 |
Ty.GetPendingOrders(acct_handle, symbol_id=0) |
未成交挂单列表 |
Ty.GetHistoryOrders(acct_handle, symbol_id=0, count=0, fromTime=0, toTime=0) |
历史委托列表 |
Ty.GetHistoryTrades(...) |
历史成交列表 |
Ty.GetHistoryPositions(...) |
历史持仓列表,仅返回已完全平仓的记录 |
持仓字典主要字段:symbol_id symbol_name account account_handle system_id lots side open_time open_price profit margin high low strg_id ref mkt_price takeprofit stoploss。
历史数据查询的时间参数:fromTime / toTime 为 Unix 时间戳(秒);count 与时间范围至少一个大于 0;两者同时指定时优先使用 count。
2. 操作类
| 函数 |
说明 |
Ty.OpenPosition(acct_handle, symbol_id, side, order_type, price, volume, tif="GTC", ref="", bAsync=False) |
开仓,返回委托 system_id,失败返回空字符串 |
Ty.ClosePosition(acct_handle, system_id_toclose, symbol_id, side, order_type, price, volume, tif="GTC", ref="", bAsync=False) |
平仓,返回委托 system_id |
Ty.CloseAllPositions(acct_handle, symbol_id=0) |
全部平仓 |
Ty.OrderModify(acct_handle, system_id, newprice) |
修改挂单价格,仅适用于未成交订单 |
Ty.OrderCancel(acct_handle, system_id) |
撤销指定订单,仅适用于未成交订单 |
Ty.OrderAllCancel(acct_handle, symbol_id=0) |
全部撤单 |
关键参数取值
| 参数 |
取值 |
side |
Ty.BUY / Ty.SELL,与持仓、挂单、成交字典中的 side 字段取值一致,可直接比较 |
order_type |
"LMT"(限价)/ "MKT"(市价)/ "STP"(止损)/ "TP"(止盈)/ "SL"(止损限价) |
tif |
时效类型,默认 "GTC",常用取值含 "GTC"、"DAY" |
ref |
自定义标记,最大 64 字节,可用于区分不同来源的委托 |
bAsync |
默认 False(同步,等待下单结果);True 为异步,立即返回 |
system_id_toclose |
待平持仓的系统编号;传空字符串时由系统自动匹配,匹配采用先进后出(LIFO)原则 |
两点风险提示:① CloseAllPositions 在 symbol_id=0 时会平掉该账户所有品种的持仓,请谨慎使用;② CloseAllPositions 与 OrderAllCancel 仅表示指令已发送,不代表实际平仓或撤单已完成,最终状态应在 OnOrder / OnTrade 中确认。
九、工具函数与策略开关
| 函数 |
说明 |
Ty.StrgLog(msg) |
输出到策略日志窗口 |
Ty.StrgStatus(info) |
输出到状态面板,可实时显示变量数值;每次 OnTick/OnTimer 的内容会覆盖前一次 |
Ty.StrgPrintStatus() |
把当前状态文本写入日志 |
Ty.Alert(msg) / Ty.StrgAlert(msg) |
弹出警示窗口,两者互为别名、完全等价 |
Ty.PlaySound(msg) |
播放提示声音 |
Ty.SendMail(msg) |
发送邮件,收件地址在「全局设置 → 通知」中设定 |
Ty.GetStrategyID() |
获取当前策略实例 ID,每个实例唯一 |
Ty.EventSetTimer(ms) |
设置定时器(毫秒),需在 OnInit 中调用以激活 OnTimer |
Ty.EventKillTimer() |
停止定时器,通常在 OnDeinit 中调用 |
Ty.StrgBuyable() / Ty.StrgSellable() / Ty.StrgClosable() |
判断当前是否允许买开 / 卖开 / 平仓,用于响应策略面板开关 |
Ty.CurrentTime() |
获取行情服务器当前 Unix 时间戳(秒) |
Ty.IndcLog(msg) |
指标日志输出(仅 Python 指标可用) |
十、常量速查
1. K 线周期 timeframe
周期常量的取值为该周期对应的秒数,可直接参与时间计算(如判断当前 K 线是否即将收线)。
| 常量 |
秒数 |
常量 |
秒数 |
常量 |
秒数 |
PERIOD_M1 |
60 |
PERIOD_M30 |
1800 |
PERIOD_H12 |
43200 |
PERIOD_M2 |
120 |
PERIOD_H1 |
3600 |
PERIOD_D1 |
86400 |
PERIOD_M3 |
180 |
PERIOD_H2 |
7200 |
PERIOD_W1 |
604800 |
PERIOD_M5 |
300 |
PERIOD_H3 |
10800 |
PERIOD_MN1 |
2592000 |
PERIOD_M10 |
600 |
PERIOD_H4 |
14400 |
|
|
PERIOD_M15 |
900 |
PERIOD_H6 |
21600 |
|
|
PERIOD_M20 |
1200 |
|
|
|
|
2. 其它常量
| 类别 |
常量 |
| 价格类型 |
PRICE_CLOSE PRICE_OPEN PRICE_HIGH PRICE_LOW(等价字符串 "close" 等) |
| 交易方向 |
BUY SELL |
| 画线类型 |
DRAW_TYPE_NONE DRAW_TYPE_LINE DRAW_TYPE_HISTOGRAM DRAW_TYPE_POINTS DRAW_TYPE_CANDLES |
| 线型 |
LINE_STYLE_SOLID LINE_STYLE_DASH LINE_STYLE_DOT LINE_STYLE_DASHDOT LINE_STYLE_DASHDOTDOT |
| 均线类型 |
MATYPE_SMA MATYPE_EMA MATYPE_WMA |
| 空值 |
EMPTY_VALUE(用于填充无效指标值) |
3. 颜色常量
共 147 个,命名规则为 clr + 颜色名,例如 clrRed、clrLime、clrBlue、clrWhite、clrGold、clrDodgerBlue。完整清单见文末速查表「常量」分类。
十一、示例代码
示例一:Python 指标 —— 布林带(使用 NumPy)
#property indicator_chart_window
#property indicator_desc 布林线
import Ty
import numpy as np
extern period = 20
extern bias = 2.0
def InitSeries():
return ['TOP', 'MID', 'BOT']
def OnCalculate(prev_calculated, rates_total, series_data, rates):
closes = rates['close']
start_idx = max(0, prev_calculated - 1)
mid = series_data['MID']
top = series_data['TOP']
bot = series_data['BOT']
for i in range(start_idx, rates_total):
if i < period:
continue
window = closes[i-period+1:i+1]
mn = np.mean(window)
std = np.std(window)
mid[i] = mn
top[i] = mn + bias * std
bot[i] = mn - bias * std
return rates_total
示例二:Python 指标 —— 蜡烛图序列与逐根着色
展示 series_type = Ty.DRAW_TYPE_CANDLES 与 series_color 的用法(改编自官方文档示例):
#property indicator_chart_window
#property indicator_desc 小宝塔
import Ty
clr_up = Ty.clrRed
clr_dn = Ty.clrLime
def InitSeries():
tower = {}
tower['name'] = '小宝塔'
tower['series_type'] = Ty.DRAW_TYPE_CANDLES
return [tower]
def OnCalculate(prev_calculated, rates_total, series_data, rates, series_color):
opens, closes = rates['open'], rates['close']
highs, lows = rates['high'], rates['low']
start_idx = max(0, prev_calculated - 1)
dataK = series_data['小宝塔'] # 蜡烛图序列的 value 为 OHLC 字典
sColors = series_color['小宝塔']
sOpen, sHigh = dataK['open'], dataK['high']
sLow, sClose = dataK['low'], dataK['close']
for i in range(start_idx, rates_total):
if i == 0:
sOpen[i], sHigh[i] = opens[i], highs[i]
sLow[i], sClose[i] = lows[i], closes[i]
sColors[i] = clr_up if closes[i] >= opens[i] else clr_dn
continue
sClose[i] = closes[i]
max_prev = max(sClose[i-1], sOpen[i-1])
min_prev = min(sClose[i-1], sOpen[i-1])
if closes[i] > max_prev:
sOpen[i] = max_prev if sColors[i-1] == clr_up else min_prev
sColors[i] = clr_up
elif closes[i] < min_prev:
sOpen[i] = min_prev if sColors[i-1] == clr_dn else max_prev
sColors[i] = clr_dn
else:
sOpen[i] = sClose[i-1]
sClose[i] = sClose[i-1]
sColors[i] = sColors[i-1]
sHigh[i] = max(sClose[i], sOpen[i])
sLow[i] = min(sClose[i], sOpen[i])
return rates_total
示例三:Python 策略 —— 布林带突破与移动平仓(完整示例)
覆盖初始化、指标取值、开仓、挂单平仓与改单、成交与订单回调,是官方推荐的策略骨架:
import Ty
# ---------- 策略参数 ----------
extern symbol_name = "ag2601"
extern period = Ty.PERIOD_M5
extern trade_acct = ""
extern open_lots = 1
boll_period = 14
bias_period = 7
bias_ratio = 2.0
# ---------- 全局变量 ----------
last_trade_time = 0
AcctHandle = 0
SymbolID = 0
IndcHandle = 0
precision = 0
price_tick = 0.0
strg_id = 0
def OnInit():
global SymbolID, AcctHandle, precision, price_tick, strg_id, IndcHandle
dictSymbol = Ty.GetSymbolInfoByName(symbol_name)
if not dictSymbol:
Ty.Alert(f"Symbol错误:{symbol_name}")
return
SymbolID = dictSymbol["symbol_id"]
precision = dictSymbol["precision"]
price_tick = dictSymbol["price_tick"]
AcctHandle = Ty.GetTradeAccount(trade_acct)
if AcctHandle <= 0:
Ty.Alert(f"账户错误:{AcctHandle}")
return
Ty.InitSymbolRates(SymbolID, period)
maType = 1 # 0=MA, 1=EMA, 2=WMA
IndcHandle = Ty.InitIndicator("BOLL", SymbolID, period, "close",
[maType, boll_period, bias_period, bias_ratio])
if IndcHandle <= 0:
Ty.Alert(f"指标错误:{IndcHandle}")
return
strg_id = Ty.GetStrategyID()
Ty.StrgLog("初始化完成")
def OnTick(tick):
global last_trade_time
bid, ask, curr_time = tick["bid"], tick["ask"], Ty.CurrentTime()
if AcctHandle <= 0 or SymbolID <= 0:
return
if curr_time - last_trade_time < 15: # 简单的发送间隔控制
return
# 取布林带上轨(0)/中轨(1)/下轨(2),下标 0 为当前 K 线
top = Ty.CopyBuffer(IndcHandle, 0, 2)
mid = Ty.CopyBuffer(IndcHandle, 1, 2)
bot = Ty.CopyBuffer(IndcHandle, 2, 2)
if not (top and mid and bot):
return
# 持仓管理优先
if process_positions(mid[0]):
return
# 仅在 K 线收线前 10 秒内开仓
times = Ty.CopyTime(SymbolID, period, 2)
if times and (times[0] + period - curr_time > 10):
return
if bid > top[0] and Ty.StrgBuyable():
sysid = Ty.OpenPosition(AcctHandle, SymbolID, Ty.BUY, "MKT", 0, open_lots, "GFD")
if sysid:
Ty.StrgLog(f"多开:{bid}>{top[0]} ID:{sysid}")
last_trade_time = curr_time
elif ask < bot[0] and Ty.StrgSellable():
sysid = Ty.OpenPosition(AcctHandle, SymbolID, Ty.SELL, "MKT", 0, open_lots, "GFD")
if sysid:
Ty.StrgLog(f"空开:{ask}<{bot[0]} ID:{sysid}")
last_trade_time = curr_time
# 以中轨为止损位,维护多空两侧的平仓挂单
def process_positions(mid_price):
positions = Ty.GetPositions(AcctHandle, SymbolID)
if not positions:
return False
buy_lots = sum(p["lots"] for p in positions if p["side"] == Ty.BUY)
sell_lots = sum(p["lots"] for p in positions if p["side"] == Ty.SELL)
orders = Ty.GetPendingOrders(AcctHandle, SymbolID)
buy_close_id = next((o["system_id"] for o in orders
if o["side"] == Ty.BUY and o["offset"] != "open"), "")
sell_close_id = next((o["system_id"] for o in orders
if o["side"] == Ty.SELL and o["offset"] != "open"), "")
close_price = round(mid_price, precision)
if buy_lots > 0:
if not sell_close_id:
sysid = Ty.ClosePosition(AcctHandle, "", SymbolID, Ty.SELL,
"STP", close_price, buy_lots, "GFD")
if sysid:
Ty.StrgLog(f"多平挂单:{close_price} ID:{sysid}")
else:
order = next((o for o in orders if o["system_id"] == sell_close_id), None)
if order and abs(order["order_price"] - close_price) > price_tick:
if Ty.OrderModify(AcctHandle, sell_close_id, close_price):
Ty.StrgLog(f"多平修改:{order['order_price']}→{close_price}")
if sell_lots > 0:
if not buy_close_id:
sysid = Ty.ClosePosition(AcctHandle, "", SymbolID, Ty.BUY,
"STP", close_price, sell_lots, "GFD")
if sysid:
Ty.StrgLog(f"空平挂单:{close_price} ID:{sysid}")
else:
order = next((o for o in orders if o["system_id"] == buy_close_id), None)
if order and abs(order["order_price"] - close_price) > price_tick:
if Ty.OrderModify(AcctHandle, buy_close_id, close_price):
Ty.StrgLog(f"空平修改:{order['order_price']}→{close_price}")
return True
def OnTrade(t):
Ty.StrgLog(f"成交:{t['offset']}{t['side']}{t['lots']}@{t['filled_price']}")
def OnOrder(o):
sym_name = o.get("symbol_name", "未知")
Ty.StrgLog(f"订单:{sym_name} {o['side']}{o['total_lots']}@{o['order_price']} 状态:{o['status']}")
def OnDeinit():
Ty.StrgLog("策略停止。。")
示例四:Python 策略 —— 定时器轮询骨架
以 OnTimer 替代 OnTick,适合低频轮询与状态监控类策略:
import Ty
extern symbol_name = "ag2601"
extern lots = 1
acct_handle = 0
symbol_id = 0
precision = 2
def OnInit():
global acct_handle, symbol_id, precision
info = Ty.GetSymbolInfoByName(symbol_name)
if not info:
Ty.Alert(f"品种不存在: {symbol_name}")
return
symbol_id = info["symbol_id"]
precision = info["precision"]
acct_handle = Ty.GetTradeAccount("")
if acct_handle <= 0:
Ty.Alert("账户未登录")
return
Ty.InitSymbolRates(symbol_id, Ty.PERIOD_M5)
Ty.EventSetTimer(3000) # 3 秒轮询,激活 OnTimer
def OnTimer():
if acct_handle <= 0 or symbol_id <= 0:
return
quotes = Ty.GetSymbolQuotes(symbol_id)
closes = Ty.CopyClose(symbol_id, Ty.PERIOD_M5, 20)
if len(closes) < 20:
return
ma20 = round(sum(closes) / len(closes), precision)
fund = Ty.GetFunding(acct_handle)
positions = Ty.GetPositions(acct_handle, symbol_id)
buy_lots = sum(p["lots"] for p in positions if p["side"] == Ty.BUY)
Ty.StrgStatus(f"MA20={ma20} 最新={quotes['last']} "
f"净值={fund['equity']} 多单={buy_lots}")
if quotes["last"] > ma20 and buy_lots == 0 and Ty.StrgBuyable():
sysid = Ty.OpenPosition(acct_handle, symbol_id, Ty.BUY, "MKT", 0, lots)
if sysid:
Ty.StrgLog(f"开多 {lots} 手, system_id={sysid}")
def OnTrade(trade):
Ty.StrgLog(f"成交 {trade['offset']} {trade['lots']}@{trade['filled_price']}")
def OnDeinit():
Ty.EventKillTimer()
Ty.StrgLog("策略停止")
十二、注意事项与常见错误
- 不要编写 main 入口。策略由客户端事件驱动,无需也不应出现
if __name__ == '__main__'。
- 全局变量需
global 声明。在 OnInit 中赋值的变量,必须在函数首行用 global 声明,否则修改不会跨回调保留。
- 初始化顺序不可颠倒。
InitSymbolRates 与 InitIndicator 必须在 OnInit 中完成;CopyBuffer 只能在 OnTick / OnTimer 中调用。
- 账户句柄需判空。
GetTradeAccount 在账户未登录时返回 0,所有交易函数传 0 句柄都不会成功。
- 委托价格需按精度舍入。使用品种字典中的
precision 做 round,改单前用 price_tick 判断差值是否值得修改。
- 平仓匹配规则。
ClosePosition 的 system_id_toclose 传空字符串时由系统按先进后出(LIFO)自动匹配;需要指定逐笔持仓时务必传入对应 system_id。
- 全平与全撤需谨慎。
CloseAllPositions(acct_handle) 不传 symbol_id 会平掉该账户所有品种持仓。
- 指令发送不等于执行完成。平仓、撤单结果应在
OnOrder / OnTrade 中确认,不要以返回值作为成交依据。
- 历史查询参数需合法。
count 与 fromTime/toTime 至少一个大于 0;时间戳单位为秒。
- 注意序列顺序。
CopyRates 等默认按时间倒序返回,list[0] 为当前 K 线;做时序计算时留意顺序或显式设置 bTimeAsc=True。
- 指标专用函数不可用于策略。
IndcGetPeriod、IndcGetSymbolID、IndcGetSymbolInfo、IndcLog 仅限 Python 指标;IndcGetSymbolInfo 运算量较大,建议取值后存入全局变量复用。
- 控制日志频率。
StrgLog 在 OnTick 中高频调用会产生大量日志,建议加时间间隔或状态变化判断。
十三、完整函数速查表
下表按分类列出全部 235 个条目,点击分类可展开。标注「仅指标」的条目只能用于 Python 指标,标注「需 OnInit 初始化」的表示存在调用时机约束。
帐户函数(2)
| 函数 |
签名 |
说明 |
GetTradeAccount |
Ty.GetTradeAccount(acct_code, acct_type="") -> int |
获取已登录账户句柄 |
GetFunding |
Ty.GetFunding(acct_handle) -> dict |
获取账户资金信息 |
品种信息函数(5)
| 函数 |
签名 |
说明 |
GetSymbols |
Ty.GetSymbols() -> list[dict] |
获取自选列表中所有品种信息 |
GetSymbolID |
Ty.GetSymbolID(symbol_name, mkt_type="", currency="") -> int |
通过品种名称获取ID |
GetSymbolInfoByName |
Ty.GetSymbolInfoByName(symbol_name, mkt_type="", currency="") -> dict |
通过名称获取品种信息 |
GetSymbolInfoByID |
Ty.GetSymbolInfoByID(symbol_id) -> dict |
通过ID获取品种信息 |
GetSymbolQuotes |
Ty.GetSymbolQuotes(symbol_id) -> dict |
获取品种实时报价 |
市场数据函数(11)
| 函数 |
签名 |
说明 |
InitSymbolRates |
Ty.InitSymbolRates(symbol_id, timeframe) -> bool |
初始化K线数据 需 OnInit 初始化 |
InitIndicator |
Ty.InitIndicator(indic_name, symbol_id, timeframe, price_type, params) -> int |
初始化技术指标 需 OnInit 初始化 |
CopyRates |
Ty.CopyRates(symbol_id, timeframe, count, startpos=0, fromTime=0, toTime=0, bTim… |
获取K线数据 需 OnInit 初始化 |
CopyOpen |
Ty.CopyOpen(symbol_id, timeframe, count, startpos=0, fromTime=0, toTime=0, bTime… |
获取K线数据开盘数据 需 OnInit 初始化 |
CopyClose |
Ty.CopyClose(symbol_id, timeframe, count, startpos=0, fromTime=0, toTime=0, bTim… |
获取K线数据收盘数据 需 OnInit 初始化 |
CopyHigh |
Ty.CopyHigh(symbol_id, timeframe, count, startpos=0, fromTime=0, toTime=0, bTime… |
获取K线数据最高价数据 需 OnInit 初始化 |
CopyLow |
Ty.CopyLow(symbol_id, timeframe, count, startpos=0, fromTime=0, toTime=0, bTimeA… |
获取K线数据最低价数据 需 OnInit 初始化 |
CopyVolume |
Ty.CopyVolume(symbol_id, timeframe, count, startpos=0, fromTime=0, toTime=0, bTi… |
获取K线数据成交量数据 需 OnInit 初始化 |
CopyOpi |
Ty.CopyOpi(symbol_id, timeframe, count, startpos=0, fromTime=0, toTime=0, bTimeA… |
获取K线数据交易所持仓量数据 需 OnInit 初始化 |
CopyTime |
Ty.CopyTime(symbol_id, timeframe, count, startpos=0, fromTime=0, toTime=0, bTime… |
获取K线数据开盘时间数据 需 OnInit 初始化 |
CopyBuffer |
Ty.CopyBuffer(indic_handle, buffer_number, count, startpos=0, fromTime=0, toTime… |
获取指标数据 |
交易函数(12)
| 函数 |
签名 |
说明 |
GetPositions |
Ty.GetPositions(acct_handle, symbol_id=0) -> list[dict] |
获取账户持仓信息 |
GetPositionBySystemId |
Ty.GetPositionBySystemId(acct_handle, system_id) -> dict |
获取指定system_id持仓信息 |
GetPendingOrders |
Ty.GetPendingOrders(acct_handle, symbol_id=0) -> list[dict] |
获取未成交挂单 |
GetHistoryOrders |
Ty.GetHistoryOrders(acct_handle, symbol_id=0, count=0, fromTime=0, toTime=0) -> … |
获取历史委托记录 |
GetHistoryTrades |
Ty.GetHistoryTrades(acct_handle, symbol_id=0, count=0, fromTime=0, toTime=0) -> … |
获取历史成交记录 |
GetHistoryPositions |
Ty.GetHistoryPositions(acct_handle, symbol_id=0, count=0, fromTime=0, toTime=0) … |
获取已平仓历史持仓 |
OpenPosition |
Ty.OpenPosition(acct_handle, symbol_id, side, order_type, price, volume, tif="GT… |
委托开仓 |
ClosePosition |
Ty.ClosePosition(acct_handle, system_id_toclose, symbol_id, side, order_type, pr… |
委托平仓 |
CloseAllPositions |
Ty.CloseAllPositions(acct_handle, symbol_id=0) -> bool |
全部平仓 |
OrderModify |
Ty.OrderModify(acct_handle, system_id, newprice) -> bool |
修改挂单价格 |
OrderCancel |
Ty.OrderCancel(acct_handle, system_id) -> bool |
撤销指定订单 |
OrderAllCancel |
Ty.OrderAllCancel(acct_handle, symbol_id=0) -> bool |
全部撤单 |
普通函数(14)
| 函数 |
签名 |
说明 |
StrgLog |
Ty.StrgLog(msg) -> None |
输出策略日志 |
StrgStatus |
Ty.StrgStatus(info) -> None |
更新实时状态面板信息 |
StrgPrintStatus |
Ty.StrgPrintStatus() -> None |
打印当前由StrgStatus输出的状态到日志 |
Alert |
Ty.Alert(msg) -> None |
弹出警示窗口 |
StrgAlert |
Ty.StrgAlert(msg) -> None |
弹出警示窗口 |
PlaySound |
Ty.PlaySound(msg) -> None |
播放声音 |
SendMail |
Ty.SendMail(msg) -> None |
发送邮件 |
GetStrategyID |
Ty.GetStrategyID() -> int |
获取策略ID |
EventSetTimer |
Ty.EventSetTimer(ms) -> bool |
设置定时器间隔 |
EventKillTimer |
Ty.EventKillTimer() -> None |
停止定时器 |
StrgBuyable |
Ty.StrgBuyable() -> bool |
检查是否允许买开仓 |
StrgSellable |
Ty.StrgSellable() -> bool |
检查是否允许卖开仓 |
StrgClosable |
Ty.StrgClosable() -> bool |
检查是否允许平仓 |
CurrentTime |
Ty.CurrentTime() -> int |
获取当前服务器时间 |
策略回调事件(6)
| 函数 |
签名 |
说明 |
OnInit |
def OnInit(): |
策略初始化回调 |
OnDeinit |
def OnDeinit(): |
策略退出回调 |
OnTimer |
def OnTimer(): |
定时器回调 |
OnTick |
def OnTick(tick): |
报价变动回调 |
OnTrade |
def OnTrade(trade): |
成交事件回调 |
OnOrder |
def OnOrder(order): |
订单变动回调 |
Python指标(7)
| 函数 |
签名 |
说明 |
#property |
#property 指标属性 |
指定python指标的属性( indicator_desc / indicator_chart_window / indicator_separate_window) ★ indicator_desc :指标的描述文字 … |
IndcGetPeriod |
Ty.IndcGetPeriod() -> int |
获取指标所在图表的时间周期 仅指标 |
IndcGetSymbolID |
Ty.IndcGetSymbolID() -> int |
获取指标所在图表品种ID 仅指标 |
IndcGetSymbolInfo |
Ty.IndcGetSymbolInfo() -> dict |
获取指标所在图表品种信息 仅指标 |
IndcLog |
Ty.IndcLog(msg) -> None |
打印信息,输出到软件的系统日志列表 仅指标 |
InitSeries |
def InitSeries() |
定义指标的输出序列。函数结尾返回一个包含序列信息的列表 可以为以下两种列表: 第一种,返回序列名称列表,如:['MA5','MA10']。 除名称之外,序列其它属性均由系统默认。 示例: def InitSeries()… 仅指标 |
OnCalculate |
三种形式: (a) def OnCalculate(prev_calculated, rates_total, series_data) (b) def OnC… |
定义指标计算逻辑 仅指标 |
特殊标识(1)
| 函数 |
签名 |
说明 |
extern |
extern 变量名 |
声明策略参数变量 |
常量(177)
PERIOD_M1、PERIOD_M2、PERIOD_M3、PERIOD_M5、PERIOD_M10、PERIOD_M15、PERIOD_M20、PERIOD_M30、PERIOD_H1、PERIOD_H2、PERIOD_H3、PERIOD_H4、PERIOD_H6、PERIOD_H12、PERIOD_D1、PERIOD_W1、PERIOD_MN1、PRICE_CLOSE、PRICE_OPEN、PRICE_HIGH、PRICE_LOW、BUY、SELL、DRAW_TYPE_NONE、DRAW_TYPE_LINE、DRAW_TYPE_HISTOGRAM、DRAW_TYPE_POINTS、DRAW_TYPE_CANDLES、LINE_STYLE_SOLID、LINE_STYLE_DASH、LINE_STYLE_DOT、LINE_STYLE_DASHDOT、LINE_STYLE_DASHDOTDOT、clrAliceBlue、clrAntiqueWhite、clrAqua、clrAquamarine、clrAzure、clrBeige、clrBisque、clrBlack、clrBlanchedAlmond、clrBlue、clrBlueViolet、clrBrown、clrBurlyWood、clrCadetBlue、clrChartreuse、clrChocolate、clrCoral、clrCornFlowerBlue、clrCornSilk、clrCrimson、clrCyan、clrDarkBlue、clrDarkCyan、clrDarkGoldenRod、clrDarkGray、clrDarkGreen、clrDarkKhaki、clrDarkMagenta、clrDarkOliveGreen、clrDarkOrange、clrDarkOrchid、clrDarkRed、clrDarkSalmon、clrDarkSeaGreen、clrDarkSlateBlue、clrDarkSlateGray、clrDarkTurquoise、clrDarkViolet、clrDeepPink、clrDeepSkyBlue、clrDimGray、clrDodgerBlue、clrFireBrick、clrFloralWhite、clrForestGreen、clrFuchsia、clrGainsboro、clrGhostWhite、clrGold、clrGoldenRod、clrGray、clrGreen、clrGreenYellow、clrHoneydew、clrHotPink、clrIndianRed、clrIndigo、clrIvory、clrKhaki、clrLavender、clrLavenderBlush、clrLawnGreen、clrLemonChiffon、clrLightBlue、clrLightCoral、clrLightCyan、clrLightGoldenrodYellow、clrLightGreen、clrLightGrey、clrLightPink、clrLightSalmon、clrLightSeaGreen、clrLightSkyBlue、clrLightSlateGray、clrLightSteelBlue、clrLightYellow、clrLime、clrLimeGreen、clrLinen、clrMagenta、clrMaroon、clrMediumAquamarine、clrMediumBlue、clrMediumOrchid、clrMediumPurple、clrMediumSeaGreen、clrMediumSlateBlue、clrMediumSpringGreen、clrMediumTurquoise、clrMediumVioletRed、clrMidnightBlue、clrMintCream、clrMistyRose、clrMoccasin、clrNavajoWhite、clrNavy、clrOldLace、clrOlive、clrOliveDrab、clrOrange、clrOrangeRed、clrOrchid、clrPaleGoldenrod、clrPaleGreen、clrPaleTurquoise、clrPaleVioletRed、clrPapayaWhip、clrPeachPuff、clrPeru、clrPink、clrPlum、clrPowderBlue、clrPurple、clrRed、clrRosyBrown、clrRoyalBlue、clrSaddleBrown、clrSalmon、clrSandyBrown、clrSeaGreen、clrSeaShell、clrSienna、clrSilver、clrSkyBlue、clrSlateBlue、clrSlateGray、clrSnow、clrSpringGreen、clrSteelBlue、clrTan、clrTeal、clrThistle、clrTomato、clrTurquoise、clrViolet、clrWheat、clrWhite、clrWhiteSmoke、clrYellow、clrYellowGreen、MATYPE_SMA、MATYPE_EMA、MATYPE_WMA、EMPTY_VALUE
十四、常见问题
- Python 脚本与公式指标应如何选择?
- 技术指标与信号表达式优先使用公式指标,编写与调试成本最低;需要状态机、复杂循环、跨品种与多账户编排、自动下单时,使用 Python 策略或 Python 指标。两套体系不可混用。
- 为什么
CopyBuffer 取不到数据?
- 通常由三个原因导致:
OnInit 中未调用 InitIndicator、指标句柄为 0、或在 OnInit 中直接调用了 CopyBuffer。该函数只能在 OnTick / OnTimer 中调用。
- 策略中为什么取不到品种 ID?
- 确认品种名称与软件中显示的一致,同名品种需通过
mkt_type 或 currency 参数区分;GetSymbolID 失败时返回 0。
- 下单返回空字符串是什么原因?
OpenPosition / ClosePosition 失败时返回空字符串。常见原因包括:账户句柄无效、品种 ID 为 0、委托价格未按 precision 舍入、数量不满足最小下单单位、账户风控限制或策略开关未开启(可用 StrgBuyable / StrgSellable 检查)。
- OnTimer 为什么不触发?
OnTimer 需先在 OnInit 中调用 Ty.EventSetTimer(ms) 激活,参数为毫秒;停止时调用 Ty.EventKillTimer()。
- 可以使用第三方 Python 库吗?
- 可以。用户可自行安装任意 Python 库(如 NumPy、pandas),并在「全局设置」中指定 Python 路径。
- Python 指标支持哪些市场?
- 与图表数据源一致,支持国内期货(CTP)、盈透证券(IB)、MT4/MT5 与 A 股行情。