TradingView 对接 OKX：在 OKX 永续合约和现货上执行提醒

AlgoVesta 通过一个带密码短语、仅限交易权限的 API 密钥，把每条 TradingView 提醒变成你 OKX 账户中的一笔订单。永续合约会挂算法止损和止盈订单；现货订单以现金模式发出，因此买入绝不会借款，并带有同时包含两个价位的一个 OCO 订单。资金始终留在你的 OKX 账户中。

工作原理

OKX 现货的现金模式及其重要性

OKX 账户可以用现金模式或保证金模式交易现货。一个常见的通用库会悄悄把现货订单切换为全仓保证金，这可能让交易者背上自己从未要求过的借款余额。AlgoVesta 则改为通过 OKX 自己的 API 以现金模式发送 OKX 现货订单，所以现货买入只会花费你持有的资金。

OKX 现货上的保护是一个单独的 OCO 算法订单，同时包含止损和止盈；其中一个触发后，另一个会被撤销。在永续合约上，这些价位是条件式只减仓订单。两种情况下，AlgoVesta 都会从 OKX 回读它们，而 OKX 是把这些订单列在算法订单列表中，而不是普通的未成交订单里，核对时查的正是那里。

密码短语带来的不同

OKX 与 KuCoin、Bitget 一样，是这一组中为每个 API 密钥增加密码短语的三家交易所之一。它由你在创建密钥时设置，之后无法找回，所以一旦丢失，就必须重新创建密钥。AlgoVesta 会把它与私钥一起加密存储，且只用它来签署请求。

永续合约的仓位大小

在永续合约上，OKX 以合约张数交易。AlgoVesta 会把提醒中的保证金和杠杆换算成合约张数，并选择 OKX 接受的最近数量；如果与你的金额相差超过 20%，就不会开仓，机器人卡片会显示哪些金额可行。

提醒消息

把下面的内容粘贴到提醒的消息框中。两个 plot 值来自你的指标；现货会忽略杠杆。

{
  "symbol": "{{ticker}}",
  "action": "buy",
  "price": "{{close}}",
  "stop_loss": "{{plot_0}}",
  "take_profit": "{{plot_1}}",
  "leverage": 10
}

对于 Pine 策略，请使用策略模板，这样平仓和反手才能正常工作。不要只发送 {{strategy.order.action}}：平仓时它的值是“sell”，会开出一个空单，而不是平掉仓位。market_position 字段会告诉 AlgoVesta 策略何时处于空仓。

{
  "symbol": "{{ticker}}",
  "action": "{{strategy.order.action}}",
  "market_position": "{{strategy.market_position}}",
  "prev_market_position": "{{strategy.prev_market_position}}",
  "position_size": "{{strategy.position_size}}",
  "price": "{{close}}"
}

只有在你的 TradingView 账户开启双重验证后，TradingView 才会显示 Webhook URL 输入框。TradingView 无法发送自定义请求头，所以 AlgoVesta 会根据 TradingView 自己的服务器地址来验证来源，并且只对能验证的提醒执行自动交易。

连接你的 OKX API 密钥

在 OKX 中创建密钥，并授予这些权限：Trade。提现和划转保持关闭，因为 AlgoVesta 从不需要它们：它可以下单和平仓，但无法把资金转出你的账户。OKX 密钥还有一个由你在创建密钥时选择的密码短语。请把它与密钥和私钥一起输入 AlgoVesta；它的加密方式相同。

如果你把密钥限制为指定 IP 地址，AlgoVesta 的连接向导会显示需要添加的两个服务器地址。帮助中心里有完整的分步指南，并附有 OKX 各个界面的样子。

如何将 OKX 连接到 AlgoVesta →

适用于每一笔订单的规则

• 每笔订单都有止损：来自信号，或来自你自己设定的百分比或距离。没有止损来源，就不会下单。
• 每日亏损限额：达到后会暂停新开仓，直到下一个 UTC 日。
• 每个机器人的最大持仓数和每日最大交易次数。
• 紧急按钮：只平掉 AlgoVesta 开的仓位，你自己的仓位不受影响。

在加密货币交易所上，从信号到达到带保护的订单成交，一笔订单平均约 4.1 秒开仓，数据来自 AlgoVesta 自己的执行记录。