为什么第一次运行不提醒？

没有之前的有效观测可比较，所以第一次只保存基线。

为什么使用 effective_at？

它表示 IDR 观测实际写入的时间，可以避免重复旧响应产生提醒。

市场关闭时的数据一定无效吗？

不一定。保留 source 和 market_session，把它解释为参考数据。

会给别人发送消息吗？

不会，只打印到本地控制台。

Tutorial/用 Python 构建 USD/IDR 汇率提醒

用 Python 构建 USD/IDR 汇率提醒

Q: 会给别人发送消息吗？

不会，只打印到本地控制台。

使用 Python 标准库构建阈值提醒监控：只在跨越阈值时提醒，安全保存状态，并遵守数据新鲜度和 API 限制。

ERexchangerate.dev·Sep 8, 2026·阅读约 8 分钟

提醒应比较每个新的有效 USD/IDR 观测与上一次观测，而不是比较两次轮询时间。第一次只建立基线，旧数据和错误不会改变状态。

Key points

判断 IDR 时使用 sources["IDR"] 和 effective_at["IDR"]。全局 source 只是所有请求币种的保守摘要。

第一次有效观测只保存基线。跨越阈值后提醒一次并解除武装，只有之后有效观测回到阈值以内才重新武装。

先写入同目录临时 JSON，设置 0600，再用 os.replace 替换，避免中断留下半个状态文件。

请求使用十秒超时，密钥放在 EXCHANGERATE_API_KEY。轮询至少间隔60秒；429时保留状态并遵守 Retry-After。

下载完整脚本，在版本控制之外配置阈值和状态路径。脚本只打印本地控制台提醒。

建模单币种观测

判断 IDR 时使用 sources["IDR"] 和 effective_at["IDR"]。全局 source 只是所有请求币种的保守摘要。

python · observation modelcopy

from decimal import Decimal

def idr_observation(payload: dict) -> dict:
    return {
        "rate": Decimal(str(payload["rates"]["IDR"])),
        "source": payload["sources"]["IDR"],
        "effective_at": payload["effective_at"]["IDR"],
        "market_session": payload["market_session"],
    }

定义跨越策略

第一次有效观测只保存基线。跨越阈值后提醒一次并解除武装，只有之后有效观测回到阈值以内才重新武装。

情况状态变化提醒

第一次有效观测保存基线否

低于阈值的新观测armed=true否

已武装时跨越阈值armed=false一次

重复/旧观测或错误保留状态否

安全保存状态

先写入同目录临时 JSON，设置 0600，再用 os.replace 替换，避免中断留下半个状态文件。

python · atomic state writecopy

import json
import os
import tempfile
from pathlib import Path

def save_state(path: Path, state: dict) -> None:
    path.parent.mkdir(parents=True, exist_ok=True)
    fd, temporary = tempfile.mkstemp(prefix=f".{path.name}.", dir=path.parent, text=True)
    try:
        os.fchmod(fd, 0o600)
        with os.fdopen(fd, "w") as handle:
            json.dump(state, handle, sort_keys=True)
            handle.write("\n")
        os.replace(temporary, path)
    except Exception:
        try:
            os.unlink(temporary)
        except OSError:
            pass
        raise

限制网络和配额

请求使用十秒超时，密钥放在 EXCHANGERATE_API_KEY。轮询至少间隔60秒；429时保留状态并遵守 Retry-After。默认五分钟间隔在30天约调用8,640次；60秒间隔约43,200次，可能超过共享月度配额。

错误不能制造虚假提醒

请求使用十秒超时，密钥放在 EXCHANGERATE_API_KEY。轮询至少间隔60秒；429时保留状态并遵守 Retry-After。

运行完整监控

下载完整脚本，在版本控制之外配置阈值和状态路径。脚本只打印本地控制台提醒。默认最大数据年龄为一小时。如果接受每日参考或市场关闭数据，请设置 FX_ALERT_MAX_AGE_SECONDS。 python-exchange-rate-alerts.py

shell · run itcopy

chmod 700 python-exchange-rate-alerts.py
export EXCHANGERATE_API_KEY="your-key"
export FX_ALERT_THRESHOLD_PCT="1.0"
export FX_ALERT_POLL_SECONDS="300"
export FX_ALERT_STATE_PATH="$HOME/.local/state/fx-alert.json"
python3 python-exchange-rate-alerts.py

不等待市场也能测试策略

用网络 mock 测试第一次、阈值内移动、跨越、重复时间、旧数据、重新武装和第二次跨越。

exchangerate.dev

面向开发者的集成指南。