Developer

和网页用同一份数据编程。下面的接口目前供本站网页使用；第三方调用需要 Developer 方案、API Key 与数据授权（尚未开放）。

授权提醒

行情与整理数据只用于本站网页展示，不通过 API 再分发；官方公布的数据（交易所与公司公告、统计局、财政部等）可以引用。授权检查在后端执行，前端隐藏不作为唯一控制。

接口

接口列表
Endpoint	说明	参数示例	限流	用途授权
/api/stock/{symbol}/quote	单只证券行情（A 股实时，港美股延迟）	symbol：SH600519 / HK00700 / AAPL	60 次 / 分钟	仅网页展示，不可再分发
/api/events	事件流（公告、规则事件），支持 market、type、importance、q、since、before、symbols	market=cn\|hk\|us、type=回购、limit=50	60 次 / 分钟	公司公告：可引用
/api/rates/center	利率中心（LPR、Shibor、国债、联邦基金、SOFR、HIBOR）	region=cn\|hk\|us	60 次 / 分钟	官方公布数据：可引用
/api/macro	宏观指标与修订	country=CN\|US	60 次 / 分钟	官方统计：可引用
/api/futures/list	期货品种与合约	region=cn\|hk\|us	60 次 / 分钟	仅网页展示，不可再分发
/api/options/chain	ETF 期权链（IV / Greeks 为本站计算）	underlying=510050、exp=2026-10	60 次 / 分钟	网页展示；衍生值可引用
/api/screener	筛选器（URL 条件与网页一致）	pe_lt=20、roe_gt=15、mc_gt=1000	30 次 / 分钟	仅网页展示，不可再分发
/api/quant/backtest	运行日线回测（POST）	template、params、costPreset、capital、start、end	30 次 / 小时	结果为本站计算

统一响应

{
  "data": { ... },
  "meta": {
    "status": "ok | empty | stale | partial | unconfigured | error",
    "freshness": "realtime | delayed | eod | periodic",
    "delayMinutes": 15,
    "asOf": "数据本身的截至时间（ISO 8601）",
    "fetchedAt": "本站获取时间",
    "message": "非 ok 时的说明"
  }
}

示例代码

curl "https://<你的域名>/api/rates/center?region=cn"

错误码

401 UNAUTHORIZED: 缺少或无效的 API Key
403 DATA_REDISTRIBUTION_NOT_ALLOWED: 该字段的数据授权不允许通过 API 再分发（返回结构化原因，不返回空数据）
429 RATE_LIMITED: 超过限流，响应头 Retry-After 给出等待秒数
404 NOT_FOUND: 代码或资源不存在