README.md
Bitcoin Data & Intelligence for AI Agents
BTCFi API
Bitcoin Data & Intelligence for AI Agents
Live at btcfi.aiindigo.com · Built by AI Indigo · GitHub
BTCFi API provides 33 endpoints across Bitcoin, Ethereum, and Solana — accessible via x402 micropayments. Pay $0.01–$0.05 per query in USDC — no API keys, no subscriptions.
Free for Humans
No payments, no signup, no API keys. Just open Telegram.
- @BTC_Fi_Bot — 15 commands + inline mode.
/price,/fees,/mempool,/address,/tx,/whale,/risk,/network,/help,/eth_gas,/sol_fees,/watch,/unwatch,/watchlist,/alerts. Completely free. - @BTCFi_Whales — Real-time whale transaction alerts, auto-posted every 15 min with buy/sell signals. Just join the channel.
- Web Dashboard — Live BTC price, fees, mempool, address lookup, whale watch.
- Chrome Extension — Price badge, whale alerts, address inspector (coming to Chrome Web Store).
Quick Start
For AI Agents (MCP):
npx @aiindigo/btcfi-mcp
For Developers (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...");
Endpoints
| Group | Count | Price | Examples |
|---|---|---|---|
| Core | 10 | $0.01–$0.05 | fees, mempool, address, UTXOs, tx history, transactions, blocks |
| Intelligence | 5 | $0.02 | fee prediction, whale alerts, risk scoring, network health, UTXO consolidation |
| Security | 1 | $0.02 | YARA-pattern threat analysis |
| Solv Protocol | 4 | $0.02 | SolvBTC reserves, yield, liquidity, risk |
| ZK Proofs | 4 | $0.01–$0.03 | balance range, UTXO age, set membership, verification |
| Streams | 2 | $0.01 | real-time blocks, whale transactions (SSE) |
| System | 2 | Free | health, staking status |
| Ethereum | 3 | $0.01 | ETH gas, address balance, transaction details |
| Solana | 2 | $0.01 | SOL priority fees, address balance |
Full specification: OpenAPI 3.1
Payment
Dual-network x402 micropayments in USDC:
- Base — Coinbase facilitator (fee-free)
- Solana — NLx402 by PCEF (nonprofit)
No API keys. No sign-up. Just pay and query.
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
Report vulnerabilities: security@aiindigo.com
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 — 27 tools for Claude, ChatGPT, Gemini |
| MCP Registry | io.github.aiindigo925/btcfi |
| Glama | Indexed — searchable MCP directory |
| @BTC_Fi_Bot | Telegram bot — 9 commands + inline mode |
License
MIT
No token. No API keys. Just Bitcoin data. Ship > talk. 🚀
Tools (3)
get_market_dataRetrieve current market prices and network statistics for Bitcoin, Ethereum, and Solana.get_address_infoFetch transaction history, balance, and UTXO details for a specific blockchain address.get_intelligenceAccess risk scoring, whale alerts, and network health analytics.Configuration
claude_desktop_config.json
{"mcpServers": {"btcfi": {"command": "npx", "args": ["-y", "@aiindigo/btcfi-mcp"]}}}Try it
→What is the current mempool status and recommended transaction fee for Bitcoin?
→Analyze the risk score for this Bitcoin address: bc1q...
→Get the latest whale transaction alerts for the Bitcoin network.
→Compare the current gas fees on Ethereum versus priority fees on Solana.
→Retrieve the UTXO consolidation status for my wallet address.