# ARL 规则文档 本指南适用于 Candle Ping 工作台的 ARL 文本编辑器。用实时价格、K 线或永续合约行情编写提醒,通过触发策略控制通知频率。 ## 你的第一条规则 这条规则在每根 5 分钟 K 线收盘时检查一次。收盘价从均线下方或均线处上穿 20 根收盘价的简单移动平均线时提醒,两次提醒至少间隔 30 分钟。 ```arl clock bar_close(5m) let average = sma(close, 20) when crosses_above(close, average) trigger cooldown 30m ``` ## 怎么让 AI 帮我写规则? 从页首的「打开」菜单选择 AI。如果对话框里已有 ARL 文档,就发送预填内容。选择 DeepSeek、Gemini 或 Microsoft Copilot 时,页面会自动复制文档。在对话框里粘贴文档,再加上下面这段需求。 ```text 我在看 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 分钟价格高于其均线。引用周期应等于或粗于检查周期。 ```arl 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 线平均成交量的多少倍。 ```text volume / sma(volume, 20) ``` 量比保存后,可在提醒中用 `custom.volume_ratio` 引用。下面的规则在 5 分钟 K 线收盘时检查量比是否上穿 2。 ```arl 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 时只提醒一次。 ```arl clock tick when close > 100000 trigger once ``` ## 在工作台使用规则 选好品种,在「新建提醒 → ARL 文本」中粘贴规则。点「预览」查看历史触发。指标需要预热,浏览器最多为一条规则读取 10,000 根 1 分钟 K 线。 实时规则按已收盘的 1 分钟 K 线近似回放。`tick` 每根检查一次,`interval` 在原 UTC 网格取最新未用的收盘样本。分钟内短暂穿越可能漏掉。 默认通知写法是 `notify app.in_app()`,可以省略。Webhook 等渠道在工作台选择。生成规则时只使用本页支持的语法与数据。跨品种扫描暂不支持。