B
BTCFi API
Bitcoin data for AI agents. 27 tools with x402 micropayments. No API keys needed.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Install Config Generator
Choose your client
💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Documentation Overview
BTCFi API
Bitcoin Intelligence API for AI Agents
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:
Quick Start
AI Agents (MCP):
SDK:
Raw HTTP:
OpenAPI Spec:
API Reference
Core Bitcoin Endpoints
| Endpoint | Description | Price |
|---|---|---|
GET /api/v1/fees | Fee estimates (fastest, 30min, 1hr, economy) with USD values | $0.01 |
GET /api/v1/mempool | Mempool 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}/utxos | Unspent transaction outputs | $0.01 |
GET /api/v1/address/{addr}/txs | Transaction history | $0.01 |
GET /api/v1/tx/{txid} | Full transaction details | $0.01 |
GET /api/v1/tx/{txid}/status | Confirmation status | $0.01 |
POST /api/v1/tx/broadcast | Broadcast signed transaction | $0.05 |
GET /api/v1/block/latest | Latest blocks with details | $0.01 |
GET /api/v1/block/{id} | Block by height or hash | $0.01 |
Intelligence Endpoints
| Endpoint | Description | Price |
|---|---|---|
GET /api/v1/intelligence/fees | AI fee prediction (1h, 6h, 24h windows) | $0.02 |
GET /api/v1/intelligence/whales | Large transaction detection | $0.02 |
GET /api/v1/intelligence/risk/{addr} | Address risk scoring | $0.02 |
GET /api/v1/intelligence/network | Hashrate, difficulty, congestion | $0.02 |
GET /api/v1/intelligence/consolidate/{addr} | UTXO consolidation advice | $0.02 |
GET /api/v1/intelligence/mvrv | MVRV ratio | $0.02 |
GET /api/v1/intelligence/sopr | SOPR (Spent Output Profit Ratio) | $0.02 |
GET /api/v1/intelligence/nupl | NUPL (Net Unrealized Profit/Loss) | $0.02 |
GET /api/v1/intelligence/hodl-waves | HODL wave distribution | $0.02 |
Security Endpoints
| Endpoint | Description | Price |
|---|---|---|
GET /api/v1/security/threat/{addr} | YARA-pattern threat analysis (8 patterns) | $0.02 |
ZK Proof Endpoints
| Endpoint | Description | Price |
|---|---|---|
POST /api/v1/zk/balance-proof | Prove balance ≥ threshold | $0.03 |
POST /api/v1/zk/age-proof | Prove UTXO age ≥ N blocks | $0.03 |
POST /api/v1/zk/membership | Prove set membership | $0.03 |
POST /api/v1/zk/verify | Verify any ZK proof | $0.01 |
Solv Protocol Endpoints
| Endpoint | Description | Price |
|---|---|---|
GET /api/v1/solv/reserves | SolvBTC supply, backing ratio, TVL | $0.02 |
GET /api/v1/solv/yield | xSolvBTC APY, yield strategies | $0.02 |
GET /api/v1/solv/liquidity | Cross-chain SolvBTC distribution | $0.02 |
GET /api/v1/solv/risk | Multi-factor risk assessment | $0.02 |
Cross-Chain Endpoints
Ethereum ($0.01):
| Endpoint | Description |
|---|---|
GET /api/v1/eth/gas | ETH gas prices |
GET /api/v1/eth/address/{addr} | ETH address balance |
GET /api/v1/eth/tx/{hash} | ETH transaction details |
Solana ($0.01):
| Endpoint | Description |
|---|---|
GET /api/v1/sol/fees | SOL priority fees |
GET /api/v1/sol/address/{addr} | SOL address balance |
Runes Endpoints
| Endpoint | Description | Price |
|---|---|---|
GET /api/v1/runes | List all Bitcoin Runes tokens | $0.02 |
GET /api/v1/runes/trending | Trending Runes by 24h activity | $0.02 |
GET /api/v1/runes/{ticker} | Runes token details | $0.02 |
GET /api/v1/runes/{ticker}/holders | Holder distribution | $0.02 |
GET /api/v1/runes/{ticker}/transfers | Recent transfers | $0.02 |
Taproot Assets Endpoints
| Endpoint | Description | Price |
|---|---|---|
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
| Endpoint | Description | Price |
|---|---|---|
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-fee | Routing fee estimate | $0.02 |
GET /api/v1/intelligence/lightning | Lightning network intelligence | $0.02 |
Portfolio Endpoints
| Endpoint | Description | Price |
|---|---|---|
GET /api/v1/portfolio | List portfolios | $0.01 |
GET /api/v1/portfolio/{userId} | Get user portfolio | $0.01 |
GET /api/v1/portfolio/{userId}/analytics | Portfolio analytics | $0.02 |
GET /api/v1/intelligence/portfolio/{addr} | Address portfolio analysis | $0.02 |
Alerts Endpoints
| Endpoint | Description | Price |
|---|---|---|
GET /api/v1/alerts | List alert rules | Free |
GET /api/v1/alerts/rules | Manage alert rules | Free |
DELETE /api/v1/alerts/rules/{id} | Delete alert rule | Free |
GET /api/v1/alerts/history | Alert trigger history | Free |
POST /api/v1/alerts/evaluate | Evaluate alert conditions | Free |
Price Endpoints
| Endpoint | Description | Price |
|---|---|---|
GET /api/v1/price | BTC price (CoinGecko: 38 fiat currencies) | Free |
Real-Time Streams
| Endpoint | Description | Price |
|---|---|---|
GET /api/v1/stream | SSE: new blocks, fee changes, mempool surges | $0.01 |
GET /api/v1/stream/whales | SSE: whale transaction alerts (?min=100 BTC) | $0.01 |
Agent Integration
| Endpoint | Description | Price |
|---|---|---|
GET /api/mcp | MCP server info and tools | Free |
GET /llms.txt | AI agent discovery file | Free |
GET /api/v1/agent-skills | Agent skill registry | Free |
System Endpoints
| Endpoint | Description | Price |
|---|---|---|
GET /api/health | System health check | Free |
GET /api/v1/staking/status | Staking tier and rate limit status | Free |
Pricing
| Category | Price (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.
- Free endpoints — No authentication. Just make a request.
- Paid endpoints — Include an
X-Paymentheader with a USDC micropayment proof. - 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)
Report vulnerabilities: security@aiindigo.com
Self-Hosted
Run the API locally for development or private deployment:
Required environment variables:
UPSTASH_REDIS_REST_URL— Redis connection for cachingUPSTASH_REDIS_REST_TOKEN— Redis auth tokenX402_NETWORK— Payment network (base or solana)X402_FACILITATOR_URL— x402 facilitator endpoint
Documentation
| Doc | Description |
|---|---|
| docs/ROADMAP.md | Project history and future plans |
| docs/ARCHITECTURE.md | System design and endpoint reference |
| docs/SECURITY.md | Security model and features |
| docs/CHANGELOG.md | Version history |
Packages & Distribution
| Package | Description |
|---|---|
@aiindigo/btcfi | TypeScript SDK — 28 methods |
@aiindigo/btcfi-mcp | MCP Server — 45 tools for Claude, ChatGPT, Gemini |
| MCP Registry | io.github.aiindigo925/btcfi |
| Glama | Indexed — searchable MCP directory |
| @BTC_Fi_Bot | Telegram 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. 🚀
Related MCP Servers
Frequently Asked Questions about BTCFi API
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/btcfi-api)HTML Embed
<a href="https://allmcps.com/mcp/btcfi-api"><img src="https://allmcps.com/api/badge/btcfi-api?style=directory" alt="BTCFi API on AllMCPs" /></a>