---
name: 24topnews
description: 查询24TopNews中文财经事件、行业影响和完整客观正文，用于新闻简报、行业监测与研究。
homepage: https://24topnews.com/open-platform
metadata:
  openclaw:
    requires:
      bins:
        - curl
      env:
        - TOPNEWS_API_KEY
    primaryEnv: TOPNEWS_API_KEY
---

# 24TopNews 财经事件查询

当用户要求查询近期中文财经新闻、宏观事件、市场动态、公司事件、行业影响或生成财经简报时使用本Skill。

## API

- Base URL: `https://24topnews.com/api/v1`
- OpenAPI: `https://24topnews.com/api/v1/openapi.json`
- 完整调用规范: `https://24topnews.com/developers/agent-guide.md`
- 认证头：`Authorization: Bearer $TOPNEWS_API_KEY`
- 所有接口只读，只使用HTTPS GET。

## 查询流程

1. 用户给出中文行业名称但没有代码时，先请求 `/industries?level=2&q=关键词`，选择最匹配的二级行业代码。
2. 先请求 `/events` 获取短摘要，不要一开始就批量读取全文。
3. 使用时间、类型、行业、方向、重要度、影响强度和置信度缩小结果。
4. 只对最终相关事件请求 `/events/{id}` 读取完整正文和全部行业影响。
5. 需要下一页时，将 `pagination.next_cursor` 原样放入下一次请求的 `cursor`，不要解析或修改。

## 常用参数

- `range`: 24h、3d、7d、20d、60d、200d
- `type`: all、macro、domestic_macro、global_macro、market、industry、company
- `market`: all、A股、港股、美股、商品、其他
- `industry`: 二级行业代码，例如10.1；不要传中文名称
- `direction`: all、positive、negative、mixed
- `min_importance`、`min_impact`、`min_confidence`: 0—100
- `include=content`: 在列表中返回完整正文；通常优先使用详情接口
- `limit`: 1—50

## 调用示例

```bash
curl --fail --silent --show-error --get \
  'https://24topnews.com/api/v1/events' \
  -H "Authorization: Bearer $TOPNEWS_API_KEY" \
  --data-urlencode 'range=7d' \
  --data-urlencode 'industry=10.1' \
  --data-urlencode 'min_importance=50' \
  --data-urlencode 'min_confidence=70' \
  --data-urlencode 'limit=20'
```

## 输出规则

- 回答中注明API查询的时间窗口和筛选条件。
- 区分事件事实、24TopNews行业影响判断和你自己的综合推断。
- `importance` 表示新闻重要度，不等于证券预期收益。
- `impact` 正负值表示行业影响方向与强度，不是买卖信号。
- 市场行情新闻的 `impacts` 可能为空，不要补造行业影响。
- 多条事件存在相反方向时保留分歧，不要强行合并为单一结论。
- 不生成证券推荐、仓位建议或交易指令。

## 错误处理

- 400：修正参数，不要原样重试。
- 401/403：停止重试，报告密钥或权限问题。
- 404：跳过该事件。
- 429：读取 `Retry-After`，等待后降低并发重试。
- 500：按1秒、3秒、9秒退避，最多重试3次。

绝不输出、记录或在回答中复述 `TOPNEWS_API_KEY`。