加密货币实时预警 REST API 全指南

从生成 API 密钥到第一个成功推送，仅需 2 分钟上手的加密货币价格监控 API 完整说明书。

快速概览

在浏览器里新建一条“当 ETH 突破 4000 美元”的规则，更优雅的方法是用代码批量管理成百上千条同样的警报条件。
核心思路只有三步：

获取 api_token；
POST 创建警报条件；
收到触发后通过 Webhook / 邮件 / 短信等通道即时通知。

借助这套 REST API，你可以：

实时监控主流交易所及链上新币、价格、涨跌幅、链上钱包、交易池拥堵等 7 种事件；
分钟级自定义冷却时间，防止刷屏；
与内部风控、量化系统或自己的 TG Bot 无缝整合，扩展出新场景。

1 生成与使用 API Token

# 示例：创建一个「ETH 突破 4000 美元」的价格警报
curl -X POST https://api.example.com/v1/alert-conditions \
  -u YOUR_API_TOKEN: \
  -H "Content-Type: application/json" \
  -d '{
    "type": "price",
    "currency": "ETH",
    "target_currency": "USD",
    "price": "4000",
    "direction": "above",
    "channel": { "name": "webhook" },
    "exchange": "Binance"
  }'

安全须知：

全部接口强制 HTTPS；
用户名即 API Token，密码留空；
切勿把 Token 写进前端代码或公开仓库。

2 创建警报条件支持的 7 种类型

警报类型	触发维度	常见关键词
new_coin	新币上线	新币, 币种首发, 首发交易所
price	固定价格	价格警报, 限价提醒
percent_price	时段涨跌幅	10%涨幅, 急跌抄底, 预警
periodic_price	固定周期快照	分钟 K 线, 自动报价
bitcoin_mempool	内存池拥堵状态	Mempool, 手续费, 网络拥堵
volume	成交量异动	巨量成交, 交易激增
wallet	链上资产变化	钱包监控, 巨鲸追踪

2.1 new_coin 新币上线示例

{
  "type": "new_coin",
  "currency": "ANY",
  "channel": { "name": "email" },
  "exchange": "Binance"
}

2.2 percent_price 涨跌预警示例

{
  "type": "percent_price",
  "currency": "BTC",
  "percent": "5.0",
  "direction": "up",
  "window": 30,
  "channel": { "name": "slack" },
  "cooldown": 15
}

👉 想一步拿到最新参数表？高手也常查的官方对照页在这里。

3 统一响应格式

创建成功会返回一个 JSON，字段 id 至关重要，后续GET / PUT / DELETE均用它定位。示例：

{
  "id": 42,
  "type": "price",
  "currency": "ETH",
  "target_currency": "USD",
  "price": "4000",
  "direction": "above",
  "channel": { "name": "webhook", "confirmed": true },
  "exchange": "Binance"
}

4 查询与删除告警

4.1 查看全部告警

curl -u YOUR_API_TOKEN: https://api.example.com/v1/alert-conditions

4.2 关闭再启用

curl -X PUT https://api.example.com/v1/alert-conditions/42 \
  -u YOUR_API_TOKEN: \
  -d '{"enabled":false}'

4.3 删除某条告警

curl -X DELETE https://api.example.com/v1/alert-conditions/42 \
  -u YOUR_API_TOKEN:

5 错误码速查表

状态码	场景示例	解决建议
400	缺失必填字段	检查 JSON 完整性
401	无效 API Token	重新生成或检查是否填错
403	创建的告警数量已达配额上限	删除旧规则或升级套餐
429	触发限流：每秒 2 次请求	指数退避重试
50x	服务端异常	联系技术支持

6 Webhook 实战：30 秒内自动对冲

收到触发消息后，Webhook JSON 将包含：

event_type：如 price_triggered
currency, price, exchange：具体成交信息
id：让你立即定位是哪条规则被触发

无需人工盯盘，Webhook 收到信号→程序立即下单→完成对冲。👉 想亲自测试这份流通性最好的实时对冲思路？点击体验立即上手的沙盒环境。

7 FAQ | 最常问的 6 件事

Q1：试用期有配额限制吗？
A：免费账户一次最多保有 100 条告警；升级 Pro 后可扩至 5,000 条，同时提升 QPS 上限。

Q2：能否一次创建多条？
A：REST 端点每次仅支持单条写入。如需批量，可在客户端 for-loop，或订阅企业级批量导入功能。

Q3：短信和电话会在什么地区可用？
A：目前 SMS 支持全球 150+ 国家区号；电话语音仅限欧美及东南亚主要市场。

Q4：可以监控链上 NFT 转入转出吗？
A：暂不支持，请改用钱包告警结合解析脚本，收到资金变化后自行二次判断 NFT 事件。

Q5：冷却时间到底指什么？
A：同一条件触发后，系统暂停再次判定的分钟数，防止 1 分钟内连发 20 条通知。

Q6：服务器时区？
A：全部以 UTC+0 记录；如设置为 5 分钟周期快照，均以整点 5 分、10 分…触发。

8 最小可运行范例（Python）

import requests

TOKEN = "你的api_token"
base = "https://api.example.com/v1"
rule = {
  "type": "wallet",
  "blockchain": "ETH",
  "address": "0x72c9...a9E",
  "direction": "changes",
  "channel": {"name":"webhook"},
}

resp = requests.post(f"{base}/alert-conditions", json=rule, auth=(TOKEN, ""))
print("告警 ID:", resp.json()["id"])

至此，你已具备完整版 加密货币价格监控 API 实操能力，无论是交易所包网、自动化投顾还是个人量化脚本，都能立即上线、零试错。祝开发顺利，市场长青！