plugin-okx-trading — OKX 交易所接口

包名: @aalis/plugin-okx-trading
源码: packages/plugin-okx-trading/src/index.ts

概述

OKX 加密货币交易所 API 集成，支持模拟盘和实盘，包含行情查询、账户管理、下单交易和策略委托功能。默认模拟盘；实盘动用真实资金需显式确认风险（详见下文实盘安全闸）。

插件声明

typescript

export default definePlugin({
  name: '@aalis/plugin-okx-trading',
  subsystem: 'external',
  uses: {
    tools: optional(tools),
    logger,
    config,
  },
  apply(caps) { /* 见源码 */ },
});

配置

字段	类型	默认值	说明
`apiKey`	string	必填	API Key：在 OKX 设置中创建的 API Key（secret）
`secretKey`	string	必填	Secret Key（secret）
`passphrase`	string	必填	Passphrase：创建 API 时设定的口令（secret）
`baseUrl`	string	`'https://www.okx.com'`	API 地址：默认实盘地址，可改为自定义域名。带查询串或片段（`?` 或 `#` 之后的部分：插件在它后面拼路径）时激活报配置错误
`demo`	boolean	`true`	模拟盘：启用后将使用模拟交易环境，强烈建议先在模拟盘测试
`confirmRealMoney`	boolean	`false`	确认实盘风险：仅当关闭模拟盘（demo:false）、用真实资金时，须显式设为 true 以确认风险；否则不暴露下单/撤单/策略/划转/提币等交易工具，仅保留查询。
`timeoutMs`	number	`15000`	请求超时 (ms)
`enableTrading`	boolean	`true`	启用交易工具：关闭后仅保留查询类工具，不暴露下单/撤单操作
`enableAlgo`	boolean	`false`	启用策略委托：启用止盈止损 / 计划委托工具
`enableTransfer`	boolean	`false`	启用资金划转：启用资金账户划转工具
`defaultPageLimit`	number	`20`	分页查询默认条数：查询订单/账单/成交明细等接口，LLM 未传 limit 时使用。
`maxPageLimit`	number	`100`	分页查询最大条数：LLM 传入的 limit 会被 cap 到该值；查到的条目整份交给模型，调大会增加单次工具结果的体积。OKX API 本身单页一般最多 100（个别接口 300）。

apiKey、secretKey、passphrase 缺一个插件就激活失败，报缺的那一项，WebUI 把它标成待配置。

实盘安全闸

本插件刻意保留实时 / 算法交易能力，因此不做逐单人工确认，改用「等级门禁 + 一次性显式确认 + 启动告警」三道闸。前提是 demo 默认 true：交易工具默认可用，但走的是模拟环境。

等级门禁（restricted）：涉及资金或仓位变更的工具被标记 visibility: 'restricted'（最低等级 2），防止任意访客经 LLM 以 owner 的资金下单或划转。其余查询类工具分两档：读取账户、订单、资金流水、充值地址等私有数据的查询工具（源码 ACCOUNT_READ_OKX_TOOLS）标记 risk: 'sensitive'（最低等级 1），挡住等级 0 用户经 LLM 读取 owner 的账户数据；行情与 Rubik 指标等公开数据工具维持默认 public。
实盘显式确认：当 demo:false（真实资金）时，必须同时设 confirmRealMoney:true，否则插件不注册下单、策略委托、资金划转三组工具（含这三组里的查询工具），只保留行情、指标、账户、订单查询四组。即这三组工具是否注册取决于 demo || confirmRealMoney。
启动告警：实盘启动时打告警日志：开启 confirmRealMoney 提示「LLM 可用真实资金下单……无逐单人工确认」；未开启则提示已禁用交易工具仅保留查询。

被标 restricted 的变更类工具：

okx_place_order        okx_cancel_order        okx_amend_order
okx_set_leverage       okx_set_position_mode   okx_adjust_margin
okx_batch_place_orders okx_batch_cancel_orders okx_close_position
okx_place_algo_order   okx_cancel_algo_order   okx_transfer

注册工具

工具通过 tools 服务注册到 okx 分组（label「OKX 交易」），变更类工具自动标 restricted：

行情 (registerMarketTools): 查询交易对行情、K线、深度
指标 (registerRubikTools): Rubik 大数据指标
账户 (registerAccountTools): 查询余额、持仓、账户信息、账单（带分页）
订单查询 (registerOrderQueryTools): 历史 / 当前订单、成交明细（带分页）
下单 (registerTradeTools): 现货/合约下单、撤单、改单、批量、平仓、杠杆/仓位/保证金设置，以及订单详情、近 3 个月成交明细查询 —— 需 enableTrading 且实盘安全闸放行
策略 (registerAlgoTools): 止盈止损（含 oco）/ 计划委托的下单、撤单与查询 —— 需 enableAlgo 且实盘安全闸放行
资金 (registerTransferTools): 资金账户划转，以及划转状态、资金账单、充值地址、充提记录查询 —— 需 enableTransfer 且实盘安全闸放行

各组内的查询工具随所在组一起受开关和实盘安全闸控制。

配置校验

凭证没填全时激活失败（见上）。凭证、地址、模拟盘与实盘确认开关、交易功能开关的显式无效值会报配置错误；地址格式在工具注册前校验。分页上限仍夹在 1–1000，默认条数取整、至少 1 且不超过上限。

plugin-okx-trading — OKX 交易所接口 ​

概述 ​

插件声明 ​

配置 ​

实盘安全闸 ​

注册工具 ​

配置校验 ​

plugin-okx-trading — OKX 交易所接口

概述

插件声明

配置

实盘安全闸

注册工具

配置校验