⚡

// Skill profile

BlockBeats API Skill

Name: BlockBeats API Skill
Author: blockbeatsofficial

name: blockbeats-skill

by blockbeatsofficial · published 2026-04-01

数据处理API集成

Total installs

Stars

★ 0

Last updated

2026-04

// Install command

$ claw add gh:blockbeatsofficial/blockbeatsofficial-blockbeats-skill

View on GitHub

// Full documentation

---

name: blockbeats-skill

description: BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also features robust keyword-based search functionality.

metadata:

openclaw:

emoji: "📰"

primaryEnv: BLOCKBEATS_API_KEY

install:

- id: curl

kind: brew

formula: curl

label: curl (HTTP client)

requires:

bins:

- curl

env:

- BLOCKBEATS_API_KEY

os:

- darwin

- linux

- win32

tags:

- crypto

- news

- market-data

- on-chain

- defi

version: 1.0.3

---

# BlockBeats API Skill

Query crypto newsflashes, articles, search results, and on-chain market data via the BlockBeats Pro API.

**Base URL**: `https://api-pro.theblockbeats.info`

**Auth**: All requests require Header `api-key: $BLOCKBEATS_API_KEY`

**Response format**: `{"status": 0, "message": "", "data": {...}}` — status 0 = success

---

Scenario 1: Market Overview

**Triggers**: How's the market today, market overview, daily summary, market conditions

Execute the following four requests in parallel:

# 1. Market sentiment index
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/bottom_top_indicator"

# 2. Important newsflashes (latest 5)
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/newsflash/important" \
  -G --data-urlencode "size=5" --data-urlencode "lang=en"

# 3. BTC ETF net inflow
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/btc_etf"

# 4. Daily on-chain transaction volume
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/daily_tx"

**Output format**:

📊 Market Overview · [Today's date]

Sentiment Index: [value] → [<20 potential buy zone / 20-80 neutral / >80 potential sell zone]
BTC ETF: Today net inflow [value] million USD, cumulative [value] million
On-chain Volume: Today [value] (vs yesterday [↑/↓][change%])
Key News:
  · [Title 1] [time]
  · [Title 2] [time]
  · [Title 3] [time]

**Interpretation rules**:

Sentiment < 20 → Alert user to potential opportunities

Sentiment > 80 → Warn about sell-off risk

ETF positive inflow 3 days in a row → Institutional accumulation signal

ETF net inflow > 500M/day → Strong buy signal

Rising on-chain volume → Increasing on-chain activity and market heat

---

Scenario 2: Capital Flow Analysis

**Triggers**: Where is capital flowing, on-chain trends, which tokens are being bought, stablecoins, smart money

Execute in parallel:

# 1. Top 10 tokens by on-chain net inflow (default solana; replace network param for Base/ETH)
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/top10_netflow" \
  -G --data-urlencode "network=solana"

# 2. Stablecoin market cap
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/stablecoin_marketcap"

# 3. BTC ETF net inflow
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/btc_etf"

Select `network` parameter based on user intent: `solana` (default) / `base` / `ethereum`

**Output format**:

💰 Capital Flow Analysis

On-chain Trending ([chain]):
  1. [token] Net inflow $[value]  Market cap $[value]
  2. ...

Stablecoins: USDT [↑/↓] USDC [↑/↓] (expansion/contraction signal)
Institutional: ETF today [inflow/outflow] [value] million USD

**Interpretation rules**:

Stablecoin market cap expanding → More capital in market, stronger buy potential

Stablecoin market cap shrinking → Capital exiting, caution advised

---

Scenario 3: Macro Environment Assessment

**Triggers**: Macro environment, is it a good time to enter, liquidity, US Treasuries, dollar, M2, big picture

Execute in parallel:

# 1. Global M2 supply
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/m2_supply" \
  -G --data-urlencode "type=1Y"

# 2. US 10Y Treasury yield
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/us10y" \
  -G --data-urlencode "type=1M"

# 3. DXY Dollar Index
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/dxy" \
  -G --data-urlencode "type=1M"

# 4. Compliant exchange total assets
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/compliant_total"

**Output format**:

🌐 Macro Environment Assessment

Global M2: [latest value] YoY [↑/↓][change%] → [expansionary/contractionary]
US Treasury Yield (10Y): [latest value]% → [rising/falling trend]
Dollar Index (DXY): [latest value] → [strong/weak]
Compliant Exchange Assets: $[value] → [inflow/outflow trend]

Overall: [bullish/neutral/bearish] for crypto market

**Interpretation rules**:

M2 YoY > 5% → Loose liquidity, favorable for risk assets

M2 YoY < 0% → Liquidity tightening, caution

DXY rising → Strong dollar, crypto under pressure

DXY falling → Weak dollar, crypto benefits

Rising Treasury yield → Higher risk-free rate, capital returning to bonds

Rising compliant exchange assets → Growing institutional allocation appetite

---

Scenario 4: Derivatives Market Analysis

**Triggers**: Futures market, long/short positioning, open interest, Binance Bybit OI, leverage risk

Execute in parallel:

# 1. Major derivatives platform comparison
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/contract" \
  -G --data-urlencode "dataType=1D"

# 2. Exchange snapshot
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/exchanges" \
  -G --data-urlencode "size=10"

# 3. Bitfinex BTC long positions
curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/data/bitfinex_long" \
  -G --data-urlencode "symbol=btc" --data-urlencode "type=1D"

**Output format**:

⚡ Derivatives Market Analysis

Platform OI:
  Binance [value]  Bybit [value]  Hyperliquid [value]

Exchange Rankings (by volume):
  1. [name] Volume $[value]  OI $[value]
  2. ...

Bitfinex BTC Longs: [value] → [increasing/decreasing] (leveraged long sentiment [strong/weak])

**Interpretation rules**:

Bitfinex longs persistently increasing → Large players bullish, market confidence growing

Bitfinex longs dropping sharply → Watch for long liquidation cascade

---

Scenario 5: Keyword Search

**Triggers**: search [keyword], find [keyword], [keyword] news, what's happening with [keyword]

curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/search" \
  -G --data-urlencode "name=[keyword]" --data-urlencode "size=10" --data-urlencode "lang=en"

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

---

Scenario 6: Newsflash & Article Lists

Select the appropriate newsflash category or article endpoint based on user intent. Default returns 10 items; use `size` param to adjust.

**Newsflash category triggers and endpoints**:

| User says | Endpoint path |

|-----------|--------------|

| latest news / newsflash list / what's new | `/v1/newsflash` |

| last 24 hours / past 24h / today's all news | `/v1/newsflash/24h` |

| important news / major events / key headlines | `/v1/newsflash/important` |

| original newsflash / original coverage | `/v1/newsflash/original` |

| first-report / exclusive / scoop | `/v1/newsflash/first` |

| on-chain news / on-chain data / on-chain updates | `/v1/newsflash/onchain` |

| financing news / fundraising / VC deals / investment rounds | `/v1/newsflash/financing` |

| prediction market / Polymarket / forecast / betting | `/v1/newsflash/prediction` |

| AI news / AI updates / AI projects / artificial intelligence | `/v1/newsflash/ai` |

**Article category triggers and endpoints**:

| User says | Endpoint path |

|-----------|--------------|

| article list / in-depth articles / latest articles | `/v1/article` |

| last 24 hours articles / today's articles (up to 50, no pagination) | `/v1/article/24h` |

| important articles / key reports | `/v1/article/important` |

| original articles / original analysis | `/v1/article/original` |

**Request example** (AI newsflash):

curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/newsflash/ai" \
  -G --data-urlencode "page=1" --data-urlencode "size=10" --data-urlencode "lang=en"

**Output format**:

📰 [Category Name] · Latest [N] items

1. [Title] [time_cn]
   [abstract, if available]

2. [Title] [time_cn]
   [abstract, if available]
...

**Notes**:

`content` field is HTML; strip tags and display plain text only

Article endpoints do NOT have a `url` field; use `link` for the article page URL

---

Single Endpoint Reference

Newsflash Endpoints (all support page/size/lang)

| Endpoint | URL |

|----------|-----|

| All newsflashes | `GET /v1/newsflash` |

| Last 24 hours (no pagination) | `GET /v1/newsflash/24h` |

| Important | `GET /v1/newsflash/important` |

| Original | `GET /v1/newsflash/original` |

| First-report | `GET /v1/newsflash/first` |

| On-chain | `GET /v1/newsflash/onchain` |

| Financing | `GET /v1/newsflash/financing` |

| Prediction market | `GET /v1/newsflash/prediction` |

| AI | `GET /v1/newsflash/ai` |

curl -s -H "api-key: $BLOCKBEATS_API_KEY" \
  "https://api-pro.theblockbeats.info/v1/newsflash/[type]" \
  -G --data-urlencode "page=1" --data-urlencode "size=10" --data-urlencode "lang=en"

Article Endpoints

| Endpoint | URL | Params |

|----------|-----|--------|

| All articles | `GET /v1/article` | page/size/lang |

| Last 24 hours (no pagination, up to 50) | `GET /v1/article/24h` | lang only |

| Important | `GET /v1/article/important` | page/size/lang |

| Original | `GET /v1/article/original` | page/size/lang |

RSS Endpoints

| Endpoint | URL | Key Parameters |

|----------|-----|----------------|

| Newsflash RSS | `GET /v1/rss/newsflash` | `page` `size` (1-50) |

| Article RSS | `GET /v1/rss/article` | `page` `size` (1-50) |

RSS endpoints return XML format. Use when user requests RSS feed or wants to subscribe to updates.

Data Endpoints

| Endpoint | URL | Key Parameters |

|----------|-----|----------------|

| BTC ETF net inflow | `GET /v1/data/btc_etf` | none |

| Daily on-chain volume | `GET /v1/data/daily_tx` | none |

| IBIT/FBTC net inflow | `GET /v1/data/ibit_fbtc` | none |

| Stablecoin market cap | `GET /v1/data/stablecoin_marketcap` | none |

| Compliant exchange assets | `GET /v1/data/compliant_total` | none |

| US Treasury yield | `GET /v1/data/us10y` | `type=1D/1W/1M` |

| Dollar Index (DXY) | `GET /v1/data/dxy` | `type=1D/1W/1M` |

| Global M2 supply | `GET /v1/data/m2_supply` | `type=3M/6M/1Y/3Y` |

| Bitfinex long positions | `GET /v1/data/bitfinex_long` | `symbol=btc` `type=1D/1W/1M/h24` |

| Derivatives platform data | `GET /v1/data/contract` | `dataType=1D/1W/1M/3M/6M/12M` |

| Buy/sell indicator | `GET /v1/data/bottom_top_indicator` | none |

| Top 10 on-chain net inflow | `GET /v1/data/top10_netflow` | `network=solana/base/ethereum` |

| Exchange snapshot | `GET /v1/data/exchanges` | `name` `page` `size` |

---

Time Dimension Mapping

| User says | Parameter |

|-----------|-----------|

| today / latest / real-time | `type=1D` or `size=5` |

| this week / recent | `type=1W` |

| this month / last 30 days | `type=1M` |

| this year / long-term trend | `type=1Y` or `type=3Y` |

| last 24 hours (bitfinex_long only) | `type=h24` |

---

Intent Mapping

| User intent | Scenario / endpoint |

|-------------|---------------------|

| How's the market today / daily overview | Scenario 1: Market Overview |

| Capital flow / on-chain trends / smart money | Scenario 2: Capital Flow |

| Macro / M2 / US Treasuries / good time to enter | Scenario 3: Macro Assessment |

| Futures / open interest / exchange OI / leverage risk | Scenario 4: Derivatives |

| search [keyword] | Scenario 5: Search |

| Latest news / newsflash list | `GET /v1/newsflash` |

| Last 24 hours / today all newsflashes | `GET /v1/newsflash/24h` |

| Important newsflashes | `GET /v1/newsflash/important` |

| Original newsflashes | `GET /v1/newsflash/original` |

| First-report newsflashes | `GET /v1/newsflash/first` |

| On-chain newsflashes | `GET /v1/newsflash/onchain` |

| Financing news | `GET /v1/newsflash/financing` |

| Prediction market / Polymarket | `GET /v1/newsflash/prediction` |

| AI newsflashes / AI news | `GET /v1/newsflash/ai` |

| Article list | `GET /v1/article` |

| Last 24 hours articles / today's articles | `GET /v1/article/24h` |

| Important articles | `GET /v1/article/important` |

| Original articles | `GET /v1/article/original` |

| BTC ETF inflow | `GET /v1/data/btc_etf` |

| IBIT FBTC | `GET /v1/data/ibit_fbtc` |

| Stablecoin market cap / USDT USDC | `GET /v1/data/stablecoin_marketcap` |

| Dollar index / DXY | `GET /v1/data/dxy` |

| Bitfinex longs / leveraged positions | `GET /v1/data/bitfinex_long` |

| Buy/sell signal / market sentiment | `GET /v1/data/bottom_top_indicator` |

| Top inflow tokens / on-chain trending | `GET /v1/data/top10_netflow` |

| Exchange rankings | `GET /v1/data/exchanges` |

| On-chain volume / activity | `GET /v1/data/daily_tx` |

| Compliant exchange assets / institutional custody | `GET /v1/data/compliant_total` |

---

Data Refresh Frequency

| Endpoint type | Update frequency |

|---------------|-----------------|

| Newsflash / articles / search | Real-time |

| top10_netflow | Near real-time |

| btc_etf / ibit_fbtc / daily_tx | Daily (T+1) |

| stablecoin_marketcap / compliant_total | Daily |

| bottom_top_indicator | Daily |

| us10y / dxy | Intraday minute-level |

| m2_supply | Monthly |

| exchanges / contract | Daily |

| bitfinex_long | Daily (h24 param is near real-time) |

---

Error Handling

| Error condition | Response |

|----------------|----------|

| `BLOCKBEATS_API_KEY` not set | Prompt: Please set the BLOCKBEATS_API_KEY environment variable. Apply at: https://www.theblockbeats.info/ |

| status 100 | Missing API key — please provide your api-key header |

| status 101 | Invalid API key — please verify your key |

| status 102 | API key expired — please renew your subscription |

| status 103 | Invalid request method — check that you are using GET |

| status -1 | General failure — display the `message` field content |

| Request timeout | Prompt to retry; do not interrupt other parallel requests |

| data is empty array | Explain possible reasons (non-trading day, data delay, no data for this token) |

Notes

`content` field is HTML; strip tags and display plain text only

`create_time` field format: `Y-m-d H:i:s`

Numeric fields (price/vol etc.) are strings; format as numbers when displaying

When running parallel requests, a failure on one endpoint must not block display of others

// Comments

// Related skills

More tools from the same signal band

Order food/drinks (点餐) on an Android device paired as an OpenClaw node. Uses in-app menu and cart; add goods, view cart, submit order (demo, no real payment).

Sign plugins, rotate agent credentials without losing identity, and publicly attest to plugin behavior with verifiable claims and authenticated transfers.

The philosophical layer for AI agents. Maps behavior to Spinoza's 48 affects, calculates persistence scores, and generates geometric self-reports. Give your...

日历管理数据处理

1 installs★ 0