# SpikePanel 股票研究数据 Skill

你(AI 助手)可以用本服务替用户研究美股。所有接口都在 `https://ai.spikepanel.com/skill/v1`,
请求带 `Authorization: Bearer <用户的 token>`(用户会把 token 给你;没有则请用户到
spikepanel.com 设置页领取)。返回全部为 JSON(本文档除外)。限流:60 次/分,5000 次/天。

## 接口目录

| 接口 | 回答的问题 |
|---|---|
| `GET /stock/{sym}/snapshot` | 这是什么公司?多大?现在什么估值水平?下次财报什么时候? |
| `GET /stock/{sym}/financials?statement=income|balance|cashflow&period=q|a&limit=8` | 三大报表(带 filing_date,可做无前视分析) |
| `GET /stock/{sym}/analyst` | 分析师怎么看:评级共识/最近升降级/目标价/盈利预估 |
| `GET /stock/{sym}/ownership` | 谁在买卖:内部人交易流水、13F 机构持仓摘要、流通股结构 |
| `GET /stock/{sym}/events` | 财报日历与历史、分红、拆股 |
| `GET /stock/{sym}/valuation-history?days=365` | 估值与市值的时间序列(PE/PS/PB/EV-EBITDA/市值) |
| `GET /stock/{sym}/chain` | **独家**:产业链知识图谱——上下游/材料链/竞对/关键人物,SEC 年报+社媒抽取,带证据句 |
| `GET /stock/{sym}/buzz?days=30` | **独家**:X 社媒声量——24h/7d 热度、surge 倍数、30 天日序列(可信作者口径) |
| `GET /stock/{sym}/voices?limit=20` | **独家**:可信大 V 近期原文——按站内可信度分排序,带互动与原帖链接 |
| `GET /leaders?limit=20` | **独家**:达人榜——喊单战绩经价格核验的作者排名(胜率/Wilson 下界) |
| `GET /news/today` | **独家**:今日头条——回声选题+联网编辑的当日美股新闻榜(中英双语带正文) |
| `GET /stock/{sym}/news?kind=all|news|press|transcript&limit=20` | 单票新闻流:个股新闻/官方公告/财报电话会逐字稿(FMP 文档库) |

## 使用配方

- **基本面初检**:snapshot → financials(income,q)看增速与利润率走向 → analyst 看预期差
- **谁在买卖**:ownership;内部人连续卖出+机构持仓下降是经典警讯,反之亦然;
  13F 是季度口径(季末后 45 天披露),别当实时数据解读
- **估值分位**:valuation-history 拿 365 天 PE/PS 序列,自行计算当前分位
- **产业链研究**:chain 出上下游与竞对;每条边带确认次数 n 与证据句,n 高且证据含
  年报原文的是硬事实,低确认数单源边当线索;上游(设备/材料商)覆盖天然偏弱,别当全集
- **社媒情报纪律**:buzz 的声量是周级时效信号,反映注意力不预示方向;互动量高≠可信,
  以 voices/leaders 的可信度分与核验战绩为准;综合研究时社媒信号只做佐证层,
  基本面(financials/analyst/ownership)才是主证层
- **每日必读**:news/today 是当日大事的编辑成品(多源交叉核实),适合作为研究的起点;
  单票深挖用 stock/{sym}/news(kind=press 看官方口径,kind=transcript&limit=1 读最近电话会)
- **报表口径**:fiscal_date 是财季截止日,filing_date 是披露日;做历史归因请用 filing_date
  对齐(否则有前视偏差);每股口径跨拆股比较前先查 /events 的 splits

## 边界与免责

数据源:Financial Modeling Prep(基本面/分析师/持仓)与站内沉淀,非实时行情。
本服务只提供事实数据,不构成投资建议;请不要据此替用户做买卖决策表述。