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:
CODEBLOCK0
Output format:
CODEBLOCK1
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:
CODEBLOCK2
Select network parameter based on user intent: solana (default) / base / INLINECODE6
Output format:
CODEBLOCK3
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:
CODEBLOCK4
Output format:
CODEBLOCK5
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:
CODEBLOCK6
Output format:
CODEBLOCK7
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]
CODEBLOCK8
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 | INLINECODE20 |
| 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 | INLINECODE29 |
| 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):
CODEBLOCK9
Output format:
CODEBLOCK10
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 | INLINECODE36 |
| 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 |
CODEBLOCK11
Article Endpoints
| Endpoint | URL | Params |
|---|
| All articles | INLINECODE45 | 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 | INLINECODE49 | INLINECODE50 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 | INLINECODE55 | 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 | INLINECODE78 or INLINECODE79 |
| 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 / ibitfbtc / daily_tx | Daily (T+1) |
| stablecoin
marketcap / complianttotal | Daily |
| bottom
topindicator | 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 |
|---|
| INLINECODE108 not set | Prompt: Please set the BLOCKBEATSAPIKEY 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 - INLINECODE111 field format: INLINECODE112
- 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
BlockBeats API 技能
通过 BlockBeats Pro API 查询加密货币快讯、文章、搜索结果及链上市场数据。
基础 URL: https://api-pro.theblockbeats.info
认证: 所有请求均需在 Header 中添加 api-key: $BLOCKBEATSAPIKEY
响应格式: {status: 0, message: , data: {...}} — status 0 表示成功
场景 1：市场概览
触发词: 今天市场怎么样、市场概览、每日总结、市场行情
并行执行以下四个请求：
bash
1. 市场情绪指数
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/bottom
topindicator
2. 重要快讯（最新5条）
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/newsflash/important \
-G --data-urlencode size=5 --data-urlencode lang=en
3. BTC ETF 净流入
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/btc_etf
4. 每日链上交易量
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/daily_tx
输出格式:
📊 市场概览 · [今日日期]
情绪指数: [数值] → [<20 潜在买入区 / 20-80 中性 / >80 潜在卖出区]
BTC ETF: 今日净流入 [数值] 百万美元，累计 [数值] 百万
链上交易量: 今日 [数值]（较昨日 [↑/↓][变化百分比]）
重要新闻:
· [标题1] [时间]
· [标题2] [时间]
· [标题3] [时间]
解读规则:
- - 情绪 < 20 → 提醒用户潜在机会
- 情绪 > 80 → 警告抛售风险
- ETF 连续3天正向流入 → 机构吸筹信号
- ETF 日净流入 > 5亿美元 → 强烈买入信号
- 链上交易量上升 → 链上活跃度和市场热度增加
场景 2：资金流向分析
触发词: 资金流向哪里、链上趋势、哪些代币被买入、稳定币、聪明钱
并行执行：
bash
1. 链上净流入前10代币（默认 solana；可通过 network 参数切换 Base/ETH）
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/top10_netflow \
-G --data-urlencode network=solana
2. 稳定币市值
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/stablecoin_marketcap
3. BTC ETF 净流入
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/btc_etf
根据用户意图选择 network 参数：solana（默认）/ base / ethereum
输出格式:
💰 资金流向分析
链上热点（[链名称]）:
1. [代币] 净流入 $[数值] 市值 $[数值]
2. ...
稳定币: USDT [↑/↓] USDC [↑/↓]（扩张/收缩信号）
机构: ETF 今日 [流入/流出] [数值] 百万美元
解读规则:
- - 稳定币市值扩张 → 市场资金增加，买入潜力增强
- 稳定币市值收缩 → 资金离场，建议谨慎
场景 3：宏观环境评估
触发词: 宏观环境、是否适合入场、流动性、美债、美元、M2、大局观
并行执行：
bash
1. 全球 M2 供应量
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/m2_supply \
-G --data-urlencode type=1Y
2. 美国10年期国债收益率
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/us10y \
-G --data-urlencode type=1M
3. DXY 美元指数
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/dxy \
-G --data-urlencode type=1M
4. 合规交易所总资产
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/compliant_total
输出格式:
🌐 宏观环境评估
全球 M2: [最新值] 同比 [↑/↓][变化百分比] → [扩张/收缩]
美国国债收益率（10年期）: [最新值]% → [上升/下降趋势]
美元指数（DXY）: [最新值] → [强势/弱势]
合规交易所资产: $[数值] → [流入/流出趋势]
总体评估: [看涨/中性/看跌] 加密市场
解读规则:
- - M2 同比 > 5% → 流动性宽松，利好风险资产
- M2 同比 < 0% → 流动性收紧，需谨慎
- DXY 上升 → 美元走强，加密市场承压
- DXY 下降 → 美元走弱，加密市场受益
- 国债收益率上升 → 无风险利率提高，资金回流债券
- 合规交易所资产上升 → 机构配置意愿增强
场景 4：衍生品市场分析
触发词: 期货市场、多空持仓、未平仓合约、币安Bybit持仓量、杠杆风险
并行执行：
bash
1. 主要衍生品平台对比
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/contract \
-G --data-urlencode dataType=1D
2. 交易所快照
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/exchanges \
-G --data-urlencode size=10
3. Bitfinex BTC 多头持仓
curl -s -H api-key: $BLOCKBEATS
APIKEY \
https://api-pro.theblockbeats.info/v1/data/bitfinex_long \
-G --data-urlencode symbol=btc --data-urlencode type=1D
输出格式:
⚡ 衍生品市场分析
平台持仓量:
币安 [数值] Bybit [数值] Hyperliquid [数值]
交易所排名（按交易量）:
1. [名称] 交易量 $[数值] 持仓量 $[数值]
2. ...
Bitfinex BTC 多头: [数值] → [增加/减少]（杠杆多头情绪 [强/弱]）
解读规则:
- - Bitfinex 多头持续增加 → 大户看涨，市场信心增强
- Bitfinex 多头大幅下降 → 注意多头清算连锁反应
场景 5：关键词搜索
触发词: 搜索 [关键词]、查找 [关键词]、[关键词] 新闻、[关键词] 发生了什么
bash
curl -s -H api-key: $BLOCKBEATSAPIKEY \
https://api-pro.theblockbeats.info/v1/search \
-G --data-urlencode name=[关键词] --data-urlencode size=10 --data-urlencode lang=en
响应字段：title、abstract、content（纯文本）、type（0=文章，1=快讯）、timecn（相对时间）、imgurl、url；分页对象：total、page、size、total_pages；size 最大100
场景 6：快讯与文章列表
根据用户意图选择合适的快讯分类或文章接口。默认返回10条；使用 size 参数调整数量。
快讯分类触发词与接口：
|
