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 分