# 熔岩 · 消息面热度监测 API

> 股票与概念板块的消息面热度监测数据订阅：按股票与概念板块输出消息面热度、结构化要点、匿名机构/大V ID 与机构/大V评分（含 PIT 面板）。只读 HTTPS/JSON API，API Key 鉴权，按次计费。不提供多空观点与原文。

## 新手上手（不用写代码）

1. 拿 API Key：登录熔岩 → 左侧「AI数据服务」→「API Key」→「创建」，马上复制保存（lvk_ 开头，只显示一次）。入口 https://lava.ai-dolphin.com/lava#/ai-data-service
2. 接到豆包办公 / WorkBuddy / 千问办公（MCP＝让 AI 办公软件直接调数据的接口）：在「连接器」里新建自定义连接器，连接方式选 Streamable HTTP（豆包里叫 HTTP），地址 https://lava.ai-dolphin.com/subscribe/v1/mcp ，请求头 Authorization = Bearer lvk_你的Key
3. 保存并打开开关，新建对话直接问，例如「宁德时代最近一周消息面热不热？」
- 分软件详细步骤: https://lava.ai-dolphin.com/subscribe#ai-office
- 费用: 先送 100 元代金券；之后按请求次数扣费，约 1000 次 5 元（每次 0.005 元）；失败的请求不扣钱；余额不足返回 402
- 数据边界: 只给结构化文字 + 匿名机构/大V ID；无多空观点、无原文、不荐股、不承诺收益

## 开发者

- 基础地址: https://lava.ai-dolphin.com/subscribe/v1
- 鉴权: 请求头 `Authorization: Bearer <key>`（或 `X-API-Key: <key>`）
- 响应: 统一信封 {ok, code, message, data, meta}；错误时 ok=false、data=null、code 为错误码

## Docs

- [API 文档（HTML）](https://lava.ai-dolphin.com/subscribe/docs): 接口、参数、计费、错误码
- [OpenAPI 3.0](https://lava.ai-dolphin.com/subscribe/v1/openapi.json): 机器可读规范，可直接导入 Agent 工具调用
- [产品首页](https://lava.ai-dolphin.com/subscribe): 4 步上手、分软件接入步骤、计费、数据边界
- [Agent 技能模板](https://lava.ai-dolphin.com/subscribe/v1/skill): 查热度流程（Markdown，可存为 SKILL.md）

## MCP

- 远程 MCP（Streamable HTTP）: https://lava.ai-dolphin.com/subscribe/v1/mcp ，请求头 `Authorization: Bearer <key>`；可接入豆包办公、WorkBuddy、千问办公等支持自定义连接器（MCP）的软件
- tool `get_stock_news_heat`: 个股消息面热度：某只股票最近被提到的记录
- tool `search_news_flow`: 按关键词搜消息面记录
- tool `get_concept_stock_heat`: 概念板块热度：某个概念里哪些股票被提到最多
- tool `get_stock_concept_heat`: 个股概念热度：某只股票关联哪些概念最热
- tool `get_agency_ranking`: 匿名机构/大V评分排行（当前）
- tool `get_agency_pit`: 匿名机构/大V历史截面评分（PIT）
- tool `get_agency_history`: 单个匿名机构/大V的历史评分走势（PIT）
- tool `list_agency_pit_dates`: 有历史评分（PIT）的日期列表
- tool `get_account`: 查余额和用量（不扣钱）

## Endpoints

- [GET /opinions](https://lava.ai-dolphin.com/subscribe/v1/docs#opinions-by-stock): 个股消息面热度：某只股票最近被提到的记录（参数: stock_name, ts_code, days, start_date, end_date, only_this_stock, limit）
- [GET /opinions/search](https://lava.ai-dolphin.com/subscribe/v1/docs#opinions-search): 按关键词搜消息面记录（参数: keyword*, since, limit）
- [GET /agencies/ranking](https://lava.ai-dolphin.com/subscribe/v1/docs#agencies-ranking): 匿名机构/大V评分排行（当前）（参数: order, min_score, limit, offset）
- [GET /agencies/pit](https://lava.ai-dolphin.com/subscribe/v1/docs#agencies-pit): 匿名机构/大V历史截面评分（PIT）（参数: as_of_date, agency_id, min_score, limit, offset）
- [GET /agencies/{agency_id}/history](https://lava.ai-dolphin.com/subscribe/v1/docs#agencies-history): 单个匿名机构/大V的历史评分走势（PIT）（参数: agency_id*, start_date, end_date, limit）
- [GET /agencies/dates](https://lava.ai-dolphin.com/subscribe/v1/docs#agencies-dates): 有历史评分（PIT）的日期列表（参数: limit）
- [GET /concepts/stocks](https://lava.ai-dolphin.com/subscribe/v1/docs#concepts-stocks): 概念板块热度：某个概念里哪些股票被提到最多（参数: concept*, days, limit）
- [GET /concepts/by-stock](https://lava.ai-dolphin.com/subscribe/v1/docs#concepts-by-stock): 个股概念热度：某只股票关联哪些概念最热（参数: stock_name, ts_code, days, limit）
- [GET /account](https://lava.ai-dolphin.com/subscribe/v1/docs#account): 查余额和用量（不扣钱）

## Notes

- agency_id（AG+12 位十六进制）＝机构/大V的匿名编号：长期不变、不可反推真实名称；opinion_id 同理
- PIT＝只用当时已知数据算的历史分数（无未来函数），适合回测
- 时间均为北京时间（UTC+8）
- 数据仅供研究参考，不构成投资建议