# 技能：全球财经快讯服务 (Global Financial News Recap)

> 📊 访问统计：日活 40（3139 次请求） / 月活 134（16068 次请求），更新于 2026-08-01T17:46:12.063Z



## 技能简介
这是一个提供全球财经快讯数据的 API 服务，可以获取：
- 📰 实时财经快讯（综合多个数据源）
- 📊 市场情绪指标
- 🚀 涨停池分析
- 📉 跌停池分析
- 🔁 连板池分析
- 💥 炸板池分析
- 📈 大盘联动数据
- 💰 融资融券统计
- 📊 个股融资净买入排行
- 📐 股指期货行情（IC/IF/IH/IM）
- 🎯 概念板块数据
- 📚 全量汇总信息（市场情绪 / 大盘联动 / 融资融券 / 概念板块 / 财经快讯 / 涨停池分析 / 跌停池分析 / 连板池分析 / 炸板池分析）
- 🏢 股票基本信息查询
- 📊 盘口快照查询（股票/ETF基金）
- 📉 K线数据查询（股票/ETF基金）

## 基础信息
- **API 基础 URL**: `https://recap-service.your-subdomain.workers.dev`
- **响应格式**: Markdown
- **请求方法**: GET

## 可用接口

### 1. 🏠 API 文档首页
**端点**: `/`

获取完整的 API 文档和所有可用接口的说明。

**示例请求**:
```
GET /
```

### 2. 📰 财经快讯
**端点**: `/telegraph`

获取全球财经快讯数据，支持优先级、时间范围和数据源筛选。

**查询参数**:
| 参数 | 描述 | 可选值 | 默认值 | 示例 |
|------|------|--------|--------|------|
| priority | 优先级过滤 | 1/2/3/ALL | ALL | ?priority=1 |
| duration | 时间范围 | Nd（N为天数） | 0d | ?duration=-3d |
| sources | 数据源 | cls,mknews,gelonghui | cls,mknews,gelonghui | ?sources=cls |

**参数说明**:
- `priority`:
  - `1` = 最高优先级（CLS A级 + MK News 重要 + 格隆汇 level=1）
  - `2` = 高优先级（CLS A+B级 + MK News）
  - `3` = 所有新闻
  - `ALL` = 所有新闻（同3）
- `duration`:
  - `0d` = 今天
  - `-1d` = 昨天
  - `-3d` = 最近3天（今天+昨天+前天）
  - 负数表示从今天往前的N天聚合数据
- `sources`:
  - `cls` = 数据源A
  - `mknews` = MK News
  - `gelonghui` = 格隆汇
  - 可组合多个，用逗号分隔

**使用示例**:
```
# 获取最高优先级的今天快讯（按时间排序）
GET /telegraph?priority=1&duration=0d

# 获取最近3天的所有快讯（按时间排序）
GET /telegraph?duration=-3d

# 获取高优先级的所有数据源快讯（按时间排序）
GET /telegraph?priority=2&sources=cls,mknews,gelonghui
```

> 注意：电报快讯按时间倒序排列（最新消息在前），priority 参数用于过滤而不是排序。

### 3. 🔄 刷新快数据
**端点**: `/telegraph/refresh`

手动刷新并存储最新的财经快讯数据。

**查询参数**:
| 参数 | 描述 | 可选值 | 默认值 | 示例 |
|------|------|--------|--------|------|
| sources | 要刷新的数据源 | cls,mknews,gelonghui | cls,mknews,gelonghui | ?sources=cls |

**使用示例**:
```
# 刷新所有数据源
GET /telegraph/refresh

# 只刷新特定数据源
GET /telegraph/refresh?sources=cls
```

### 4. 📊 市场情绪
**端点**: `/emotion`

获取市场情绪指标，包括市场温度、成交量、封板率等。

**使用示例**:
```
GET /emotion
```

### 5. 🚀 涨停池分析
**端点**: `/uppool`

获取涨停股票分析数据，包含涨停原因和板块信息。

**使用示例**:
```
GET /uppool
```

### 6. 📉 跌停池分析
**端点**: `/downpool`

获取跌停股票分析数据，包含跌停原因和板块信息。

**使用示例**:
```
GET /downpool
```

### 7. 🔁 连板池分析
**端点**: `/chainpool`

获取连板股票分析数据，包含连板原因和板块信息。

**使用示例**:
```
GET /chainpool
```

### 8. 💥 炸板池分析
**端点**: `/brokenpool`

获取炸板股票分析数据，包含炸板原因和板块信息。

**使用示例**:
```
GET /brokenpool
```

### 9. 📈 大盘联动
**端点**: `/anchor`

获取板块涨跌与大盘的关联分析数据。

**使用示例**:
```
GET /anchor
```

### 10. 💰 融资融券
**端点**: `/finance`

获取沪深两市融资融券数据统计。

**使用示例**:
```
GET /finance
```

### 10.1 📊 个股融资净买入排行
**端点**: `/margin-rank`

获取个股融资净买入排行数据（东方财富数据中心），自动使用最新交易日数据，按融资净买入降序排列，展示前100只个股。

**使用示例**:
```
GET /margin-rank
```

### 10.2 📐 股指期货行情
**端点**: `/futures-index`

获取中金所股指期货（IC/IF/IH/IM）当前所有活跃合约的实时行情，包含最新价、涨跌幅、开高低、昨结算价、成交量和持仓量。

**使用示例**:
```
GET /futures-index
```

### 10.3 🏦 中美国债收益率
**端点**: `/treasury-yield`

获取中美国债收益率（东方财富数据中心，近30个交易日）：中国 2/5/10/30 年及 10Y-2Y 期限利差、美国 2/5/10/30 年及 10Y-2Y、中美 10 年期利差与日变动(BP)。美债为 T-1 口径。

**使用示例**:
```
GET /treasury-yield
```

### 11. 🎯 概念板块
**端点**: `/concept`

获取概念板块涨跌统计和资金流向数据。

**使用示例**:
```
GET /concept
```

### 12. 📚 全量汇总
**端点**: `/summary`

汇总输出 `/emotion`、`/anchor`、`/finance`、`/concept`、`/telegraph`、`/uppool`、`/downpool`、`/chainpool` 和 `/brokenpool` 的所有信息。

**查询参数**: 与 `/telegraph` 一致（`priority`、`duration`、`sources`）。

**使用示例**:
```
GET /summary
```

### 13. 🏢 股票信息
**端点**: `/stock`

查询指定股票的基本信息。

**查询参数**:
| 参数 | 描述 | 必填 | 示例 |
|------|------|------|------|
| code | 股票代码 | 是 | ?code=sz002461 |

**股票代码格式**:
- 深交所：sz + 6位数字（如：sz002461）
- 上交所：sh + 6位数字（如：sh600036）

**使用示例**:
```
# 查询深交所股票
GET /stock?code=sz002461

# 查询上交所股票
GET /stock?code=sh600036
```

### 14. 📊 盘口快照
**端点**: `/quote`

查询股票或ETF基金的盘口快照数据，包括五档行情、实时价格、涨跌幅等。

**查询参数**:
| 参数 | 描述 | 必填 | 示例 |
|------|------|------|------|
| id | 单个股票/基金代码 | 否（id/ids二选一） | ?id=000001 |
| ids | 批量股票/基金代码，英文逗号分隔 | 否（id/ids二选一） | ?ids=000001,000002,510300 |

**代码格式**:
- 股票：6位数字代码（如：000001、600036）
- ETF基金：6位数字代码（如：159980、510300）

**使用示例**:
```
# 查询平安银行盘口
GET /quote?id=000001

# 查询有色ETF盘口
GET /quote?id=159980

# 批量查询盘口
GET /quote?ids=000001,000002,510300
```

### 15. 📉 K线数据
**端点**: `/kline`

查询股票或ETF基金的K线数据，默认返回日线前复权最近100条。
传入 signals/signal 时，会把对应指标值追加为"最新K线"和"K线列表"的列。

**查询参数**:
| 参数 | 描述 | 必填 | 默认值 | 示例 |
|------|------|------|--------|------|
| code | 股票/基金代码，支持 sh/sz 前缀 | code/id二选一 | - | ?code=sh605289 |
| id | 兼容参数，6位代码会自动推断交易所 | code/id二选一 | - | ?id=605289 |
| period | K线周期 | 否 | d | ?period=d |
| limit | 返回条数，最大300 | 否 | 100 | ?limit=100 |
| fq_type | 复权类型：0不复权、1前复权、2后复权 | 否 | 1 | ?fq_type=1 |
| signals/signal | 技术信号，支持 rsi,macd,sma,ema,all | 否 | - | ?signals=rsi,macd |
| rsi_period | RSI周期 | 否 | 14 | ?rsi_period=14 |
| sma_period | SMA周期 | 否 | 20 | ?sma_period=20 |
| ema_period | EMA周期 | 否 | 20 | ?ema_period=20 |
| macd_short | MACD短周期 | 否 | 12 | ?macd_short=12 |
| macd_long | MACD长周期 | 否 | 26 | ?macd_long=26 |
| macd_signal | MACD信号周期 | 否 | 9 | ?macd_signal=9 |

**使用示例**:
```
# 查询日线K线
GET /kline?code=sh605289&period=d&limit=100&fq_type=1

# 使用6位代码自动推断交易所
GET /kline?id=605289&limit=20

# 查询K线并追加技术信号
GET /kline?code=sh605289&signals=rsi,macd,sma,ema
```

## 使用场景示例

### 场景1：获取今日重要财经快讯
```
GET /telegraph?priority=1&duration=0d
```

### 场景2：查看最近3天所有快讯汇总
```
GET /telegraph?priority=ALL&duration=-3d&sources=cls,mknews,gelonghui
```

### 场景3：了解当前市场状况
```
# 查看市场情绪
GET /emotion

# 查看涨停情况
GET /uppool

# 查看跌停情况
GET /downpool

# 查看连板情况
GET /chainpool

# 查看炸板情况
GET /brokenpool

# 查看概念板块表现
GET /concept

# 按概念板块代码查询成分股（按资金净流入排序，多个代码用逗号聚合去重）
GET /plate-stocks?code=cls80025
GET /plate-stocks?code=cls80025,cls80198

# 一次性查看所有信息
GET /summary
```

### 场景4：查询特定股票信息
```
GET /stock?code=sz002461
```

### 场景5：刷新数据源
```
# 刷新特定数据源
GET /telegraph/refresh?sources=cls

# 刷新所有数据源
GET /telegraph/refresh
```

## 注意事项
1. 所有接口返回 Markdown 格式，便于阅读
2. 数据会定时自动刷新，也可手动刷新
3. 使用时请遵守相关数据源的使用条款
4. 股票代码必须包含交易所前缀（sz/sh）

## 错误处理
如果请求的路径不存在，会返回 404 状态码和可用路由列表。