Python函数手册

通盈策略助手除公式指标外,还提供完整的 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 策略

  1. 菜单栏「交易系统」→「公式代码管理器」→ 点击「Python 策略」→ 右键菜单选择「新建 Python 策略」。
  2. 命名后双击打开,粘贴策略代码,点击检测语法无误后保存。
  3. 在「策略列表」中找到该策略(未出现可右键刷新),双击可修改策略参数。
  4. 策略右键菜单「历史回测」用于验证盈利表现;点击启动后,策略会自动下载数据并开始运行。

2. Python 指标

  1. 菜单栏「交易系统」→「公式代码管理器」→ 点击「Python 指标」→ 右键菜单选择「新建 Python 指标」。
  2. 命名后双击打开,粘贴指标代码,检测语法无误后保存。
  3. 菜单栏「技术指标」→「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. 调用时序

  1. OnInit 中调用 Ty.InitSymbolRates(symbol_id, timeframe) 初始化 K 线数据。
  2. OnInit 中调用 Ty.InitIndicator(...) 取得指标句柄。
  3. 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("策略停止")

十二、注意事项与常见错误

  1. 不要编写 main 入口。策略由客户端事件驱动,无需也不应出现 if __name__ == '__main__'。
  2. 全局变量需 global 声明。在 OnInit 中赋值的变量,必须在函数首行用 global 声明,否则修改不会跨回调保留。
  3. 初始化顺序不可颠倒。InitSymbolRates 与 InitIndicator 必须在 OnInit 中完成;CopyBuffer 只能在 OnTick / OnTimer 中调用。
  4. 账户句柄需判空。GetTradeAccount 在账户未登录时返回 0,所有交易函数传 0 句柄都不会成功。
  5. 委托价格需按精度舍入。使用品种字典中的 precision 做 round,改单前用 price_tick 判断差值是否值得修改。
  6. 平仓匹配规则。ClosePosition 的 system_id_toclose 传空字符串时由系统按先进后出(LIFO)自动匹配;需要指定逐笔持仓时务必传入对应 system_id。
  7. 全平与全撤需谨慎。CloseAllPositions(acct_handle) 不传 symbol_id 会平掉该账户所有品种持仓。
  8. 指令发送不等于执行完成。平仓、撤单结果应在 OnOrder / OnTrade 中确认,不要以返回值作为成交依据。
  9. 历史查询参数需合法。count 与 fromTime/toTime 至少一个大于 0;时间戳单位为秒。
  10. 注意序列顺序。CopyRates 等默认按时间倒序返回,list[0] 为当前 K 线;做时序计算时留意顺序或显式设置 bTimeAsc=True。
  11. 指标专用函数不可用于策略。IndcGetPeriod、IndcGetSymbolID、IndcGetSymbolInfo、IndcLog 仅限 Python 指标;IndcGetSymbolInfo 运算量较大,建议取值后存入全局变量复用。
  12. 控制日志频率。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 股行情。