API 文档
后端 Base URL: https://aikanpan.top/api/v1
接口鉴权与调用配额
爱看盘 API 服务提供基础开放接口与高频/管理受保护接口。调用受保护接口或获取更高调用限额时,需在请求头携带 API Key 进行身份认证。
公开基础接口(匿名访问)
提供基础行情、K线、指标与健康状态查询。按客户端 IP 自动限流,基准配额为 600 次/分钟。超限将返回 HTTP 429。
受保护接口(API Key 鉴权)
管理与内部数据接口强制要求有效 Key;请求头须携带 X-API-Key: <secret>。Key 配额为 1200 次/分钟。
状态码规范:
200 OK 正常响应401 Unauthorized 未提供或无效 Key429 Too Many Requests 超出频次配额注:健康检查接口 /api/v1/health 仅对外返回系统存活状态与服务版本,内部缓存与数据源指标已对公网收敛。
股票代码格式
后端使用 exchange.code 格式:
- sh.600518上海证券交易所 (6开头)
- sz.300414深圳证券交易所 (0/3开头)
Web 路由同时支持 sz300414 和 sz.300414 两种格式。
示例
# 基础接口(无需 Key)
curl https://aikanpan.top/api/v1/workbench/dashboard
# 携带 API Key 调用(自定义高配额/受保护接口)
curl -H "X-API-Key: your_api_key_here" https://aikanpan.top/api/v1/stocks/sh.600519/quote
# 搜索股票
curl "https://aikanpan.top/api/v1/stocks/search?q=300414"
# 个股行情
curl https://aikanpan.top/api/v1/stocks/sz.300414/quote
# 个股AI事件摘要
curl https://aikanpan.top/api/v1/stocks/sz.300414/events
# 美股 SEC 官方披露
curl https://aikanpan.top/api/v1/us/stocks/AAPL/filings