OKX 交易信号机器人 2.0 消息规范（PineScript 与通用方案通吃）

面向 TradingView 用户 + OKX Signal Bot 的一份“一句话可复制”的完整指引，从 PineScript 策略到手动图表操作全覆盖，帮你把交易信号 准确、安全、无延迟 地送进实盘。

本文不含任何广告下载文案，仅讨论技术规格与配置细节，按需取用即可。

索引

1. 整体思路：策略 vs 指标
1. A 路径：PineScript 策略专用模板
1. B 路径：任意方法通用模板
1. 高频疑问 FAQ

1. 整体思路：Strategy 脚本与 Indicator 场景怎么选？

关键词提炼	PineScript、Signal Bot、策略、回测、实盘

Strategy 场景：利用 strategy.*() 系列函数跑回测/实盘，会自动记录订单 ID、仓位方向等变量；推荐直接使用下一节的 A 路径，一行代码即可导出自带占位符的 json。
Indicator / 手动场景：不依赖 broker simulator，仅绘制买卖箭头或手敲 Alert 消息；用 B 路径，字段名固定，零代码也能用。

无论选哪条路，OKX 的解析器都会智能识别格式并完成订单映射，无需任何额外配置。

👉 实测零延迟的完整配置范例，点这里查看

2. A 路径：PineScript 策略专用模板

关键词：TradingView、策略占位符、{{strategy.order.id}}

2.1 必选字段 & 高频误区

字段	类型	占位符示例	备注
`id`	string	{{strategy.order.id}}	解决策略多条同名订单冲突
`action`	string	{{strategy.order.action}}	buy / sell
`marketPosition`	string	{{strategy.market_position}}	long / short / flat
`instrument`	string	{{ticker}}	建议直接送 TradingView ticker，OKX 会自动匹配
`signalToken`	string	在 OKX Signal 创建页复制	个人身份校验
`timestamp`	string	{{timenow}}	UTC ISO8601，防延迟
`maxLag`	int	60（默认）	建议 30–90 秒区间
`investmentType`	enum	base（最稳）	选用 base + {{strategy.order.contracts}}，数量自动对齐策略数量
`amount`	float	{{strategy.order.contracts}}	推荐使用基础货币数量

模板消息（直接复制进 Alert 消息框）：

{
  "id": "{{strategy.order.id}}",
  "action": "{{strategy.order.action}}",
  "marketPosition": "{{strategy.market_position}}",
  "prevMarketPosition": "{{strategy.prev_market_position}}",
  "instrument": "{{ticker}}",
  "signalToken": "YOUR_SIGNAL_TOKEN",
  "timestamp": "{{timenow}}",
  "maxLag": 90,
  "investmentType": "base",
  "amount": "{{strategy.order.contracts}}"
}

2.2 进阶技巧：多空头寸量管控

想杠杆加仓？将 investmentType 改掉：percentage_investment 可根据机器人“初始投资额”比例再放大。
分批 EXIT？在 PineScript 用 strategy.exit 会自动拆单，OKX Signal Bot 会收到多条 EXIT_LONG/EXIT_SHORT 信号，分批平仓无需你操心。

3. B 路径：任意方式通用模板

关键词：手动 Alert、限价单、分批建仓、多品种

3.1 必选字段快速表

字段	取值示例	场景提醒
`action`	ENTER_LONG / EXIT_SHORT …	一眼区分加减仓位
`orderType`	market / limit	限价单必须同时填 `orderPriceOffset`
`investmentType`	percentage_balance / margin / contract …	建仓专用，平仓用 “percentage_position”
`orderPriceOffset`	0.5	限价偏移 0.5%，单边滑点可接受

最精简消息骨架：

{
  "action": "ENTER_LONG",
  "instrument": "{{ticker}}",
  "signalToken": "YOUR_SIGNAL_TOKEN",
  "timestamp": "{{timenow}}",
  "orderType": "market"
}

3.2 实战案例

例 1：单次多→空反转

Alert 1: ENTER_LONG
Later Alert: EXIT_LONG + ENTER_SHORT（在同一消息里并列？想多了，两条消息排队即可）

例 2：Dollar-Cost Averaging（DCA）

启用 OKX 的“多仓 Entry”功能，手动把 percentage_balance 设 25%，会按四次信号逐笔加仓。

例 3：限价单滑点控制

用户希望限价买时比买一低 1%，则：

orderType: limit
orderPriceOffset: 1

系统永远用 Bid * (1 - 0.01) 挂单，成交率与策略自信度挂钩。

4. 高频疑问 FAQ

关键词：🤖 Signal Bot、报警失效、token 泄露、延迟风险

Q1：可以同时用 PineScript + 自定义 Alert 吗？
A：可以，OKX 解析器独立识别格式，互不冲突；但务必在 TradingView 为每条脚本/Alert 单独绑定 signalToken，防止串单。

Q2：为何 60 秒延迟就被机器人拒收？
A：网络波动、TradingView webhook 中转，都会导致“时差报警”。建议把 maxLag 开到 120 秒，并参考 👉 官方延迟优化文档优化你的云函数路径。

Q3：我想动态加仓，原投资的 1000 USDT 变 2000 USDT 怎么改？
A：在 OKX Signal Bot 面板点击“增加保证金”并调高 Active Investment 即可；后续信号会按新金额百分比开仓。

Q4： {{strategy.order.contracts}} 为 0.01，机器人却下 1 张？
A：币种最小下单单位不同，OKX 会 自动进位 到合法最小单位；你可以在策略脚本里量化处理，强制不小于最小单位。

Q5：如何防止 token 泄露被他人滥用？
A：

不往公共 GitHub 上传策略；
TradingView Alert 消息通道建议使用 HTTPS webhook，并校验来源 IP；
若怀疑泄露，直接在 OKX 删除原信号并重建，老的 token 即时失效。

一分钟核验清单

[ ] 策略脚本使用的是 strategy.*()？→ 用 A 路径模板。
[ ] 手动画线发 Alert？→ 用 B 路径模板，选 ENTER_LONG / EXIT_SHORT。
[ ] signalToken 已替换为你自己的？
[ ] maxLag 设定是否符合网络状况？
[ ] 平仓时 percentage_position = 100 才能自动清 0？

祝你从此 0 滑点、0 误报、0 漏单，安心睡个好觉。