你的第一条规则
这条规则在每根 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 文本」。点「预览」查看历史触发记录,核对周期、上穿方向和冷却时间,再点「创建提醒」。
规则结构与默认值
每条规则描述一个品种的一项提醒。建议为每个子句单独换行,按下表顺序书写。用 # 添加行内注释。
| 子句 | 用法 | 要求与默认值 |
|---|---|---|
scope | scope symbol("binance:BTCUSDT.PERP") | 可选。省略时使用当前图表品种。显式填写时必须与图表一致。 |
clock | clock bar_close(5m) | 建议显式声明。省略时取 when 引用的最细周期。没有周期可推断时必须填写。 |
let | let fast = ema(close, 9) | 可写多条,每个名称只定义一次。 |
when | when close > fast | 必填。表达式必须能判断真假。 |
trigger | trigger rising_edge, cooldown 30m | 可选。默认是 level。多个选项以逗号分隔。 |
notify | notify 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 等渠道在工作台选择。生成规则时只使用本页支持的语法与数据。跨品种扫描暂不支持。