BTCFi API について
BTCFi APIは、AIエージェント向けにBitcoinとクロスチェーンのデータを提供し、市場情報、ネットワーク活動、リスク分析、資産、証明などを扱います。MCPに対応し、APIキーやサブスクリプションなしでx402のUSDCマイクロペイメントを利用できます。
主な機能
- 01Bitcoinとクロスチェーンのデータ
- 02アドレス・取引・ブロックの照会
- 03リスク・手数料・オンチェーン指標
- 04Runes・Taproot Assets・Lightningのデータ
- 05ゼロ知識証明エンドポイント
- 06APIキー不要のx402マイクロペイメント
活用シーン
- 01手数料・メンプール・ブロック活動の確認
- 02アドレスのリスクとUTXOの評価
- 03Runes・資産・Lightningチャネルの追跡
- 04EthereumとSolanaの残高・手数料の照会
MCP 対応
45個のツールを備えたMCPサーバーを提供し、@aiindigo/btcfi-mcpパッケージからAIエージェントが利用できます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
BTCFi API
AI エージェント向け Bitcoin インテリジェンス API
btcfi.aiindigo.comで稼働中 · AI Indigoが開発 · GitHub
BTCFi APIは、Bitcoin、Ethereum、Solana、Lightning Network、Runes、Taproot Assetsにわたる80以上のエンドポイントを提供する、エージェントネイティブなBitcoinインテリジェンスプラットフォームです。x402マイクロペイメントを採用しており、APIキーやサブスクリプションは不要で、クエリごとに$0.01~$0.05をUSDCで支払います。CoinGeckoとの連携により、複数通貨での価格情報(法定通貨38種類)を利用できます。AI エージェントは/llms.txtでエンドポイントを検出し、MCP、SDK、または生のHTTP経由で連携できます。
無料枠
IPアドレスごとに1日100回まで、登録やAPIキーは不要です。リクエストを送信するだけで利用できます。
curl https://btcfi.aiindigo.com/api/v1/fees
{
"fastest": 12,
"30min": 8,
"1hr": 5,
"economy": 3,
"fastestUSD": "$2.40",
"recommended": "8 sat/vB"
}
クイックスタート
AI エージェント(MCP):
npx @aiindigo/btcfi-mcp
SDK:
npm install @aiindigo/btcfi
import { BTCFi } from "@aiindigo/btcfi";
const btcfi = new BTCFi({ network: "base" });
const fees = await btcfi.fees();
const risk = await btcfi.intelligence.risk("bc1q...");
生のHTTP:
# Free endpoint — no auth needed
curl https://btcfi.aiindigo.com/api/v1/mempool
# Paid endpoint — requires x402 micropayment
curl -X GET https://btcfi.aiindigo.com/api/v1/intelligence/whales \
-H "X-Payment: <x402-payment-proof>"
OpenAPI仕様:
https://btcfi.aiindigo.com/openapi.json
APIリファレンス
Bitcoinのコアエンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/v1/fees | 手数料の推定値(最速、30分、1時間、エコノミー)とUSD換算額 | $0.01 |
GET /api/v1/mempool | メンプールの概要、トランザクション数、サイズ、手数料ヒストグラム | $0.01 |
GET /api/v1/address/{addr} | アドレスの残高、トランザクション数、入金・支出統計 | $0.01 |
GET /api/v1/address/{addr}/utxos | 未使用トランザクション出力 | $0.01 |
GET /api/v1/address/{addr}/txs | トランザクション履歴 | $0.01 |
GET /api/v1/tx/{txid} | トランザクションの詳細情報 | $0.01 |
GET /api/v1/tx/{txid}/status | 承認状況 | $0.01 |
POST /api/v1/tx/broadcast | 署名済みトランザクションのブロードキャスト | $0.05 |
GET /api/v1/block/latest | 詳細情報付きの最新ブロック | $0.01 |
GET /api/v1/block/{id} | 高さまたはハッシュで指定したブロック | $0.01 |
インテリジェンスエンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/v1/intelligence/fees | AIによる手数料予測(1時間、6時間、24時間の時間枠) | $0.02 |
GET /api/v1/intelligence/whales | 大規模トランザクションの検出 | $0.02 |
GET /api/v1/intelligence/risk/{addr} | アドレスのリスクスコア評価 | $0.02 |
GET /api/v1/intelligence/network | ハッシュレート、難易度、混雑状況 | $0.02 |
GET /api/v1/intelligence/consolidate/{addr} | UTXO統合に関するアドバイス | $0.02 |
GET /api/v1/intelligence/mvrv | MVRV比率 | $0.02 |
GET /api/v1/intelligence/sopr | SOPR(使用済み出力利益率) | $0.02 |
GET /api/v1/intelligence/nupl | NUPL(未実現損益) | $0.02 |
GET /api/v1/intelligence/hodl-waves | HODLウェーブの分布 | $0.02 |
セキュリティエンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/v1/security/threat/{addr} | YARAパターンによる脅威分析(8パターン) | $0.02 |
ZK証明エンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
POST /api/v1/zk/balance-proof | 残高が閾値以上であることを証明 | $0.03 |
POST /api/v1/zk/age-proof | UTXOの経過ブロック数がN以上であることを証明 | $0.03 |
POST /api/v1/zk/membership | 集合への所属を証明 | $0.03 |
POST /api/v1/zk/verify | 任意のZK証明を検証 | $0.01 |
Solv Protocolエンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/v1/solv/reserves | SolvBTCの供給量、裏付け比率、TVL | $0.02 |
GET /api/v1/solv/yield | xSolvBTCのAPY、利回り戦略 | $0.02 |
GET /api/v1/solv/liquidity | クロスチェーンにおけるSolvBTCの分布 | $0.02 |
GET /api/v1/solv/risk | 多要素リスク評価 | $0.02 |
クロスチェーンエンドポイント
Ethereum($0.01):
| エンドポイント | 説明 |
|---|---|
GET /api/v1/eth/gas | ETH ガス価格 |
GET /api/v1/eth/address/{addr} | ETH アドレスの残高 |
GET /api/v1/eth/tx/{hash} | ETH トランザクションの詳細 |
Solana($0.01):
| エンドポイント | 説明 |
|---|---|
GET /api/v1/sol/fees | SOL 優先手数料 |
GET /api/v1/sol/address/{addr} | SOL アドレスの残高 |
Runes エンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/v1/runes | Bitcoin Runes トークンの一覧 | $0.02 |
GET /api/v1/runes/trending | 24時間のアクティビティに基づく人気の Runes | $0.02 |
GET /api/v1/runes/{ticker} | Runes トークンの詳細 | $0.02 |
GET /api/v1/runes/{ticker}/holders | 保有者の分布 | $0.02 |
GET /api/v1/runes/{ticker}/transfers | 最近の送金 | $0.02 |
Taproot Assets エンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/v1/taproot/assets/{addr} | アドレスが保有する Taproot Assets | $0.02 |
GET /api/v1/taproot/assets/{addr}/{assetId} | Taproot Asset の詳細 | $0.02 |
Lightning Network エンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/v1/lightning/node/{pubkey} | Lightning ノード情報 | $0.02 |
GET /api/v1/lightning/channels/{chanId} | チャネルの詳細 | $0.02 |
GET /api/v1/lightning/routing-fee | ルーティング手数料の見積もり | $0.02 |
GET /api/v1/intelligence/lightning | Lightning Network のインテリジェンス | $0.02 |
ポートフォリオエンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/v1/portfolio | ポートフォリオの一覧 | $0.01 |
GET /api/v1/portfolio/{userId} | ユーザーのポートフォリオを取得 | $0.01 |
GET /api/v1/portfolio/{userId}/analytics | ポートフォリオ分析 | $0.02 |
GET /api/v1/intelligence/portfolio/{addr} | アドレスのポートフォリオ分析 | $0.02 |
アラートエンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/v1/alerts | アラートルールの一覧 | Free |
GET /api/v1/alerts/rules | アラートルールを管理 | Free |
DELETE /api/v1/alerts/rules/{id} | アラートルールを削除 | Free |
GET /api/v1/alerts/history | アラートの発生履歴 | Free |
POST /api/v1/alerts/evaluate | アラート条件を評価 | Free |
価格エンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/v1/price | BTC 価格(CoinGecko:38種類の法定通貨) | Free |
リアルタイムストリーム
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/v1/stream | SSE:新しいブロック、手数料の変化、メンプールの急増 | $0.01 |
GET /api/v1/stream/whales | SSE:クジラのトランザクションアラート(?min=100 BTC) | $0.01 |
エージェント連携
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/mcp | MCP サーバーの情報とツール | Free |
GET /llms.txt | AI エージェントの検出ファイル | Free |
GET /api/v1/agent-skills | エージェントスキルレジストリ | Free |
システムエンドポイント
| エンドポイント | 説明 | 価格 |
|---|---|---|
GET /api/health | システムのヘルスチェック | Free |
GET /api/v1/staking/status | ステーキングティアとレート制限のステータス | Free |
料金
| カテゴリ | 価格(USDC) |
|---|---|
| Bitcoin コア(手数料、メンプール、アドレス、トランザクション、ブロック) | $0.01 |
| インテリジェンス(クジラ、リスク、MVRV、SOPR、NUPL、HODL 波、クラスター、グラフ) | $0.02 |
| セキュリティ(脅威分析) | $0.02 |
| Solv Protocol(準備金、利回り、流動性、リスク) | $0.02 |
| Runes(トークン、保有者、送金、トレンド) | $0.02 |
| Taproot Assets(アセット一覧、アセット詳細) | $0.02 |
| Lightning Network(ノード、チャネル、ルーティング手数料) | $0.02 |
| ポートフォリオ(アドレス、分析) | $0.01–$0.02 |
| ZK 証明(残高、経過時間、メンバーシップ) | $0.03 |
| トランザクションのブロードキャスト | $0.05 |
| Ethereum / Solana | $0.01 |
| ストリーム(SSE) | $0.01 |
| 価格(CoinGecko の複数通貨対応) | 無料 |
| アラート(ルール、履歴、評価) | 無料 |
| システム(ヘルス、ステータス) | 無料 |
| エージェント検出(/llms.txt、/api/mcp) | 無料 |
無料枠: IP あたり 1 日 100 回まで。登録は不要です。
認証
BTCFi API は x402 マイクロペイメントを使用します。API キー、OAuth、サブスクリプションは不要です。
- 無料エンドポイント — 認証は不要です。そのままリクエストしてください。
- 有料エンドポイント — USDC マイクロペイメントの証明を
X-Paymentヘッダーに含めてください。 - 決済ネットワーク:
- Base(EVM L2)— Coinbase ファシリテーター、手数料ゼロ、ERC-3009
- Solana — PCEF による NLx402(非営利)、手数料ゼロ
リクエスト署名(任意。より高いレート制限を利用する場合):
- Ed25519(Solana)または secp256k1(EVM)によるウォレットベースの署名
- ヘッダー:
X-Signature、X-Nonce、X-Signer、X-Timestamp
人間は無料
完全無料 — 登録不要、API キー不要、秘密情報不要。 これは公開リポジトリです。Telegram を開くだけで利用できます。
- @BTC_Fi_Bot — 38 個のコマンドとインラインモード:
/start/help/price/whale/fear/hash/mempool/halving/etf/funding/dominance/mining/lightning/signal/l2/block/mvrv/sopr/nupl/entity/portfolio/staking/threat/eth_addr/sol_addr/digest/alerts/watch/unwatch/watchlist/runes/ordinals/taproot/cluster/graph/batch/webhooks/premium - @BTCFi_Whales — クジラのトランザクションをリアルタイムで通知。15 分ごとに自動投稿
- Web ダッシュボード — BTC 価格、手数料、メンプール、アドレス検索、クジラの監視をリアルタイムで表示
セキュリティ
- ウォレットベースのリクエスト署名(Ed25519 + secp256k1)
- 暗号化されたレスポンス(Curve25519 + XSalsa20-Poly1305)
- ゼロ知識証明(Groth16)
- YARA 形式の脅威検出パターン 8 種
- ノンスのリプレイ保護
- PEAC Protocol の暗号学的レシート
- 段階的なレート制限(無料:100/分、署名済み:500/分、有料:無制限)
- NPM サプライチェーンポリシー:7 日間のクーリング期間、npq ガード、ロックファイルの検証
脆弱性の報告先:[email protected]
セルフホスト
開発またはプライベートなデプロイ向けに API をローカルで実行します。
git clone https://github.com/aiindigo925/btcfi-api.git
cd btcfi-api
npm install
cp .env.example .env # Configure environment variables
npm run dev # Start on port 3001
必要な環境変数:
UPSTASH_REDIS_REST_URL— キャッシュ用の Redis 接続先UPSTASH_REDIS_REST_TOKEN— Redis 認証トークンX402_NETWORK— 決済ネットワーク(base または solana)X402_FACILITATOR_URL— x402 ファシリテーターのエンドポイント
ドキュメント
| ドキュメント | 説明 |
|---|---|
| docs/ROADMAP.md | プロジェクトの沿革と今後の計画 |
| docs/ARCHITECTURE.md | システム設計とエンドポイントのリファレンス |
| docs/SECURITY.md | セキュリティモデルと機能 |
| docs/CHANGELOG.md | バージョン履歴 |
| NPM-SUPPLY-CHAIN-POLICY.md | サプライチェーンセキュリティポリシー |
パッケージと配布
| パッケージ | 説明 |
|---|---|
@aiindigo/btcfi | TypeScript SDK — 28 メソッド |
@aiindigo/btcfi-mcp | MCP サーバー — Claude、ChatGPT、Gemini 向けの 45 ツール |
| MCP Registry | io.github.aiindigo925/btcfi |
| Glama | 登録済み — 検索可能な MCP ディレクトリ |
| @BTC_Fi_Bot | Telegram ボット — 28 個のコマンドとインラインモード |
貢献
貢献を歓迎します!ガイドラインについては、CONTRIBUTING.md をご覧ください。
ライセンス
MIT — Copyright © 2026 AI Indigo
トークン不要。API キー不要。Bitcoin のデータだけ。語るより、届けましょう。 🚀
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。