跳到主内容

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 仅对外返回系统存活状态与服务版本,内部缓存与数据源指标已对公网收敛。

MethodPath说明
GET/api/v1/health健康检查
GET/api/v1/workbench/dashboard工作台仪表盘 — 指数 + 涨跌停 + 强势行业
GET/api/v1/workbench/daily-review每日复盘数据
GET/api/v1/workbench/insights市场洞察 — 焦点 + 热门板块 + 新闻 + 研报
GET/api/v1/market/sectors行业板块行情列表
GET/api/v1/market/sectors/{sector_code}/stocks板块成分股列表
GET/api/v1/stocks/{code}/quote个股实时行情
GET/api/v1/stocks/{code}/history个股历史K线
GET/api/v1/stocks/{code}/indicators个股技术指标 (MA/MACD/KDJ/RSI)
GET/api/v1/stocks/{code}/moneyflow个股资金流向
GET/api/v1/stocks/{code}/events个股事件/AI摘要
GET/api/v1/stocks/{code}/patternAI 形态识别
GET/api/v1/stocks/{code}/financials个股财务数据
GET/api/v1/stocks/search搜索股票 (q 参数,keyword 兼容)
GET/api/v1/stocks/watchlist自选股列表
POST/api/v1/ai/commentAI 个股点评
POST/api/v1/ai/daily-reviewAI 每日复盘生成
POST/api/v1/ai/score-batchAI 批量评分
GET/api/v1/portfolio/positions持仓列表
POST/api/v1/portfolio/positions添加持仓
DELETE/api/v1/portfolio/positions/{position_id}删除持仓
GET/api/v1/portfolio/summary持仓汇总
GET/api/v1/alerts预警列表
POST/api/v1/alerts创建预警
PATCH/api/v1/alerts/{alert_id}更新预警
DELETE/api/v1/alerts/{alert_id}删除预警
GET/api/v1/alerts/triggered已触发预警
POST/api/v1/alerts/parse解析预警指令
POST/api/v1/feedback提交反馈
GET/api/v1/feedback反馈列表
GET/api/v1/us/stocks/{symbol}/filings美股 SEC 官方披露

股票代码格式

后端使用 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