btcfi-api
Provides access to 31 Bitcoin data and intelligence endpoints, including real-time mempool status, fee predictions, whale alerts, and risk scoring for Bitcoin addresses.
Integrates with Coinbase as a facilitator for fee-free x402 micropayments on the Base network to access data endpoints.
Utilizes the Solana network to process NLx402 micropayments for pay-per-query access to Bitcoin intelligence and data services.
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:
curl https://btcfi.aiindigo.com/api/v1/fees{
"fastest": 12,
"30min": 8,
"1hr": 5,
"economy": 3,
"fastestUSD": "$2.40",
"recommended": "8 sat/vB"
}Related MCP server: cerebrus-pulse-mcp
Quick Start
AI Agents (MCP):
npx @aiindigo/btcfi-mcpSDK:
npm install @aiindigo/btcfiimport { BTCFi } from "@aiindigo/btcfi";
const btcfi = new BTCFi({ network: "base" });
const fees = await btcfi.fees();
const risk = await btcfi.intelligence.risk("bc1q...");Raw 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 Spec:
https://btcfi.aiindigo.com/openapi.jsonAPI Reference
Core Bitcoin Endpoints
Endpoint | Description | Price |
| Fee estimates (fastest, 30min, 1hr, economy) with USD values | $0.01 |
| Mempool summary, tx count, size, fee histogram | $0.01 |
| Address balance, tx count, funded/spent stats | $0.01 |
| Unspent transaction outputs | $0.01 |
| Transaction history | $0.01 |
| Full transaction details | $0.01 |
| Confirmation status | $0.01 |
| Broadcast signed transaction | $0.05 |
| Latest blocks with details | $0.01 |
| Block by height or hash | $0.01 |
Intelligence Endpoints
Endpoint | Description | Price |
| AI fee prediction (1h, 6h, 24h windows) | $0.02 |
| Large transaction detection | $0.02 |
| Address risk scoring | $0.02 |
| Hashrate, difficulty, congestion | $0.02 |
| UTXO consolidation advice | $0.02 |
| MVRV ratio | $0.02 |
| SOPR (Spent Output Profit Ratio) | $0.02 |
| NUPL (Net Unrealized Profit/Loss) | $0.02 |
| HODL wave distribution | $0.02 |
Security Endpoints
Endpoint | Description | Price |
| YARA-pattern threat analysis (8 patterns) | $0.02 |
ZK Proof Endpoints
Endpoint | Description | Price |
| Prove balance ≥ threshold | $0.03 |
| Prove UTXO age ≥ N blocks | $0.03 |
| Prove set membership | $0.03 |
| Verify any ZK proof | $0.01 |
Solv Protocol Endpoints
Endpoint | Description | Price |
| SolvBTC supply, backing ratio, TVL | $0.02 |
| xSolvBTC APY, yield strategies | $0.02 |
| Cross-chain SolvBTC distribution | $0.02 |
| Multi-factor risk assessment | $0.02 |
Cross-Chain Endpoints
Ethereum ($0.01):
Endpoint | Description |
| ETH gas prices |
| ETH address balance |
| ETH transaction details |
Solana ($0.01):
Endpoint | Description |
| SOL priority fees |
| SOL address balance |
Runes Endpoints
Endpoint | Description | Price |
| List all Bitcoin Runes tokens | $0.02 |
| Trending Runes by 24h activity | $0.02 |
| Runes token details | $0.02 |
| Holder distribution | $0.02 |
| Recent transfers | $0.02 |
Taproot Assets Endpoints
Endpoint | Description | Price |
| Taproot Assets held by address | $0.02 |
| Taproot Asset details | $0.02 |
Lightning Network Endpoints
Endpoint | Description | Price |
| Lightning node info | $0.02 |
| Channel details | $0.02 |
| Routing fee estimate | $0.02 |
| Lightning network intelligence | $0.02 |
Portfolio Endpoints
Endpoint | Description | Price |
| List portfolios | $0.01 |
| Get user portfolio | $0.01 |
| Portfolio analytics | $0.02 |
| Address portfolio analysis | $0.02 |
Alerts Endpoints
Endpoint | Description | Price |
| List alert rules | Free |
| Manage alert rules | Free |
| Delete alert rule | Free |
| Alert trigger history | Free |
| Evaluate alert conditions | Free |
Price Endpoints
Endpoint | Description | Price |
| BTC price (CoinGecko: 38 fiat currencies) | Free |
Real-Time Streams
Endpoint | Description | Price |
| SSE: new blocks, fee changes, mempool surges | $0.01 |
| SSE: whale transaction alerts ( | $0.01 |
Agent Integration
Endpoint | Description | Price |
| MCP server info and tools | Free |
| AI agent discovery file | Free |
| Agent skill registry | Free |
System Endpoints
Endpoint | Description | Price |
| System health check | Free |
| 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:
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 3001Required 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 |
Project history and future plans | |
System design and endpoint reference | |
Security model and features | |
Version history |
Packages & Distribution
Package | Description |
TypeScript SDK — 28 methods | |
MCP Server — 45 tools for Claude, ChatGPT, Gemini | |
| |
Indexed — searchable MCP directory | |
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. 🚀
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityAmaintenanceAgentPay — x402 crypto data gateway on Stellar. 10 live pay-per-call tools: token prices, whale activity, gas tracker, DeFi TVL, Fear & Greed, Dune queries, token security. Agents pay USDC on Stellar. No API keys. Budget-aware sessions.Last updated202MIT
- AlicenseAqualityCmaintenanceReal-time crypto intelligence for AI agents. Technical analysis, liquidation heatmaps, sentiment, and funding rates for 50+ Hyperliquid perpetuals via x402 micropayments.Last updated151MIT
- Alicense-qualityDmaintenanceProvides 16 crypto market data tools for MCP-compatible AI clients with x402/USDC micropayments on Base Mainnet.Last updatedMIT
- Alicense-qualityBmaintenanceMade-to-order data for AI agents via x402 micropayments on Base. Describe a need in plain language, get a custom quote, pay per call. No signup, no API keys. HTTP + MCP transports. 5 tools.Last updated1MIT
Related MCP Connectors
Crypto market data for AI agents via x402. 16 tools: prices, funding, DeFi yields, arbitrage, TA.
Pay-per-use weather, environment, finance, and on-chain intelligence tools for AI agents via x402.
US equity data for AI agents — 23 years intraday + daily, SEC filings. x402 USDC payments.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/aiindigo925/btcfi-api'
If you have feedback or need assistance with the MCP directory API, please join our Discord server