API 文档

FateSpeed 资产增值系统 REST API 参考文档。所有端点返回 JSON 格式数据。

基础 URL

http://www.fatespeed.com/api/v1

价格 API

GET /prices/current

获取所有币种的当前价格

响应示例

{
  "prices": {
    "BTC": {"price": 98500.0, "change_24h": 2.5},
    "ETH": {"price": 3200.0, "change_24h": 1.8},
    "USDC": {"price": 1.0001, "deviation_bps": 1.0}
  },
  "timestamp": "2026-01-27T10:00:00"
}

GET /market/overview

获取市场监控面板数据（含 USDC 状态、主流币、山寨币）

缓存时间：60 秒

GET /market/chart

获取 USDC 偏离与主流币联合图表数据

查询参数

参数	类型	说明
`timeframe`	string	时间范围：1h, 4h, 24h, 72h, 7d, 30d
`symbol`	string	币种：BTC, ETH, SOL（默认 BTC）

AI 分析 API

GET /ai/status

获取四重 AI 系统状态和统计信息

缓存时间：30 秒

POST /ai/test

执行 AI 分析测试

查询参数

source all | both | claude | codex | gemini

GET /ai/triggers

获取全部 20 种触发器状态和配置

POST /ai/triggers/toggle

切换触发器启用状态

请求体

{
  "trigger_type": "RSI_EXTREME",  // 或 "all"
  "enabled": true
}

POST /ai/feedback

提交 AI 分析反馈（准确度评价）

请求体

{
  "analysis_id": 123,
  "rating": "positive",  // 或 "negative"
  "source": "claude",
  "comment": "分析准确"
}

数据导出 API

GET /export/prices

导出价格历史数据

查询参数

`format`	json \| csv \| excel（默认 json）
`days`	天数（默认 7，最大 30）
`symbol`	币种过滤（可选）

GET /export/notifications

导出通知历史

GET /export/ai

导出 AI 分析历史

GET /export/usdc

导出 USDC 价格历史

GET /export/triggers

导出触发器配置

服务控制 API

GET /service/status

获取服务状态

POST /service/pause

暂停监控服务

POST /service/resume

恢复监控服务

POST /service/trigger/price_monitor

立即执行价格检查

SSE 实时事件

SSE /events

Server-Sent Events 实时数据流

事件类型

price_update - 价格更新
usdc_alert - USDC 告警
health_status - 健康状态
notification - 通知事件
ai_analysis - AI 分析结果
system - 系统消息

使用示例

const evtSource = new EventSource('/api/v1/events');
evtSource.addEventListener('price_update', (e) => {
  const data = JSON.parse(e.data);
  console.log('价格更新:', data);
});