跳至主要内容

ARL 规则文档

本指南适用于 Candle Ping 工作台的 ARL 文本编辑器。用实时价格、K 线或永续合约行情编写提醒,通过触发策略控制通知频率。

你的第一条规则

这条规则在每根 5 分钟 K 线收盘时检查一次。收盘价从均线下方或均线处上穿 20 根收盘价的简单移动平均线时提醒,两次提醒至少间隔 30 分钟。

clock bar_close(5m)
let average = sma(close, 20)
when crosses_above(close, average)
trigger cooldown 30m

怎么让 AI 帮我写规则?

从页首的「打开」菜单选择 AI。如果对话框里已有 ARL 文档,就发送预填内容。选择 DeepSeek、Gemini 或 Microsoft Copilot 时,页面会自动复制文档。在对话框里粘贴文档,再加上下面这段需求。

我在看 BTC,每根 15 分钟 K 线收盘时检查一次。RSI(14) 从 30 或以下升到 30 以上时提醒我,两次提醒至少间隔 1 小时。请按文档写一条可以直接粘贴的 ARL 规则。

把 AI 回复中的 ARL 规则粘贴到工作台「提醒 → 新建 → ARL 文本」。点「预览」查看历史触发记录,核对周期、上穿方向和冷却时间,再点「创建提醒」。

规则结构与默认值

每条规则描述一个品种的一项提醒。建议为每个子句单独换行,按下表顺序书写。用 # 添加行内注释。

子句用法要求与默认值
scopescope symbol("binance:BTCUSDT.PERP")可选。省略时使用当前图表品种。显式填写时必须与图表一致。
clockclock bar_close(5m)建议显式声明。省略时取 when 引用的最细周期。没有周期可推断时必须填写。
letlet fast = ema(close, 9)可写多条,每个名称只定义一次。
whenwhen close > fast必填。表达式必须能判断真假。
triggertrigger rising_edge, cooldown 30m可选。默认是 level。多个选项以逗号分隔。
notifynotify app.in_app()可选。默认使用页内通知。外部渠道在工作台选择。

收盘、实时与多周期

clock bar_close(5m) 在收盘时求值。可用周期为 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 12h, 1d, 1w。

clock tick 随行情更新检查,clock interval(7s) 每 7 秒检查一次,间隔使用正整数秒。实时规则中的 close 是当前价格。显式写 close @ 15m 可取最近一根已收盘的 15 分钟 K 线的收盘价。

把括号放在要切换周期的整个条件外。下面在 5 分钟收盘时检查 RSI 是否上穿 30,同时要求最近已收盘的 15 分钟价格高于其均线。引用周期应等于或粗于检查周期。

clock bar_close(5m)
when crosses_above(rsi(close, 14), 30) and (close > sma(close, 10)) @ 15m

可用行情数据

K 线字段

价格
close
实时规则取最新价,收盘规则取对应 K 线的收盘价。
开盘价
open
该根 K 线的开盘价。
最高价
high
该根 K 线内的最高价。
最低价
low
该根 K 线内的最低价。
成交量
volume
按基础币计。实时规则取当前 1 分钟 K 线累计值。
成交额
turnover
按计价币计。实时规则取当前 1 分钟 K 线累计值。

收盘放量上涨示例:volume > 2 * sma(volume, 20) and close > open。

永续合约字段

合约持仓量
data.open_interest
未平仓量,按基础币计。
资金费率
data.funding_rate
交易所最近公布的费率,阈值可写 0.01%。

仅永续。行情超过 3 分钟未更新视为缺失。回看使用已结算费率和持仓量快照。Bitget 旧数据粒度较粗,Hyperliquid 和 Coinbase 缺历史持仓量。

指标与条件

用 close 取价格。用 + - * / 做算术,用 > >= < <= == != 比较数值,用 and、or、not 组合条件。5% 表示 0.05。

均线和动量指标支持 sma(src, n)、ema(src, n)、rsi(src, n)。macd(src, fast, slow, signal) 取 .line、.signal 或 .hist。bbands(src, n, k) 取 .mid、.upper 或 .lower。

crosses_above(a, b) 检测上穿,crosses_below(a, b) 检测下穿。若只关心价格是否仍高于阈值,用 close > 100000。

自定义指标公式

公式是一个 ARL 数值表达式,可用 open、high、low、close、volume 和数值函数。不支持 clock、when、@ 或引用其他自定义指标。成交额 turnover 和永续合约的 data.* 字段可直接在提醒规则中使用,不写在指标公式里。

图表用当前周期和最新公式。已保存的提醒保留自己的公式版本。要更新已有提醒,编辑时勾选「本次改用指标库的最新公式」。

示例:量比。标识为 volume_ratio。下面的公式表示当前成交量是最近 20 根 K 线平均成交量的多少倍。

volume / sma(volume, 20)

量比保存后,可在提醒中用 custom.volume_ratio 引用。下面的规则在 5 分钟 K 线收盘时检查量比是否上穿 2。

clock bar_close(5m)
when crosses_above(custom.volume_ratio, 2)

触发频率与到期

默认 level 在条件为真时触发。rising_edge 在条件转为真时触发。once 只提醒一次,rearm 条件 指定再次允许触发的条件。多个触发项用逗号分隔。

cooldown 30m 设置最短间隔,max 3 per 1d 限制滚动窗口内的次数。expire 接受 never、时长或带时区的 ISO 8601 字符串。时长单位为 s m h d w,范围为 1 秒至 1 周。

例如,实时价格超过 100000 时只提醒一次。

clock tick
when close > 100000
trigger once

在工作台使用规则

选好品种,在「新建提醒 → ARL 文本」中粘贴规则。点「预览」查看历史触发。指标需要预热,浏览器最多为一条规则读取 10,000 根 1 分钟 K 线。

实时规则按已收盘的 1 分钟 K 线近似回放。tick 每根检查一次,interval 在原 UTC 网格取最新未用的收盘样本。分钟内短暂穿越可能漏掉。

默认通知写法是 notify app.in_app(),可以省略。Webhook 等渠道在工作台选择。生成规则时只使用本页支持的语法与数据。跨品种扫描暂不支持。