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:

bash

# 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:

text

📊 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:

bash

# 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:

text

💰 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:

bash

# 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:

text

🌐 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:

bash

# 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:

text

⚡ 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]

bash

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 saysEndpoint pathlatest news / newsflash list / what's new/v1/newsflashlast 24 hours / past 24h / today's all news/v1/newsflash/24himportant news / major events / key headlines/v1/newsflash/importantoriginal newsflash / original coverage/v1/newsflash/originalfirst-report / exclusive / scoop/v1/newsflash/firston-chain news / on-chain data / on-chain updates/v1/newsflash/onchainfinancing news / fundraising / VC deals / investment rounds/v1/newsflash/financingprediction market / Polymarket / forecast / betting/v1/newsflash/predictionAI news / AI updates / AI projects / artificial intelligence/v1/newsflash/ai

Article category triggers and endpoints:

User saysEndpoint patharticle list / in-depth articles / latest articles/v1/articlelast 24 hours articles / today's articles (up to 50, no pagination)/v1/article/24himportant articles / key reports/v1/article/importantoriginal articles / original analysis/v1/article/original

Request example (AI newsflash):

bash

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:

text

📰 [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)#

EndpointURLAll newsflashesGET /v1/newsflashLast 24 hours (no pagination)GET /v1/newsflash/24hImportantGET /v1/newsflash/importantOriginalGET /v1/newsflash/originalFirst-reportGET /v1/newsflash/firstOn-chainGET /v1/newsflash/onchainFinancingGET /v1/newsflash/financingPrediction marketGET /v1/newsflash/predictionAIGET /v1/newsflash/aibash

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#

EndpointURLParamsAll articlesGET /v1/articlepage/size/langLast 24 hours (no pagination, up to 50)GET /v1/article/24hlang onlyImportantGET /v1/article/importantpage/size/langOriginalGET /v1/article/originalpage/size/lang

RSS Endpoints#

EndpointURLKey ParametersNewsflash RSSGET /v1/rss/newsflash``page size (1-50)Article RSSGET /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#

EndpointURLKey ParametersBTC ETF net inflowGET /v1/data/btc_etfnoneDaily on-chain volumeGET /v1/data/daily_txnoneIBIT/FBTC net inflowGET /v1/data/ibit_fbtcnoneStablecoin market capGET /v1/data/stablecoin_marketcapnoneCompliant exchange assetsGET /v1/data/compliant_totalnoneUS Treasury yieldGET /v1/data/us10y``type=1D/1W/1MDollar Index (DXY)GET /v1/data/dxy``type=1D/1W/1MGlobal M2 supplyGET /v1/data/m2_supply``type=3M/6M/1Y/3YBitfinex long positionsGET /v1/data/bitfinex_long``symbol=btc type=1D/1W/1M/h24Derivatives platform dataGET /v1/data/contract``dataType=1D/1W/1M/3M/6M/12MBuy/sell indicatorGET /v1/data/bottom_top_indicatornoneTop 10 on-chain net inflowGET /v1/data/top10_netflow``network=solana/base/ethereumExchange snapshotGET /v1/data/exchanges``name page size

---

Time Dimension Mapping#

User saysParametertoday / latest / real-timetype=1D or size=5this week / recenttype=1Wthis month / last 30 daystype=1Mthis year / long-term trendtype=1Y or type=3Ylast 24 hours (bitfinex_long only)type=h24

---

Intent Mapping#

User intentScenario / endpointHow's the market today / daily overviewScenario 1: Market OverviewCapital flow / on-chain trends / smart moneyScenario 2: Capital FlowMacro / M2 / US Treasuries / good time to enterScenario 3: Macro AssessmentFutures / open interest / exchange OI / leverage riskScenario 4: Derivativessearch [keyword]Scenario 5: SearchLatest news / newsflash listGET /v1/newsflashLast 24 hours / today all newsflashesGET /v1/newsflash/24hImportant newsflashesGET /v1/newsflash/importantOriginal newsflashesGET /v1/newsflash/originalFirst-report newsflashesGET /v1/newsflash/firstOn-chain newsflashesGET /v1/newsflash/onchainFinancing newsGET /v1/newsflash/financingPrediction market / PolymarketGET /v1/newsflash/predictionAI newsflashes / AI newsGET /v1/newsflash/aiArticle listGET /v1/articleLast 24 hours articles / today's articlesGET /v1/article/24hImportant articlesGET /v1/article/importantOriginal articlesGET /v1/article/originalBTC ETF inflowGET /v1/data/btc_etfIBIT FBTCGET /v1/data/ibit_fbtcStablecoin market cap / USDT USDCGET /v1/data/stablecoin_marketcapDollar index / DXYGET /v1/data/dxyBitfinex longs / leveraged positionsGET /v1/data/bitfinex_longBuy/sell signal / market sentimentGET /v1/data/bottom_top_indicatorTop inflow tokens / on-chain trendingGET /v1/data/top10_netflowExchange rankingsGET /v1/data/exchangesOn-chain volume / activityGET /v1/data/daily_txCompliant exchange assets / institutional custodyGET /v1/data/compliant_total

---

Data Refresh Frequency#

Endpoint typeUpdate frequencyNewsflash / articles / searchReal-timetop10_netflowNear real-timebtc_etf / ibit_fbtc / daily_txDaily (T+1)stablecoin_marketcap / compliant_totalDailybottom_top_indicatorDailyus10y / dxyIntraday minute-levelm2_supplyMonthlyexchanges / contractDailybitfinex_longDaily (h24 param is near real-time)

---

Error Handling#

Error conditionResponseBLOCKBEATS_API_KEY not setPrompt: Please set the BLOCKBEATS_API_KEY environment variable. Apply at: https://www.theblockbeats.info/status 100Missing API key — please provide your api-key headerstatus 101Invalid API key — please verify your keystatus 102API key expired — please renew your subscriptionstatus 103Invalid request method — check that you are using GETstatus -1General failure — display the message field contentRequest timeoutPrompt to retry; do not interrupt other parallel requestsdata is empty arrayExplain 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