mcpField
B
blockbeats-skill

blockbeats-skill

github.com/blockbeatsofficial其他13155 次安装31 周前更新
代码仓库

关于 blockbeats-skill

blockbeats-skill 通过 BlockBeats Pro API 查询加密货币新闻、文章、搜索结果及链上和市场数据,面向需要整理行情、资金流与宏观信息的场景。

主要功能

  1. 01新闻快讯与文章分类查询
  2. 02关键词搜索
  3. 03市场情绪与 ETF 数据
  4. 04链上资金流和稳定币数据
  5. 05宏观及衍生品指标

适用场景

  1. 01汇总加密市场每日概况
  2. 02追踪链上资金流向
  3. 03评估宏观环境与流动性
  4. 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/articlepage/size/lang
过去 24 小时(不支持分页,最多 50 篇)GET /v1/article/24h仅 lang
重要文章GET /v1/article/importantpage/size/lang
原创文章GET /v1/article/originalpage/size/lang
RSS 端点
端点URL关键参数
快讯 RSSGET /v1/rss/newsflashpage size(1-50)
文章 RSSGET /v1/rss/articlepage 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/us10ytype=1D/1W/1M
美元指数(DXY)GET /v1/data/dxytype=1D/1W/1M
全球 M2 供应量GET /v1/data/m2_supplytype=3M/6M/1Y/3Y
Bitfinex 多头持仓GET /v1/data/bitfinex_longsymbol=btc type=1D/1W/1M/h24
衍生品平台数据GET /v1/data/contractdataType=1D/1W/1M/3M/6M/12M
买卖指标GET /v1/data/bottom_top_indicator无
链上净流入前 10 名GET /v1/data/top10_netflownetwork=solana/base/ethereum
交易所快照GET /v1/data/exchangesname 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
预测市场 / PolymarketGET /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 FBTCGET /v1/data/ibit_fbtc
稳定币市值 / USDT USDCGET /v1/data/stablecoin_marketcap
美元指数 / DXYGET /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 101API 密钥无效 — 请检查密钥
status 102API 密钥已过期 — 请续订
status 103请求方法无效 — 请检查是否使用了 GET
status -1一般错误 — 显示 message 字段内容
请求超时提示重试;不要中断其他并行请求
data 为空数组说明可能的原因(非交易日、数据延迟、该代币暂无数据)

备注

  • content 字段为 HTML;请剥除标签,仅显示纯文本
  • create_time 字段格式:Y-m-d H:i:s
  • 数值字段(price/vol 等)为字符串;显示时请按数字格式处理
  • 并行请求时,一个端点失败不得阻止显示其他端点的结果

评论

支持 Markdown