\r \r

BlockBeats API Skill\r

\r Query crypto newsflashes, articles, search results, and on-chain market data via the BlockBeats Pro API.\r \r Base URL: https://api-pro.theblockbeats.info\r Auth: All requests require Header api-key: $BLOCKBEATS_API_KEY\r Response format: {"status": 0, "message": "", "data": {...}} — status 0 = success\r \r ---\r \r

Scenario 1: Market Overview\r

\r Triggers: How's the market today, market overview, daily summary, market conditions\r \r Execute the following four requests in parallel:\r \r

# 1. Market sentiment index\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/bottom_top_indicator"\r
\r
# 2. Important newsflashes (latest 5)\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/newsflash/important" \\r
  -G --data-urlencode "size=5" --data-urlencode "lang=en"\r
\r
# 3. BTC ETF net inflow\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/btc_etf"\r
\r
# 4. Daily on-chain transaction volume\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/daily_tx"\r
```\r
\r
**Output format**:\r
```\r
📊 Market Overview · [Today's date]\r
\r
Sentiment Index: [value] → [\x3C20 potential buy zone / 20-80 neutral / >80 potential sell zone]\r
BTC ETF: Today net inflow [value] million USD, cumulative [value] million\r
On-chain Volume: Today [value] (vs yesterday [↑/↓][change%])\r
Key News:\r
  · [Title 1] [time]\r
  · [Title 2] [time]\r
  · [Title 3] [time]\r
```\r
\r
**Interpretation rules**:\r
- Sentiment \x3C 20 → Alert user to potential opportunities\r
- Sentiment > 80 → Warn about sell-off risk\r
- ETF positive inflow 3 days in a row → Institutional accumulation signal\r
- ETF net inflow > 500M/day → Strong buy signal\r
- Rising on-chain volume → Increasing on-chain activity and market heat\r
\r
---\r
\r
## Scenario 2: Capital Flow Analysis\r
\r
**Triggers**: Where is capital flowing, on-chain trends, which tokens are being bought, stablecoins, smart money\r
\r
Execute in parallel:\r
\r
```bash\r
# 1. Top 10 tokens by on-chain net inflow (default solana; replace network param for Base/ETH)\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/top10_netflow" \\r
  -G --data-urlencode "network=solana"\r
\r
# 2. Stablecoin market cap\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/stablecoin_marketcap"\r
\r
# 3. BTC ETF net inflow\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/btc_etf"\r
```\r
\r
Select `network` parameter based on user intent: `solana` (default) / `base` / `ethereum`\r
\r
**Output format**:\r
```\r
💰 Capital Flow Analysis\r
\r
On-chain Trending ([chain]):\r
  1. [token] Net inflow $[value]  Market cap $[value]\r
  2. ...\r
\r
Stablecoins: USDT [↑/↓] USDC [↑/↓] (expansion/contraction signal)\r
Institutional: ETF today [inflow/outflow] [value] million USD\r
```\r
\r
**Interpretation rules**:\r
- Stablecoin market cap expanding → More capital in market, stronger buy potential\r
- Stablecoin market cap shrinking → Capital exiting, caution advised\r
\r
---\r
\r
## Scenario 3: Macro Environment Assessment\r
\r
**Triggers**: Macro environment, is it a good time to enter, liquidity, US Treasuries, dollar, M2, big picture\r
\r
Execute in parallel:\r
\r
```bash\r
# 1. Global M2 supply\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/m2_supply" \\r
  -G --data-urlencode "type=1Y"\r
\r
# 2. US 10Y Treasury yield\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/us10y" \\r
  -G --data-urlencode "type=1M"\r
\r
# 3. DXY Dollar Index\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/dxy" \\r
  -G --data-urlencode "type=1M"\r
\r
# 4. Compliant exchange total assets\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/compliant_total"\r
```\r
\r
**Output format**:\r
```\r
🌐 Macro Environment Assessment\r
\r
Global M2: [latest value] YoY [↑/↓][change%] → [expansionary/contractionary]\r
US Treasury Yield (10Y): [latest value]% → [rising/falling trend]\r
Dollar Index (DXY): [latest value] → [strong/weak]\r
Compliant Exchange Assets: $[value] → [inflow/outflow trend]\r
\r
Overall: [bullish/neutral/bearish] for crypto market\r
```\r
\r
**Interpretation rules**:\r
- M2 YoY > 5% → Loose liquidity, favorable for risk assets\r
- M2 YoY \x3C 0% → Liquidity tightening, caution\r
- DXY rising → Strong dollar, crypto under pressure\r
- DXY falling → Weak dollar, crypto benefits\r
- Rising Treasury yield → Higher risk-free rate, capital returning to bonds\r
- Rising compliant exchange assets → Growing institutional allocation appetite\r
\r
---\r
\r
## Scenario 4: Derivatives Market Analysis\r
\r
**Triggers**: Futures market, long/short positioning, open interest, Binance Bybit OI, leverage risk\r
\r
Execute in parallel:\r
\r
```bash\r
# 1. Major derivatives platform comparison\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/contract" \\r
  -G --data-urlencode "dataType=1D"\r
\r
# 2. Exchange snapshot\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/exchanges" \\r
  -G --data-urlencode "size=10"\r
\r
# 3. Bitfinex BTC long positions\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/data/bitfinex_long" \\r
  -G --data-urlencode "symbol=btc" --data-urlencode "type=1D"\r
```\r
\r
**Output format**:\r
```\r
⚡ Derivatives Market Analysis\r
\r
Platform OI:\r
  Binance [value]  Bybit [value]  Hyperliquid [value]\r
\r
Exchange Rankings (by volume):\r
  1. [name] Volume $[value]  OI $[value]\r
  2. ...\r
\r
Bitfinex BTC Longs: [value] → [increasing/decreasing] (leveraged long sentiment [strong/weak])\r
```\r
\r
**Interpretation rules**:\r
- Bitfinex longs persistently increasing → Large players bullish, market confidence growing\r
- Bitfinex longs dropping sharply → Watch for long liquidation cascade\r
\r
---\r
\r
## Scenario 5: Keyword Search\r
\r
**Triggers**: search [keyword], find [keyword], [keyword] news, what's happening with [keyword]\r
\r
```bash\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/search" \\r
  -G --data-urlencode "name=[keyword]" --data-urlencode "size=10" --data-urlencode "lang=en"\r
```\r
\r
Response fields: `title`, `abstract`, `content` (plain text), `type` (0=article, 1=newsflash), `time_cn` (relative time), `img_url`, `url`; pagination object: `total`, `page`, `size`, `total_pages`; `size` max 100\r
\r
---\r
\r
## Scenario 6: Newsflash & Article Lists\r
\r
Select the appropriate newsflash category or article endpoint based on user intent. Default returns 10 items; use `size` param to adjust.\r
\r
**Newsflash category triggers and endpoints**:\r
\r
| User says | Endpoint path |\r
|-----------|--------------|\r
| latest news / newsflash list / what's new | `/v1/newsflash` |\r
| last 24 hours / past 24h / today's all news | `/v1/newsflash/24h` |\r
| important news / major events / key headlines | `/v1/newsflash/important` |\r
| original newsflash / original coverage | `/v1/newsflash/original` |\r
| first-report / exclusive / scoop | `/v1/newsflash/first` |\r
| on-chain news / on-chain data / on-chain updates | `/v1/newsflash/onchain` |\r
| financing news / fundraising / VC deals / investment rounds | `/v1/newsflash/financing` |\r
| prediction market / Polymarket / forecast / betting | `/v1/newsflash/prediction` |\r
| AI news / AI updates / AI projects / artificial intelligence | `/v1/newsflash/ai` |\r
\r
**Article category triggers and endpoints**:\r
\r
| User says | Endpoint path |\r
|-----------|--------------|\r
| article list / in-depth articles / latest articles | `/v1/article` |\r
| last 24 hours articles / today's articles (up to 50, no pagination) | `/v1/article/24h` |\r
| important articles / key reports | `/v1/article/important` |\r
| original articles / original analysis | `/v1/article/original` |\r
\r
**Request example** (AI newsflash):\r
\r
```bash\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/newsflash/ai" \\r
  -G --data-urlencode "page=1" --data-urlencode "size=10" --data-urlencode "lang=en"\r
```\r
\r
**Output format**:\r
\r
```\r
📰 [Category Name] · Latest [N] items\r
\r
1. [Title] [time_cn]\r
   [abstract, if available]\r
\r
2. [Title] [time_cn]\r
   [abstract, if available]\r
...\r
```\r
\r
**Notes**:\r
- `content` field is HTML; strip tags and display plain text only\r
- Article endpoints do NOT have a `url` field; use `link` for the article page URL\r
\r
---\r
\r
## Single Endpoint Reference\r
\r
### Newsflash Endpoints (all support page/size/lang)\r
\r
| Endpoint | URL |\r
|----------|-----|\r
| All newsflashes | `GET /v1/newsflash` |\r
| Last 24 hours (no pagination) | `GET /v1/newsflash/24h` |\r
| Important | `GET /v1/newsflash/important` |\r
| Original | `GET /v1/newsflash/original` |\r
| First-report | `GET /v1/newsflash/first` |\r
| On-chain | `GET /v1/newsflash/onchain` |\r
| Financing | `GET /v1/newsflash/financing` |\r
| Prediction market | `GET /v1/newsflash/prediction` |\r
| AI | `GET /v1/newsflash/ai` |\r
\r
```bash\r
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \\r
  "https://api-pro.theblockbeats.info/v1/newsflash/[type]" \\r
  -G --data-urlencode "page=1" --data-urlencode "size=10" --data-urlencode "lang=en"\r
```\r
\r
### Article Endpoints\r
\r
| Endpoint | URL | Params |\r
|----------|-----|--------|\r
| All articles | `GET /v1/article` | page/size/lang |\r
| Last 24 hours (no pagination, up to 50) | `GET /v1/article/24h` | lang only |\r
| Important | `GET /v1/article/important` | page/size/lang |\r
| Original | `GET /v1/article/original` | page/size/lang |\r
\r
### RSS Endpoints\r
\r
| Endpoint | URL | Key Parameters |\r
|----------|-----|----------------|\r
| Newsflash RSS | `GET /v1/rss/newsflash` | `page` `size` (1-50) |\r
| Article RSS | `GET /v1/rss/article` | `page` `size` (1-50) |\r
\r
RSS endpoints return XML format. Use when user requests RSS feed or wants to subscribe to updates.\r
\r
### Data Endpoints\r
\r
| Endpoint | URL | Key Parameters |\r
|----------|-----|----------------|\r
| BTC ETF net inflow | `GET /v1/data/btc_etf` | none |\r
| Daily on-chain volume | `GET /v1/data/daily_tx` | none |\r
| IBIT/FBTC net inflow | `GET /v1/data/ibit_fbtc` | none |\r
| Stablecoin market cap | `GET /v1/data/stablecoin_marketcap` | none |\r
| Compliant exchange assets | `GET /v1/data/compliant_total` | none |\r
| US Treasury yield | `GET /v1/data/us10y` | `type=1D/1W/1M` |\r
| Dollar Index (DXY) | `GET /v1/data/dxy` | `type=1D/1W/1M` |\r
| Global M2 supply | `GET /v1/data/m2_supply` | `type=3M/6M/1Y/3Y` |\r
| Bitfinex long positions | `GET /v1/data/bitfinex_long` | `symbol=btc` `type=1D/1W/1M/h24` |\r
| Derivatives platform data | `GET /v1/data/contract` | `dataType=1D/1W/1M/3M/6M/12M` |\r
| Buy/sell indicator | `GET /v1/data/bottom_top_indicator` | none |\r
| Top 10 on-chain net inflow | `GET /v1/data/top10_netflow` | `network=solana/base/ethereum` |\r
| Exchange snapshot | `GET /v1/data/exchanges` | `name` `page` `size` |\r
\r
---\r
\r
## Time Dimension Mapping\r
\r
| User says | Parameter |\r
|-----------|-----------|\r
| today / latest / real-time | `type=1D` or `size=5` |\r
| this week / recent | `type=1W` |\r
| this month / last 30 days | `type=1M` |\r
| this year / long-term trend | `type=1Y` or `type=3Y` |\r
| last 24 hours (bitfinex_long only) | `type=h24` |\r
\r
---\r
\r
## Intent Mapping\r
\r
| User intent | Scenario / endpoint |\r
|-------------|---------------------|\r
| How's the market today / daily overview | Scenario 1: Market Overview |\r
| Capital flow / on-chain trends / smart money | Scenario 2: Capital Flow |\r
| Macro / M2 / US Treasuries / good time to enter | Scenario 3: Macro Assessment |\r
| Futures / open interest / exchange OI / leverage risk | Scenario 4: Derivatives |\r
| search [keyword] | Scenario 5: Search |\r
| Latest news / newsflash list | `GET /v1/newsflash` |\r
| Last 24 hours / today all newsflashes | `GET /v1/newsflash/24h` |\r
| Important newsflashes | `GET /v1/newsflash/important` |\r
| Original newsflashes | `GET /v1/newsflash/original` |\r
| First-report newsflashes | `GET /v1/newsflash/first` |\r
| On-chain newsflashes | `GET /v1/newsflash/onchain` |\r
| Financing news | `GET /v1/newsflash/financing` |\r
| Prediction market / Polymarket | `GET /v1/newsflash/prediction` |\r
| AI newsflashes / AI news | `GET /v1/newsflash/ai` |\r
| Article list | `GET /v1/article` |\r
| Last 24 hours articles / today's articles | `GET /v1/article/24h` |\r
| Important articles | `GET /v1/article/important` |\r
| Original articles | `GET /v1/article/original` |\r
| BTC ETF inflow | `GET /v1/data/btc_etf` |\r
| IBIT FBTC | `GET /v1/data/ibit_fbtc` |\r
| Stablecoin market cap / USDT USDC | `GET /v1/data/stablecoin_marketcap` |\r
| Dollar index / DXY | `GET /v1/data/dxy` |\r
| Bitfinex longs / leveraged positions | `GET /v1/data/bitfinex_long` |\r
| Buy/sell signal / market sentiment | `GET /v1/data/bottom_top_indicator` |\r
| Top inflow tokens / on-chain trending | `GET /v1/data/top10_netflow` |\r
| Exchange rankings | `GET /v1/data/exchanges` |\r
| On-chain volume / activity | `GET /v1/data/daily_tx` |\r
| Compliant exchange assets / institutional custody | `GET /v1/data/compliant_total` |\r
\r
---\r
\r
## Data Refresh Frequency\r
\r
| Endpoint type | Update frequency |\r
|---------------|-----------------|\r
| Newsflash / articles / search | Real-time |\r
| top10_netflow | Near real-time |\r
| btc_etf / ibit_fbtc / daily_tx | Daily (T+1) |\r
| stablecoin_marketcap / compliant_total | Daily |\r
| bottom_top_indicator | Daily |\r
| us10y / dxy | Intraday minute-level |\r
| m2_supply | Monthly |\r
| exchanges / contract | Daily |\r
| bitfinex_long | Daily (h24 param is near real-time) |\r
\r
---\r
\r
## Error Handling\r
\r
| Error condition | Response |\r
|----------------|----------|\r
| `BLOCKBEATS_API_KEY` not set | Prompt: Please set the BLOCKBEATS_API_KEY environment variable. Apply at: https://www.theblockbeats.info/ |\r
| status 100 | Missing API key — please provide your api-key header |\r
| status 101 | Invalid API key — please verify your key |\r
| status 102 | API key expired — please renew your subscription |\r
| status 103 | Invalid request method — check that you are using GET |\r
| status -1 | General failure — display the `message` field content |\r
| Request timeout | Prompt to retry; do not interrupt other parallel requests |\r
| data is empty array | Explain possible reasons (non-trading day, data delay, no data for this token) |\r
\r
## Notes\r
\r
- `content` field is HTML; strip tags and display plain text only\r
- `create_time` field format: `Y-m-d H:i:s`\r
- Numeric fields (price/vol etc.) are strings; format as numbers when displaying\r
- When running parallel requests, a failure on one endpoint must not block display of others\r