Authentication
Every API request must carry your token in a header:
X-API-Token: your-token-here
Tokens are issued on purchase: Telegram @CryptoDoge2025 / WeChat coecvyy.
Each token has hourly, daily and monthly quotas, both global and per endpoint. Requests over quota return 429.
Time windows
Most endpoints accept a window parameter:
| Value | Meaning | Notes |
|---|---|---|
| 10m | Last 10 minutes | |
| 1h | Last hour | |
| 4h | Last 4 hours | |
| 24h | Last 24 hours | |
| 72h | Last 72 hours (3 days) | |
| 3d | Same as 72h | |
| all | Everything available | Requires at least one search condition |
Crypto news · search
GET /crypto_news/search
| Parameter | Type | Description |
|---|---|---|
| langoptional | string | Language: cn / en / all (default all) |
| tokenoptional | string | Filter by AI-extracted token tag (e.g. BTC, ETH) |
| keywordoptional | string | Keyword matched against title, description, translation and source |
| windowoptional | string | Time window, default all |
| limitoptional | int | Max results, default 20 |
curl -H "X-API-Token: sk-xxx" "https://skill.xxbs.club/crypto_news/search?token=BTC&window=4h"
Crypto news · latest
GET /crypto_news/recent
| Parameter | Type | Description |
|---|---|---|
| windowrequired | string | Time window (10m / 1h / 4h / 24h / 72h only) |
| langoptional | string | Language filter |
| limitoptional | int | Optional cap; without it every result in the window is returned, newest first |
Returns the latest news in the window. window is required; without limit you get every result in the window.
curl -H "X-API-Token: sk-xxx" "https://skill.xxbs.club/crypto_news/recent?lang=all&window=1h&limit=10"
Market news · search
GET /news/search
| Parameter | Type | Description |
|---|---|---|
| keywordoptional | string | Keyword search |
| stockoptional | string | Stock ticker or name |
| windowoptional | string | Time window, default all |
| limitoptional | int | Max results, default 20, max 100 |
Results include a stock_analyses field that aggregates news stats per stock.
curl -H "X-API-Token: sk-xxx" "https://skill.xxbs.club/news/search?stock=NVDA&window=24h"
Market news · latest
GET /news/recent
Same parameters as search, but window is required (10m / 1h / 4h / 24h / 72h only). Supports limit; without it every result in the window is returned, newest first.
curl -H "X-API-Token: sk-xxx" "https://skill.xxbs.club/news/recent?window=1h&limit=10"
Market news · important
GET /news/important
Same parameters as search; returns only news flagged as important.
Chat summaries
GET /chat_summaries
| Parameter | Type | Description |
|---|---|---|
| groupoptional | string | Exact group name |
| windowoptional | string | Time window, default 24h |
| limitoptional | int | Max results, default 24 |
Hourly AI summaries of group chats, with projects mentioned, sentiment and an importance score.
Channel discovery
GET /meta/channels
Lists the news sources, sub-channels and chat groups you can query right now. Call it before other requests and never hard-code channel or group names; it stays in sync when the backend changes. Requires a token but is not rate limited.
- news_groups[].category: crypto (use with /crypto_news/*) or market (use with /news/*)
- news_groups[].sources: de-duplicated source names in the group
- news_groups[].channels: sub-channels, if any
- chat_groups: groups you can pass to /chat_summaries and /chat_records/search
curl -H "X-API-Token: sk-xxx" "https://skill.xxbs.club/meta/channels"
Chat record search
GET /chat_records/search
| Parameter | Type | Description |
|---|---|---|
| typerequired | string | Search type: ca (contract address) or url |
| groupoptional | string | Group filter (values from chat_groups in /meta/channels) |
| queryoptional | string | Exact CA or URL |
| limitoptional | int | Max results, default 20 |
Each hit includes the match plus the 3 messages before and after it in the same group. EVM (0x…) and Solana (Base58) addresses are recognised. If a contract snapshot exists for the CA, the hit also carries ca_info (chain, market cap, narrative; timestamps in Beijing time).
Usage
GET /token/usage
No parameters. Returns quota usage for the current token, including:
- Global quota usage and limits (hour / day / month)
- Per-endpoint quota usage and limits
- Call history aggregated by hour, day and month