认证方式
所有 API 请求需在 Header 中携带 Token：
X-API-Token: your-token-here
Token 支持三级配额限制：小时 / 天 / 月，同时支持全局和按端点独立配额。超出配额返回 429。
时间窗口
多数接口支持 window 参数，可选值：
| 值 | 含义 | 备注 |
|---|---|---|
| 10m | 最近 10 分钟 | |
| 1h | 最近 1 小时 | |
| 4h | 最近 4 小时 | |
| 24h | 最近 24 小时 | |
| 72h | 最近 72 小时（3 天） | |
| 3d | 同 72h | |
| all | 全部数据 | 需至少提供一个搜索条件 |
加密新闻 — 搜索
GET /crypto_news/search
| 参数 | 类型 | 说明 |
|---|---|---|
| lang可选 | string | 语言：cn / en / all（默认 all） |
| token可选 | string | 按 AI 提取的 Token 标签过滤（如 BTC、ETH） |
| keyword可选 | string | 关键词，匹配标题/描述/翻译/来源 |
| window可选 | string | 时间窗口，默认 all |
| limit可选 | int | 返回条数上限，默认 20 |
curl -H "X-API-Token: sk-xxx" "https://skill.xxbs.club/crypto_news/search?token=BTC&window=4h"
加密新闻 — 最新
GET /crypto_news/recent
| 参数 | 类型 | 说明 |
|---|---|---|
| window必填 | string | 时间窗口（仅 10m/1h/4h/24h/72h） |
| lang可选 | string | 语言过滤 |
| limit可选 | int | 可选返回条数上限；不传则返回时间窗口内全部结果，按时间倒序 |
返回最近窗口内的最新新闻列表，window 必填；不传 limit 时返回窗口内全部结果。
curl -H "X-API-Token: sk-xxx" "https://skill.xxbs.club/crypto_news/recent?lang=all&window=1h&limit=10"
市场新闻 — 搜索
GET /news/search
| 参数 | 类型 | 说明 |
|---|---|---|
| keyword可选 | string | 关键词搜索 |
| stock可选 | string | 股票代码或名称 |
| window可选 | string | 时间窗口，默认 all |
| limit可选 | int | 返回条数上限，默认 20，最大 100 |
返回结果包含 stock_analyses 字段，自动聚合个股新闻统计。
curl -H "X-API-Token: sk-xxx" "https://skill.xxbs.club/news/search?stock=贵州茅台&window=24h"
市场新闻 — 最新
GET /news/recent
参数同搜索接口，window 为必填（仅 10m/1h/4h/24h/72h）；支持 limit，不传则返回时间窗口内全部结果，按时间倒序返回最新结果。
curl -H "X-API-Token: sk-xxx" "https://skill.xxbs.club/news/recent?window=1h&limit=10"
市场新闻 — 重要
GET /news/important
参数同搜索接口，仅返回标记为重要的新闻。
群聊摘要
GET /chat_summaries
| 参数 | 类型 | 说明 |
|---|---|---|
| group可选 | string | 群名精确匹配 |
| window可选 | string | 时间窗口，默认 24h |
| limit可选 | int | 返回条数上限，默认 24 |
返回 AI 生成的小时级群聊总结，含项目提及、情绪分析、重要度评分。
渠道发现
GET /meta/channels
动态返回当前可查询的新闻来源、子频道与群聊目录。建议先调它再发其他请求，不要写死渠道或群名——后端调整时该接口自动同步。需要 Token，但不计入限流。
- news_groups[].category：crypto（配 /crypto_news/*）或 market（配 /news/*）
- news_groups[].sources：该分组下的去重来源名
- news_groups[].channels：子频道（如有）
- chat_groups：可用于 /chat_summaries 与 /chat_records/search 的群
curl -H "X-API-Token: sk-xxx" "https://skill.xxbs.club/meta/channels"
群聊记录搜索
GET /chat_records/search
| 参数 | 类型 | 说明 |
|---|---|---|
| type必填 | string | 搜索类型：ca（合约地址）或 url |
| group可选 | string | 群名过滤（可选值见 /meta/channels 的 chat_groups） |
| query可选 | string | 精确匹配 CA 或 URL |
| limit可选 | int | 返回条数上限，默认 20 |
每条结果包含匹配项及其前后 ±3 条同群消息作为上下文。支持 EVM（0x...）和 Solana（Base58）合约地址识别。命中的 CA 若已有合约信息快照，会附带 ca_info（链、市值、叙事等快照，时间为北京时间）。
用量查询
GET /token/usage
无需额外参数，返回当前 Token 的配额使用情况，包含：
- 全局配额（小时/天/月）使用量与上限
- 各端点独立配额使用量与上限
- 历史调用记录（按小时/天/月聚合）