KX信号策略警报规范：如何设置「警报」预警交易机会与风险？

OKX现已推出上线信号策略，用户可以通过TradingView发布信号，并根据信号在OKX上创建信号策略，当TradingView发送信号并触发设置条件时，即可自动开始运行交易。本篇文章将为大家介绍OKX支持的各种警报消息规范，即如何设置「警报」从而预警交易机会和风险。

「警报消息」— 概述

本小节将介绍警报消息设置都包含哪些参数和字段，具体每个参数和字段值的释义将在后面小节中详细介绍。

「警报消息」— 操作

交易模式：

假设在OKX信号策略以单向（买入/卖出）模式运行，这意味着只会在一个方向上持有头寸。

下单

• 开多 — ENTER_LONG：下单持有多头头寸，预期价格会上涨。

• 开空 — ENTER_SHORT：下单持有空头头寸，预期价格会下跌。

平仓

• 平多 — EXIT_LONG：下单出售持有头寸部分即平仓多头头寸。

• 平空 — EXIT_SHORT：下单回购头寸部分即平仓空头头寸。

「警报消息」— 工具

类型一：ticker — TradingView占位符值

“标准占位符” * 是由双大括号包围并包含在警报消息中的文字片段。"{{ticker}}"将返回生成警报的TradingView的代码。

例如：“BTCUSDT. P”、“ETHUSDT.P”。

* 在PineScript中访问变量的标准占位符。在这里了解更多。

类型二：OKX工具格式

工具ID，或OKXAPI中的“instId”。例如："BTC-USDT-SWAP"、"ETH-USDT-SWAP"

「警报消息」— 信号代码

信号代码：信号的身份验证。这种安全措施，用于确保传入的请求是合法和授权的。当用户在OKX成功创建新信号时，将自动生成此signalToken，并需要将其复制到TradingView Alert Message。

「警报消息」— 时间戳

timenow-TradingView占位符值

“标准占位符”*是由双大括号包围并包含在警报消息中的文字片段。"{{timenow}}"将返回生成警报的当前和确切时间，UTC和yyyy-MM-ddTHH： mm：ssZ格式。

例如："2023-06-01T17:38:10Z"

*在PineScript中访问变量的标准占位符。在这里了解更多。

「警报消息」— 最大延迟

maxLag-最大可接受延迟

在信号策略中，“maxLag”是指在交易信号被接收前以秒为单位的最大可接受延迟时间。默认设置为30秒。设置maxLag值有助于确保信号策略的及时运行，避免对可能不再反映当前市场状况的过时信号或潜在不准确信号采取行动。

「警报消息」— 订单

订单类型（orderType）

• 市场价（market）：通过市场价进行下单，比如开仓（action=ENTER_XX）或平仓（action=EXIT_XX）时，则无需提供orderPriceOffset。

• 限价（limit）：设置限价单，进行开仓（action=ENTER_XX）或平仓（action=EXIT_XX）。

订单价格偏移量（orderPriceOffset）

如上所述，该参数仅在限价单类型需要填写，即当下单限价单时，允许订单以限定价格为基数的偏移量，可以在增加订单成交的几率的同时，又能确保以较为理想的价格成交。设置后，在不同操作时，偏移价格计算方式如下：

• 开多：[1-（订单价格偏移量/100）]*买一价

• 开空：[1+（订单价格偏移量/100）]*卖一价

• 平多：[1+（订单价格偏移量/100）]*卖一价

• 平空：[1-（订单价格偏移量/100）]*买一价

「警报消息」— 投资类型和金额

1）只供买入讯号使用

• 保证金：以报价货币计价的投资保证金

• 张数：固定数量的订单张数

• 可用保证金比例 ：基于可用保证金的百分比（即开立新订单的可用保证金）

• 初始投资额百分比：基于创建机器人时初始投资保证金的百分比。之后添加的额外保证金将不计算在内

2）仅适用于卖出信号

• 持仓比例：基于未平仓头寸的百分比

OKX信号策略警报设置示例

示例1：多头开仓->多头平仓（全部平仓）

示例2：无多仓的多仓->短仓（一步反转）

示例3：多头开仓->多头平仓（部分平仓）->多头平仓（完全平仓）

示例4：使用多次下单开仓

多次开仓是OKX 信号策略中的一项功能，它允许对给定工具执行多个下单点。交易者可以通过多点位下单（即平均成本的方法）来优化交易策略，从而在多变市场环境中试图增加获利的可能。

示例5：仅使用触发信号（不使用订单相关字段）

如上图，对于信号供应商，比如TradingView，他们可能会排除某些可选参数，仅保留一些必要的信号参数。原因是用户可能已经在策略创建的时候配置了这些参数，比如在OKX信号策略已经设置了，那么就无需在TradingView重复设置它们。

对于专注于仅提供买入/卖出触发信号的供应商来说，这可以让他们更加注意信号参数的研究，而对于用户来说，由用户自己决定订单维度的参数，比如投资金额和比例，可以让交易更自由且有效。

示例6：仅使用触发信号（不使用订单相关字段）如果用户在信号平台和策略创建平台的参数配置中都没有指定订单详细信息，则将使用默认值。

• 对于买入（开仓）信号，默认情况下，它将使用市场订单以 X% 的比例进行下单（ 单对时，X=100；多对时，X=50。

• 对于卖出（平仓）信号，默认情况下，它将在收到信号后关闭100%未平仓头寸。