blockbeats--skill

BlockBeats Skill covers over 1,500 information sources, including AI-driven insights, Hyperliquid on-chain data, and Polymarket market analytics. It also fea...

Security Scan

The skill's requirements (curl + BLOCKBEATS_API_KEY) and runtime instructions (curl calls to api-pro.theblockbeats.info) match its stated purpose of querying BlockBeats market and news APIs; nothing requested appears disproportionate or unrelated.

Purpose & Capability

Name/description advertise crypto news, on-chain and market analytics. The skill only asks for curl and a BLOCKBEATS_API_KEY and the SKILL.md contains explicit curl calls to the documented BlockBeats Pro API endpoints—these requirements are appropriate and proportional.

Instruction Scope

SKILL.md contains explicit curl command templates that send the API key in an `api-key` header to https://api-pro.theblockbeats.info and describes specific endpoints and interpretation rules. The instructions do not reference unrelated files, other environment variables, or system paths. The skill does instruct the agent to perform parallel requests and to interpret results into trading signals (expected for this domain).

Install Mechanism

Install spec only recommends brew formula `curl`. Installing curl via brew is a standard, low-risk mechanism; many systems already include curl so installation may be unnecessary. No arbitrary downloads or extract steps are present.

Credentials

Only a single credential (BLOCKBEATS_API_KEY) is required and is the primary credential declared. The API key is used directly in requests to the stated BlockBeats API host, which is consistent with the skill's purpose. No additional unrelated secrets or config paths are requested.

Persistence & Privilege

The skill does not request permanent/always-on inclusion (always=false) and does not modify other skills or system-wide settings. The default ability for the agent to invoke the skill autonomously is present but not combined with other elevated privileges.

Assessment

This skill appears coherent: it simply wraps BlockBeats Pro API calls and needs one API key. Before installing, confirm the BLOCKBEATS_API_KEY you provide is scoped appropriately and is not a high-privilege credential used elsewhere. Verify you trust the skill publisher (no homepage/source provided) because the skill will send the API key to api-pro.theblockbeats.info. Check that agent logs or telemetry will not persist the key in plaintext. If you are unsure, create a dedicated/test API key with limited permissions or rotate the key after testing. Also remember the skill produces trading signals—treat those as informational, not financial advice.

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