关于 blockbeats-skill
blockbeats-skill 通过 BlockBeats Pro API 查询加密货币新闻、文章、搜索结果及链上和市场数据,面向需要整理行情、资金流与宏观信息的场景。
主要功能
- 01新闻快讯与文章分类查询
- 02关键词搜索
- 03市场情绪与 ETF 数据
- 04链上资金流和稳定币数据
- 05宏观及衍生品指标
适用场景
- 01汇总加密市场每日概况
- 02追踪链上资金流向
- 03评估宏观环境与流动性
- 04查询衍生品持仓和新闻
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ blockbeatsofficial/ blockbeats-skill --skill blockbeats-skill安装后在 Claude Code 中输入/blockbeats-skill确认已加载。
附带文件.gitignoreREADME.md
详细介绍
BlockBeats API 技能
通过 BlockBeats Pro API 查询加密货币快讯、文章、搜索结果和链上市场数据。
基础 URL:https://api-pro.theblockbeats.info
身份验证:所有请求都需要 Header api-key: $BLOCKBEATS_API_KEY
响应格式:{"status": 0, "message": "", "data": {...}} — status 0 = 成功
场景 1:市场概览
触发条件:今天市场怎么样、市场概览、每日摘要、市场状况
并行执行以下四个请求:
# 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"
输出格式:
📊 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]
解读规则:
- 情绪指数 < 20 → 提醒用户关注潜在机会
- 情绪指数 > 80 → 提醒用户注意抛售风险
- ETF 连续 3 天净流入为正 → 机构累积信号
- ETF 每日净流入 > 500M → 强烈买入信号
- 链上交易量上升 → 链上活动增加,市场热度上升
场景 2:资金流向分析
触发条件:资金流向何处、链上趋势、哪些代币正在被买入、稳定币、聪明钱
并行执行:
# 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"
根据用户意图选择 network 参数:solana(默认)/ base / ethereum
输出格式:
💰 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
解读规则:
- 稳定币市值扩大 → 市场资金增多,买入潜力增强
- 稳定币市值缩小 → 资金流出,建议谨慎
场景 3:宏观环境评估
触发条件:宏观环境、现在是否适合入场、流动性、美国国债、美元、M2、整体形势
并行执行:
# 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"
输出格式:
🌐 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
解读规则:
- M2 同比增长率 > 5% → 流动性宽松,有利于风险资产
- M2 同比增长率 < 0% → 流动性收紧,建议谨慎
- DXY 上升 → 美元走强,加密货币承压
- DXY 下降 → 美元走弱,加密货币受益
- 国债收益率上升 → 无风险利率提高,资金回流债券
- 合规交易所资产上升 → 机构配置意愿增强
场景 4:衍生品市场分析
触发条件:期货市场、多空持仓、未平仓合约、Binance Bybit 未平仓合约、杠杆风险
并行执行:
# 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"
输出格式:
⚡ 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])
解读规则:
- Bitfinex 多头持仓持续增加 → 大型参与者看涨,市场信心增强
- Bitfinex 多头持仓大幅下降 → 留意多头清算连锁反应
场景 5:关键词搜索
触发条件:搜索 [关键词]、查找 [关键词]、[关键词] 新闻、[关键词] 最近有什么动态
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"
响应字段:title、abstract、content(纯文本)、type(0=文章,1=快讯)、time_cn(相对时间)、img_url、url;分页对象:total、page、size、total_pages;size 最大为 100
场景 6:快讯与文章列表
根据用户意图选择合适的快讯类别或文章端点。默认返回 10 条;使用 size 参数调整数量。
快讯类别触发词与端点:
| 用户表达 | 端点路径 |
|---|---|
| 最新消息 / 快讯列表 / 有什么新消息 | /v1/newsflash |
| 过去 24 小时 / 近 24 小时 / 今天所有新闻 | /v1/newsflash/24h |
| 重要新闻 / 重大事件 / 重点头条 | /v1/newsflash/important |
| 原创快讯 / 原创报道 | /v1/newsflash/original |
| 首发报道 / 独家 / 独家爆料 | /v1/newsflash/first |
| 链上新闻 / 链上数据 / 链上动态 | /v1/newsflash/onchain |
| 融资新闻 / 筹款 / VC 交易 / 投资轮次 | /v1/newsflash/financing |
| 预测市场 / Polymarket / 预测 / 博彩 | /v1/newsflash/prediction |
| AI 新闻 / AI 动态 / AI 项目 / 人工智能 | /v1/newsflash/ai |
文章类别触发词与端点:
| 用户表达 | 端点路径 |
|---|---|
| 文章列表 / 深度文章 / 最新文章 | /v1/article |
| 过去 24 小时的文章 / 今天的文章(最多 50 篇,不支持分页) | /v1/article/24h |
| 重要文章 / 重点报告 | /v1/article/important |
| 原创文章 / 原创分析 | /v1/article/original |
请求示例(AI 快讯):
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"
输出格式:
📰 [Category Name] · Latest [N] items
1. [Title] [time_cn]
[abstract, if available]
2. [Title] [time_cn]
[abstract, if available]
...
注意:
content字段为 HTML;请移除标签,仅显示纯文本- 文章端点没有
url字段;请使用link作为文章页面 URL
单一端点参考
快讯端点(均支持 page/size/lang)
| 端点 | URL |
|---|---|
| 所有快讯 | GET /v1/newsflash |
| 过去 24 小时(不支持分页) | GET /v1/newsflash/24h |
| 重要快讯 | GET /v1/newsflash/important |
| 原创快讯 | GET /v1/newsflash/original |
| 首发报道 | GET /v1/newsflash/first |
| 链上快讯 | GET /v1/newsflash/onchain |
| 融资快讯 | GET /v1/newsflash/financing |
| 预测市场快讯 | 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"
文章端点
| 端点 | URL | 参数 |
|---|---|---|
| 所有文章 | GET /v1/article | page/size/lang |
| 过去 24 小时(不支持分页,最多 50 篇) | GET /v1/article/24h | 仅 lang |
| 重要文章 | GET /v1/article/important | page/size/lang |
| 原创文章 | GET /v1/article/original | page/size/lang |
RSS 端点
| 端点 | URL | 关键参数 |
|---|---|---|
| 快讯 RSS | GET /v1/rss/newsflash | page size(1-50) |
| 文章 RSS | GET /v1/rss/article | page size(1-50) |
RSS 端点返回 XML 格式。用户请求 RSS 订阅源或希望订阅更新时使用。
数据端点
| 端点 | URL | 关键参数 |
|---|---|---|
| BTC ETF 净流入 | GET /v1/data/btc_etf | 无 |
| 每日链上交易量 | GET /v1/data/daily_tx | 无 |
| IBIT/FBTC 净流入 | GET /v1/data/ibit_fbtc | 无 |
| 稳定币市值 | GET /v1/data/stablecoin_marketcap | 无 |
| 合规交易所资产 | GET /v1/data/compliant_total | 无 |
| 美国国债收益率 | GET /v1/data/us10y | type=1D/1W/1M |
| 美元指数(DXY) | GET /v1/data/dxy | type=1D/1W/1M |
| 全球 M2 供应量 | GET /v1/data/m2_supply | type=3M/6M/1Y/3Y |
| Bitfinex 多头持仓 | GET /v1/data/bitfinex_long | symbol=btc type=1D/1W/1M/h24 |
| 衍生品平台数据 | GET /v1/data/contract | dataType=1D/1W/1M/3M/6M/12M |
| 买卖指标 | GET /v1/data/bottom_top_indicator | 无 |
| 链上净流入前 10 名 | GET /v1/data/top10_netflow | network=solana/base/ethereum |
| 交易所快照 | GET /v1/data/exchanges | name page size |
时间维度映射
| 用户说法 | 参数 |
|---|---|
| 今天 / 最新 / 实时 | type=1D 或 size=5 |
| 本周 / 近期 | type=1W |
| 本月 / 最近 30 天 | type=1M |
| 今年 / 长期趋势 | type=1Y 或 type=3Y |
| 过去 24 小时(仅限 bitfinex_long) | type=h24 |
意图映射
| 用户意图 | 场景 / 端点 |
|---|---|
| 今天市场行情如何 / 每日概览 | 场景 1:市场概览 |
| 资金流向 / 链上趋势 / 聪明钱 | 场景 2:资金流向 |
| 宏观 / M2 / 美国国债 / 现在是入场的好时机吗 | 场景 3:宏观评估 |
| 期货 / 未平仓合约 / 交易所 OI / 杠杆风险 | 场景 4:衍生品 |
| 搜索 [关键词] | 场景 5:搜索 |
| 最新快讯 / 快讯列表 | GET /v1/newsflash |
| 过去 24 小时 / 今天的所有快讯 | GET /v1/newsflash/24h |
| 重要快讯 | GET /v1/newsflash/important |
| 原创快讯 | GET /v1/newsflash/original |
| 首发快讯 | GET /v1/newsflash/first |
| 链上快讯 | GET /v1/newsflash/onchain |
| 融资新闻 | GET /v1/newsflash/financing |
| 预测市场 / Polymarket | GET /v1/newsflash/prediction |
| AI 快讯 / AI 新闻 | GET /v1/newsflash/ai |
| 文章列表 | GET /v1/article |
| 过去 24 小时的文章 / 今天的文章 | GET /v1/article/24h |
| 重要文章 | GET /v1/article/important |
| 原创文章 | GET /v1/article/original |
| BTC ETF 资金流入 | GET /v1/data/btc_etf |
| IBIT FBTC | GET /v1/data/ibit_fbtc |
| 稳定币市值 / USDT USDC | GET /v1/data/stablecoin_marketcap |
| 美元指数 / DXY | GET /v1/data/dxy |
| Bitfinex 多头 / 杠杆仓位 | GET /v1/data/bitfinex_long |
| 买卖信号 / 市场情绪 | GET /v1/data/bottom_top_indicator |
| 资金流入排名靠前的代币 / 链上热门趋势 | GET /v1/data/top10_netflow |
| 交易所排名 | GET /v1/data/exchanges |
| 链上交易量 / 活跃度 | GET /v1/data/daily_tx |
| 合规交易所资产 / 机构托管 | GET /v1/data/compliant_total |
数据刷新频率
| 端点类型 | 更新频率 |
|---|---|
| 快讯 / 文章 / 搜索 | 实时 |
| top10_netflow | 近实时 |
| btc_etf / ibit_fbtc / daily_tx | 每日(T+1) |
| stablecoin_marketcap / compliant_total | 每日 |
| bottom_top_indicator | 每日 |
| us10y / dxy | 日内分钟级 |
| m2_supply | 每月 |
| exchanges / contract | 每日 |
| bitfinex_long | 每日(h24 参数为近实时) |
错误处理
| 错误情况 | 响应 |
|---|---|
未设置 BLOCKBEATS_API_KEY | 提示:请设置 BLOCKBEATS_API_KEY 环境变量。申请地址:https://www.theblockbeats.info/ |
| status 100 | 缺少 API 密钥 — 请提供 api-key 请求头 |
| status 101 | API 密钥无效 — 请检查密钥 |
| status 102 | API 密钥已过期 — 请续订 |
| status 103 | 请求方法无效 — 请检查是否使用了 GET |
| status -1 | 一般错误 — 显示 message 字段内容 |
| 请求超时 | 提示重试;不要中断其他并行请求 |
| data 为空数组 | 说明可能的原因(非交易日、数据延迟、该代币暂无数据) |
备注
content字段为 HTML;请剥除标签,仅显示纯文本create_time字段格式:Y-m-d H:i:s- 数值字段(price/vol 等)为字符串;显示时请按数字格式处理
- 并行请求时,一个端点失败不得阻止显示其他端点的结果