系统
—
- 版本
- —
- 运行时间
- —
- 内存
- —
- 持久化
- —
PRICE ALERT API
价格提醒
安全访问
输入 API Token
Token 仅保存在当前浏览器会话中。
正在连接行情未知数据可能过期
行情
—
- 订阅
- —
- 过期行情
- —
- 最近行情
- —
- 连续失败
- —
提醒资源
—
- 已启用
- —
- 已暂停
- —
- 已布防
- —
- 等待布防
- —
API · 近 5 分钟
—
- 成功率
- —
- 4xx / 5xx
- —
- 限流
- —
- 平均响应
- —
Bark
—
- 最近成功
- —
- 最近失败
- —
- 连续失败
- —
- 24 小时发送
- —
INSTRUMENTS
标的与最新行情
| 标的 | 最新价格 | 行情时间 | 状态 | 提醒数 |
|---|
尚未创建提醒。
ALERTS
提醒管理
| 选择 | 标的 / 名称 | 方向 | 阈值 / 回差 | 状态 | 上次触发 | 操作 |
|---|
尚未创建提醒。
INTEGRATION
API 接入说明
供第三方程序和 Apple 快捷指令调用。完整字段定义以 OpenAPI 契约为准。
基础配置
连接服务
- 服务地址
—- API 版本
/api/v2- 认证
Authorization: Bearer <API_TOKEN>- 数据格式
application/json
价格和回差必须使用 JSON 字符串，例如 "100000.50"。创建提醒还需发送唯一的 Idempotency-Key。
APPLE SHORTCUTS
快捷指令设置
- 添加“获取 URL 内容”，URL 填写下方对应接口。
- 方法选择 GET、POST 或 PATCH；请求正文选择 JSON。
- 在“标头”中添加
Authorization，值为Bearer 你的API_TOKEN。 - 创建提醒时再添加
Idempotency-Key，值可使用快捷指令每次运行时生成的 UUID。 - 从返回的字典中读取
data；失败详情位于error.message。
Token 属于敏感凭证，请勿放入共享链接、URL 参数或截图。
QUICK REFERENCE
常用接口
| 方法 | 路径 | 用途 |
|---|---|---|
GET | /api/v2/status | 查询服务、行情和提醒汇总状态 |
GET | /api/v2/alerts | 查询提醒；支持 instrument_id、direction、enabled、limit、cursor |
POST | /api/v2/alerts | 创建提醒 |
GET / PATCH / DELETE | /api/v2/alerts/{alert_id} | 读取、修改或删除单条提醒 |
POST | /api/v2/alerts/actions/pause | 暂停显式指定的提醒 ID |
POST | /api/v2/alerts/actions/resume | 恢复显式指定的提醒 ID |
POST | /api/v2/alerts/actions/delete | 删除显式指定的提醒 ID |
GET | /api/v2/instruments | 查询已监控标的 |
GET | /api/v2/quotes/{instrument_id} | 查询标的最新价格 |
EXAMPLE
创建价格提醒
curl -X POST '/api/v2/alerts' \
-H 'Authorization: Bearer <API_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: <UUID>' \
-d '{"instrument_id":"BTC-USDT-SWAP","direction":"above","threshold":"100000","reset_gap":"500","label":"BTC 突破"}'RESPONSE
响应约定
成功响应包含 request_id 和 data。失败响应包含 request_id 以及 error.code、error.message；遇到 HTTP 429 时按 Retry-After 秒数后重试。
{"request_id":"req_...","data":{...}}
{"request_id":"req_...","error":{"code":"...","message":"..."}}