---
name: 信息捕手/闪讯 skills-data-gateway
description: Query crypto news, market news, chat summaries, chat CA/URL context, and token usage from a protected HTTP gateway.
---

# Skills Data Gateway

Use this skill when an agent needs to query structured news, chat context, or token quota data from this service.

## When To Use

Use this skill when the task requires any of the following:

- Querying crypto news by token, keyword, language, or time window
- Querying traditional market news by keyword or stock
- Fetching important market news only
- Reading hourly chat summaries for a group
- Searching chat records for CA or URL mentions with nearby context
- Inspecting the current token's usage, limits, and usage history

## When Not To Use

Do not use this skill when:

- The task does not need these specific local data sources
- The caller does not have a valid `X-API-Token`
- The request needs unrestricted full-dataset export
- The task expects write access to business data rather than read/query access

## Public Entry Points

These routes are public and can be fetched without a token:

- `/skill.md`
- `/`
- `/docs`
- `/user`
- `/admin`

The actual business APIs still require token auth.

## Base URL

Assume the gateway is hosted at:

```text
https://skills.flashapi.top
```

Then this skill document is available at:

```text
https://skills.flashapi.top/skill.md
```

## Auth

All business APIs require:

```text
X-API-Token: your-token
```

If the token is invalid, the gateway returns:

```json
{
  "success": false,
  "error": "invalid api token"
}
```

## Suggested Workflow

1. Read this `skill.md`
2. Decide which capability is needed
3. Add `X-API-Token`
4. Prefer explicit time windows over broad queries
5. Respect query limits and recent-window restrictions

## Capabilities

### 1. Token Usage

Read the current token's quota, current hour/day/month counters, and historical aggregates.

Endpoint:

```text
GET /token/usage
```

Example:

```bash
curl -H 'X-API-Token: your-token' \
https://skills.flashapi.top/token/usage
```

### 2. Crypto News Search

Query crypto news by token or keyword.

Endpoint:

```text
GET /crypto_news/search
```

Useful query params:

- `lang=cn|en|all`
- `token=BTC`
- `keyword=ETF`
- `window=10m|1h|4h|24h|96h|all`
- `limit`

Examples:

```bash
curl -H 'X-API-Token: your-token' \
'https://skills.flashapi.top/crypto_news/search?token=BTC&window=24h'
```

```bash
curl -H 'X-API-Token: your-token' \
'https://skills.flashapi.top/crypto_news/search?keyword=ETF&window=4h'
```

### 3. Crypto Recent News

Query only the latest crypto news entry for a recent window.

Endpoint:

```text
GET /crypto_news/recent
```

Example:

```bash
curl -H 'X-API-Token: your-token' \
'https://skills.flashapi.top/crypto_news/recent?lang=all&window=1h'
```

### 4. Market News Search

Query traditional market news by keyword or stock.

Endpoint:

```text
GET /news/search
```

Examples:

```bash
curl -H 'X-API-Token: your-token' \
'https://skills.flashapi.top/news/search?keyword=大豆&window=4h'
```

```bash
curl -H 'X-API-Token: your-token' \
'https://skills.flashapi.top/news/search?stock=中信金属&window=24h'
```

### 5. Important Market News

Query important market news only.

Endpoint:

```text
GET /news/important
```

Example:

```bash
curl -H 'X-API-Token: your-token' \
'https://skills.flashapi.top/news/important?stock=中电港&window=24h'
```

### 6. Chat Summaries

Query hourly AI-generated chat summaries for a target group. Summaries include project mentions, sentiment analysis, and importance scoring.

Endpoint:

```text
GET /chat_summaries
```

**Available summary groups** (use `group` param to filter):

- `风寻聊天`
- `985聊天`
- `孙哥聊天`
- `猴哥聊天`
- `镭射猫聊天`
- `中国万岁聊天`
- `P总聊天`
- `羊群聊天`
- `嗯哼聊天`
- `0xKeyNG聊天`
- `crazySen聊天`
- `王老师聊天`
- `大宇聊天`
- `3D社区聊天`
- `CryptoD聊天`

Example:

```bash
curl -H 'X-API-Token: your-token' \
'https://skills.flashapi.top/chat_summaries?group=P总聊天&window=24h&limit=24'
```

### 7. Chat CA / URL Search

Search chat records for contract address (CA) or URL mentions and return ±3 surrounding context messages. Supports EVM (`0x...`) and Solana (Base58) address formats.

Endpoint:

```text
GET /chat_records/search
```

**Available groups for CA/URL search**:

- `985聊天`
- `风寻聊天`
- `大宇聊天`
- `猴哥聊天`
- `王老师聊天`
- `中国万岁聊天`
- `马丁森聊天`
- `孙哥聊天`
- `镭射猫聊天`
- `P总聊天`
- `crazySen聊天`
- `嗯哼聊天`
- `羊群聊天`
- `0xKeyNG聊天`
- `招财聊天`

Examples:

```bash
curl -H 'X-API-Token: your-token' \
'https://skills.flashapi.top/chat_records/search?type=ca&query=0x1234...'
```

```bash
curl -H 'X-API-Token: your-token' \
'https://skills.flashapi.top/chat_records/search?type=url&query=https://x.com/...'
```

```bash
curl -H 'X-API-Token: your-token' \
'https://skills.flashapi.top/chat_records/search?type=ca&group=P总聊天&limit=10'
```

## Constraints

Respect these rules when calling the gateway:

- Business APIs require `X-API-Token`
- News endpoints do not expose internal news IDs
- `window=all` on news search requires at least one search filter
- Recent news endpoints require explicit `window`
- Recent news endpoints only allow `10m`, `1h`, `4h`, `24h`
- Recent news endpoints return only one result
- Each token has hour/day/month quota limits
- Quotas may be both global and endpoint-specific

## Response Shape

Success:

```json
{
  "success": true,
  "timestamp": "2026-04-10T12:40:00+08:00",
  "data": {}
}
```

Failure:

```json
{
  "success": false,
  "timestamp": "2026-04-10T12:40:00+08:00",
  "error": "message"
}
```

## Good Query Patterns

- Prefer `window=24h` or smaller when possible
- Prefer a specific token, stock, or keyword over `all`
- Use `/token/usage` before issuing many requests if quota may be tight
- Use `/docs` if a human-readable walkthrough is needed

## Bad Query Patterns

- Requesting all news without filters
- Using recent endpoints as bulk export endpoints
- Assuming public page access also implies API access
- Ignoring quota failures and retrying blindly

## Related Routes

- Human homepage: `/`
- Human docs: `/docs`
- User console: `/user`
- Admin console: `/admin`