# 1ms.news API

> 加密货币和永续合约的实时新闻：Telegram 频道和网站的消息，经 AI 翻译、写标题和摘要、判断利好利空、识别币安 U 本位合约交易对；同一件事的多条报道合并成一个事件。Real-time crypto & perpetual-futures news with AI titles, summaries, sentiment and symbols; duplicate reports are merged into events.

接口地址：https://api.1ms.news

## 第一步：拿一把 API key（免费、不用登录、可以自己申请）

```
curl -X POST https://api.1ms.news/v1/keys -H 'Content-Type: application/json' -d '{"name":"my-agent"}'
```

返回里的 `data.key`（形如 `1ms_live_…`）只显示这一次，请存好。之后每个请求带请求头：

```
Authorization: Bearer 1ms_live_…
```

同一个 IP 每小时最多申请 5 把。

## REST

- `GET /v1/news`：最新消息，一件事一张，新的在前。参数 `limit`（1–50）、`cursor`（翻页）、`symbol`（如 `BTCUSDT`，多个用逗号）、`source`（来源 id）、`sentiment`（`up` / `down` / `neutral`）、`type`（`tg` / `web`）。
- `GET /v1/news?since_id=N`：id 大于 N 的消息，旧的在前（轮询、断线补漏）。
- `GET /v1/news?before_id=N`：id 小于 N 的消息，新的在前（14 天以前的历史）。
- `GET /v1/news/{id}`：一条消息。
- `GET /v1/events/{id}`：一件事和它的全部报道。
- `GET /v1/search?q=关键词`：搜最近 14 天的标题和摘要。
- `GET /v1/sources`：来源目录。
- `GET /v1/digests?limit=6`：每小时精选。
- `GET /v1/me`：这把 key 的级别、点数、今天的用量。

返回都是 JSON：成功是 `{"data": …}`，出错是 `{"error": {"code": "…", "message": "…"}}`。
一条消息的字段：`id`、`ts`（毫秒）、`time`、`title`、`summary`、`sentiment`、`symbols`、`tags`、`source{id,name,type}`、`url`、`original`（原文开头 300 字）、`ai`、`event{id,title,sources,messages}`。

完整定义（OpenAPI）：https://api.1ms.news/v1/openapi.json ；可以直接试的文档页：https://api.1ms.news/v1/docs

## 实时推送

- WebSocket：`wss://api.1ms.news/v1/ws`。纯 JSON 文本消息。连上后发 `{"op":"auth","key":"1ms_live_…"}`（握手时带了 Authorization 请求头或 `?key=` 就不用），再发 `{"op":"subscribe","symbols":["BTCUSDT"],"since_id":0}`（条件都可以不写）。服务器推 `{"type":"news","data":{…}}`、`news_raw`（订阅时写 `"raw":true` 才有）、`event_update`。
- SSE：`GET https://api.1ms.news/v1/stream?symbol=BTCUSDT`，事件名 `news`、`news_raw`、`event_update`，断线重连带 `Last-Event-ID`。

## MCP

- 地址：`https://api.1ms.news/mcp`（Streamable HTTP；协议版本 2026-07-28，也兼容 2025-11-25、2025-06-18、2025-03-26）。
- 工具：`latest_news`、`search_news`、`get_event`、`hourly_digest`、`list_sources`、`request_api_key`。
- key：在 MCP 客户端配置里加请求头 `Authorization: Bearer 1ms_live_…`；或者不配置，先调 `request_api_key` 工具自己申请，再把 key 放进各工具的 `api_key` 参数。
- Claude Code：`claude mcp add --transport http 1ms https://api.1ms.news/mcp --header "Authorization: Bearer 1ms_live_…"`

## 限制

- 一把 key 每分钟 120 次调用，同时最多 5 条实时连接。超了回 429，按 `Retry-After` 等一等。
- 原文只给开头 300 个字，全文请打开 `url`。
- 网页版：https://hub.1ms.news