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:市場の概要
トリガー:今日の市場はどうか、市場の概要、日次サマリー、市場の状況
以下の 4 つのリクエストを並行して実行します。
# 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 の純流入額が 1 日あたり 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 の OI、レバレッジリスク
並行して実行します。
# 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:キーワード検索
トリガー:search [keyword]、find [keyword]、[keyword] news、[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"
レスポンスフィールド: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フィールドがありません。記事ページの URL にはlinkを使用してください
単一エンドポイントリファレンス
速報エンドポイント(すべて 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:デリバティブ |
| search [keyword] | シナリオ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/ |
| ステータス 100 | API キーがありません — api-key ヘッダーを指定してください |
| ステータス 101 | API キーが無効です — キーを確認してください |
| ステータス 102 | API キーの有効期限が切れています — サブスクリプションを更新してください |
| ステータス 103 | リクエストメソッドが無効です — GET を使用していることを確認してください |
| ステータス -1 | 一般的なエラー — message フィールドの内容を表示してください |
| リクエストがタイムアウトした | 再試行を促してください。他の並列リクエストは中断しないでください |
| data が空の配列 | 考えられる理由(休場日、データの遅延、このトークンのデータがない)を説明してください |
注意事項
contentフィールドは HTML です。タグを除去し、プレーンテキストのみを表示してくださいcreate_timeフィールドの形式:Y-m-d H:i:s- 数値フィールド(価格/出来高など)は文字列です。表示時に数値として書式設定してください
- 並列リクエストを実行する場合、1つのエンドポイントでの失敗によって他のエンドポイントの結果表示を妨げないでください