🔧 开发者 API 文档

热点Pro 提供 REST + RSS + iCal 三类公开端点。免费用户 60 req/min; 付费用户 600 req/min;企业用户协议定制。

🔌 公开 REST API

方法路径说明缓存
GET/api/health服务可用性
GET/api/sources已配置数据源列表5 min
GET/api/quote/{symbol}实时报价(股票/加密)30 s
GET/api/quotes?symbols=A,B,C批量报价30 s
GET/api/timeseries/{symbol}?range=1d价格时间序列(用于 sparkline)5 min
GET/api/sentiment/{symbol}多源舆情指数 + 命中事件2 min
GET/api/narrative/{symbol}AI 中文叙事(即时生成)1 min
GET/api/firehose多源信号 firehose(去重 + 评分)2 min
GET/api/news已发布资讯综述列表30 s
GET/api/news/{slug}单篇资讯详情5 min
GET/api/news/{slug}/comments评论列表
GET/api/news/{slug}/poll「你怎么看」投票统计
GET/api/symbols/search?q=NVDA标的代码搜索10 min

🔐 用户态 API(需登录)

方法路径说明
POST/api/auth/register注册
POST/api/auth/login登录(返回 session cookie)
GET/api/auth/me当前用户信息
GET/api/watchlist我的 watchlist
POST/api/watchlist添加 watchlist 标的
DELETE/api/watchlist/{symbol}移除 watchlist 标的
GET/api/rules我的告警规则
POST/api/rules创建告警规则
POST/api/telegram/bind/start启动 Telegram 绑定流程

📡 RSS / Atom 订阅

路径说明更新频率
/news/feed.xml资讯综述10 min
/insiders/feed.xmlSEC Form 4 ≥$1M10 min
/macro/feed.xmlFOMC + Fed 演讲15 min
/wsb/feed.xmlWSB Top 2030 min
/briefing/feed.xml每日盘前简报每日

📅 iCal 日历订阅

路径说明用法
/calendar/earnings.ics美股财报日历导入 Apple/Google Calendar
/calendar/fomc.icsFOMC 议息日历同上

iCal 订阅方法:复制链接 → 在 Apple Calendar / Google Calendar 中选择「订阅日历」→ 粘贴 URL。 日历会自动每日刷新。

⚖️ 速率限制

  • 免费用户:60 请求 / 分钟,1000 请求 / 天
  • Pro 付费用户:600 请求 / 分钟,无日上限
  • 企业用户:协议定制,可同步对接 Webhook
  • 超出限额会返回 429 Too Many Requests + Retry-After 响应头
  • 所有 RSS / iCal 端点不计入速率限制(只受 Cloudflare CDN 限制)

🔑 认证

用户态 API 使用 HMAC-SHA256 签名的 session cookie,登录后自动写入。 服务器端到端 API(用于自动化任务)请联系 [email protected] 申请 API Token。

📋 示例:cURL 获取 NVDA 报价

$ curl https://redian.pro/api/quote/NVDA

{
  "symbol": "NVDA",
  "price": 142.50,
  "change_percent": 2.3,
  "name": "NVIDIA Corporation",
  "asset_type": "stock",
  "currency": "USD",
  "ok": true,
  "fetched_at": 1778313600
}
  
💡 想要更快的 API 速率限制?

付费用户解锁 600 req/min + 自动化 Webhook + 优先支持。 查看定价 →