BTCFi API

io.github.aiindigo925由 GitHub 帳號 aiindigo925 發布v3.0.1更新於 Oct 24, 2026

Bitcoin data for AI agents. 27 tools with x402 micropayments. No API keys needed.

已驗證STDIO僅桌面金融安全與監控資料與分析

概覽

AI 產生的概覽

讓助理透過 x402 小額支付介面取得比特幣、以太坊、Solana、閃電網路、Runes 與 Taproot 資料。

可以做什麼
這個 MCP 伺服器提供比特幣情報端點：手續費估算、記憶池摘要、地址餘額、UTXO 與交易歷史、區塊資料，以及已簽章交易廣播。也涵蓋鯨魚交易偵測、地址風險評分、MVRV、SOPR、NUPL、HODL 波浪等分析，以及 ZK 證明產生與驗證、Solv Protocol 儲備與收益、Runes 與 Taproot Assets、閃電網路節點與通道、投資組合、警示和價格資料。免費額度為每個 IP 每天 100 次呼叫，不需註冊。
適用情境
當助理需要即時鏈上比特幣或跨鏈資料與分析時使用，例如交易前查詢手續費、篩查地址或追蹤鯨魚活動。適合可以按次以 USDC 付費、而不想管理 API 金鑰的代理。
執行需求
透過 npx @aiindigo/btcfi-mcp 在本機執行（需要 Node.js），並連網呼叫 btcfi.aiindigo.com 遠端 API。免費端點不需憑證；付費端點需要 X-Payment 標頭，攜帶 Base 或 Solana 上的 USDC 小額支付證明。選用環境變數 SVM_PRIVATE_KEY 保存用於 x402 支付的 Solana 私鑰。自架需要 UPSTASH_REDIS_REST_URL、UPSTASH_REDIS_REST_TOKEN、X402_NETWORK 和 X402_FACILITATOR_URL。
安裝前請注意
付費端點每次查詢會花費真實 USDC，約 0.01 至 0.05 美元，使用越多成本越高。選用的 SVM_PRIVATE_KEY 是 Solana 私鑰，應視為敏感機密，切勿外洩。此伺服器可以廣播已簽章交易，這是不可逆的寫入操作。地址、交易 ID 和投資組合識別碼會傳送給第三方 API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 BTCFi API，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

BTCFi API

Bitcoin Intelligence API for AI Agents

[License: MIT] [Version]

Live at btcfi.aiindigo.com · Built by AI Indigo · GitHub

BTCFi API is an agent-native Bitcoin intelligence platform providing 80+ endpoints across Bitcoin, Ethereum, Solana, Lightning Network, Runes, and Taproot Assets. Powered by x402 micropayments — pay $0.01–$0.05 per query in USDC, no API keys or subscriptions required. CoinGecko integration provides multi-currency pricing (38 fiat currencies). AI agents discover endpoints at /llms.txt and integrate via MCP, SDK, or raw HTTP.

Free Tier

100 calls/day per IP — no signup, no API keys, just make a request:

bash
curl https://btcfi.aiindigo.com/api/v1/fees
json
{  "fastest": 12,  "30min": 8,  "1hr": 5,  "economy": 3,  "fastestUSD": "$2.40",  "recommended": "8 sat/vB"}

Quick Start

AI Agents (MCP):

bash
npx @aiindigo/btcfi-mcp

SDK:

bash
npm install @aiindigo/btcfi
typescript
import { BTCFi } from "@aiindigo/btcfi";
const btcfi = new BTCFi({ network: "base" });const fees = await btcfi.fees();const risk = await btcfi.intelligence.risk("bc1q...");

Raw HTTP:

bash
# Free endpoint — no auth neededcurl https://btcfi.aiindigo.com/api/v1/mempool
# Paid endpoint — requires x402 micropaymentcurl -X GET https://btcfi.aiindigo.com/api/v1/intelligence/whales \  -H "X-Payment: <x402-payment-proof>"

OpenAPI Spec:

https://btcfi.aiindigo.com/openapi.json

API Reference

Core Bitcoin Endpoints

EndpointDescriptionPrice
GET /api/v1/feesFee estimates (fastest, 30min, 1hr, economy) with USD values$0.01
GET /api/v1/mempoolMempool summary, tx count, size, fee histogram$0.01
GET /api/v1/address/{addr}Address balance, tx count, funded/spent stats$0.01
GET /api/v1/address/{addr}/utxosUnspent transaction outputs$0.01
GET /api/v1/address/{addr}/txsTransaction history$0.01
GET /api/v1/tx/{txid}Full transaction details$0.01
GET /api/v1/tx/{txid}/statusConfirmation status$0.01
POST /api/v1/tx/broadcastBroadcast signed transaction$0.05
GET /api/v1/block/latestLatest blocks with details$0.01
GET /api/v1/block/{id}Block by height or hash$0.01

Intelligence Endpoints

EndpointDescriptionPrice
GET /api/v1/intelligence/feesAI fee prediction (1h, 6h, 24h windows)$0.02
GET /api/v1/intelligence/whalesLarge transaction detection$0.02
GET /api/v1/intelligence/risk/{addr}Address risk scoring$0.02
GET /api/v1/intelligence/networkHashrate, difficulty, congestion$0.02
GET /api/v1/intelligence/consolidate/{addr}UTXO consolidation advice$0.02
GET /api/v1/intelligence/mvrvMVRV ratio$0.02
GET /api/v1/intelligence/soprSOPR (Spent Output Profit Ratio)$0.02
GET /api/v1/intelligence/nuplNUPL (Net Unrealized Profit/Loss)$0.02
GET /api/v1/intelligence/hodl-wavesHODL wave distribution$0.02

Security Endpoints

EndpointDescriptionPrice
GET /api/v1/security/threat/{addr}YARA-pattern threat analysis (8 patterns)$0.02

ZK Proof Endpoints

EndpointDescriptionPrice
POST /api/v1/zk/balance-proofProve balance ≥ threshold$0.03
POST /api/v1/zk/age-proofProve UTXO age ≥ N blocks$0.03
POST /api/v1/zk/membershipProve set membership$0.03
POST /api/v1/zk/verifyVerify any ZK proof$0.01

Solv Protocol Endpoints

EndpointDescriptionPrice
GET /api/v1/solv/reservesSolvBTC supply, backing ratio, TVL$0.02
GET /api/v1/solv/yieldxSolvBTC APY, yield strategies$0.02
GET /api/v1/solv/liquidityCross-chain SolvBTC distribution$0.02
GET /api/v1/solv/riskMulti-factor risk assessment$0.02

Cross-Chain Endpoints

Ethereum ($0.01):

EndpointDescription
GET /api/v1/eth/gasETH gas prices
GET /api/v1/eth/address/{addr}ETH address balance
GET /api/v1/eth/tx/{hash}ETH transaction details

Solana ($0.01):

EndpointDescription
GET /api/v1/sol/feesSOL priority fees
GET /api/v1/sol/address/{addr}SOL address balance

Runes Endpoints

EndpointDescriptionPrice
GET /api/v1/runesList all Bitcoin Runes tokens$0.02
GET /api/v1/runes/trendingTrending Runes by 24h activity$0.02
GET /api/v1/runes/{ticker}Runes token details$0.02
GET /api/v1/runes/{ticker}/holdersHolder distribution$0.02
GET /api/v1/runes/{ticker}/transfersRecent transfers$0.02

Taproot Assets Endpoints

EndpointDescriptionPrice
GET /api/v1/taproot/assets/{addr}Taproot Assets held by address$0.02
GET /api/v1/taproot/assets/{addr}/{assetId}Taproot Asset details$0.02

Lightning Network Endpoints

EndpointDescriptionPrice
GET /api/v1/lightning/node/{pubkey}Lightning node info$0.02
GET /api/v1/lightning/channels/{chanId}Channel details$0.02
GET /api/v1/lightning/routing-feeRouting fee estimate$0.02
GET /api/v1/intelligence/lightningLightning network intelligence$0.02

Portfolio Endpoints

EndpointDescriptionPrice
GET /api/v1/portfolioList portfolios$0.01
GET /api/v1/portfolio/{userId}Get user portfolio$0.01
GET /api/v1/portfolio/{userId}/analyticsPortfolio analytics$0.02
GET /api/v1/intelligence/portfolio/{addr}Address portfolio analysis$0.02

Alerts Endpoints

EndpointDescriptionPrice
GET /api/v1/alertsList alert rulesFree
GET /api/v1/alerts/rulesManage alert rulesFree
DELETE /api/v1/alerts/rules/{id}Delete alert ruleFree
GET /api/v1/alerts/historyAlert trigger historyFree
POST /api/v1/alerts/evaluateEvaluate alert conditionsFree

Price Endpoints

EndpointDescriptionPrice
GET /api/v1/priceBTC price (CoinGecko: 38 fiat currencies)Free

Real-Time Streams

EndpointDescriptionPrice
GET /api/v1/streamSSE: new blocks, fee changes, mempool surges$0.01
GET /api/v1/stream/whalesSSE: whale transaction alerts (?min=100 BTC)$0.01

Agent Integration

EndpointDescriptionPrice
GET /api/mcpMCP server info and toolsFree
GET /llms.txtAI agent discovery fileFree
GET /api/v1/agent-skillsAgent skill registryFree

System Endpoints

EndpointDescriptionPrice
GET /api/healthSystem health checkFree
GET /api/v1/staking/statusStaking tier and rate limit statusFree

Pricing

CategoryPrice (USDC)
Core Bitcoin (fees, mempool, address, tx, block)$0.01
Intelligence (whales, risk, MVRV, SOPR, NUPL, HODL waves, cluster, graph)$0.02
Security (threat analysis)$0.02
Solv Protocol (reserves, yield, liquidity, risk)$0.02
Runes (tokens, holders, transfers, trending)$0.02
Taproot Assets (asset list, asset details)$0.02
Lightning Network (nodes, channels, routing fees)$0.02
Portfolio (addresses, analytics)$0.01–$0.02
ZK Proofs (balance, age, membership)$0.03
Transaction broadcast$0.05
Ethereum / Solana$0.01
Streams (SSE)$0.01
Price (CoinGecko multi-currency)Free
Alerts (rules, history, evaluate)Free
System (health, status)Free
Agent Discovery (/llms.txt, /api/mcp)Free

Free Tier: 100 calls/day per IP, no signup required.

Authentication

BTCFi API uses x402 micropayments — no API keys, no OAuth, no subscriptions.

  1. Free endpoints — No authentication. Just make a request.
  2. Paid endpoints — Include an X-Payment header with a USDC micropayment proof.
  3. Payment networks:
    • Base (EVM L2) — Coinbase facilitator, zero fees, ERC-3009
    • Solana — NLx402 by PCEF (nonprofit), zero fees

Request signing (optional, for higher rate limits):

  • Wallet-based signing with Ed25519 (Solana) or secp256k1 (EVM)
  • Headers: X-Signature, X-Nonce, X-Signer, X-Timestamp

Free for Humans

Completely free — no signup, no API keys, no secrets. This is a PUBLIC repository. Just open Telegram:

  • @BTC_Fi_Bot — 38 commands + inline mode: /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 — Real-time whale transaction alerts, auto-posted every 15 min
  • Web Dashboard — Live BTC price, fees, mempool, address lookup, whale watch

Security

  • Wallet-based request signing (Ed25519 + secp256k1)
  • Encrypted responses (Curve25519 + XSalsa20-Poly1305)
  • Zero-knowledge proofs (Groth16)
  • 8 YARA-style threat detection patterns
  • Nonce replay protection
  • PEAC Protocol cryptographic receipts
  • Tiered rate limiting (free: 100/min, signed: 500/min, paid: unlimited)
  • NPM supply chain policy: 7-day cooling period, npq guard, lockfile validation

Report vulnerabilities: [email protected]

Self-Hosted

Run the API locally for development or private deployment:

bash
git clone https://github.com/aiindigo925/btcfi-api.gitcd btcfi-apinpm installcp .env.example .env    # Configure environment variablesnpm run dev              # Start on port 3001

Required environment variables:

  • UPSTASH_REDIS_REST_URL — Redis connection for caching
  • UPSTASH_REDIS_REST_TOKEN — Redis auth token
  • X402_NETWORK — Payment network (base or solana)
  • X402_FACILITATOR_URL — x402 facilitator endpoint

Documentation

DocDescription
docs/ROADMAP.mdProject history and future plans
docs/ARCHITECTURE.mdSystem design and endpoint reference
docs/SECURITY.mdSecurity model and features
docs/CHANGELOG.mdVersion history
NPM-SUPPLY-CHAIN-POLICY.mdSupply chain security policy

Packages & Distribution

PackageDescription
@aiindigo/btcfiTypeScript SDK — 28 methods
@aiindigo/btcfi-mcpMCP Server — 45 tools for Claude, ChatGPT, Gemini
MCP Registryio.github.aiindigo925/btcfi
GlamaIndexed — searchable MCP directory
@BTC_Fi_BotTelegram bot — 28 commands + inline mode

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

MIT — Copyright © 2026 AI Indigo

No token. No API keys. Just Bitcoin data. Ship > talk. 🚀

來源：README.md，提交 a8e957c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v3.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分