BTCFi API

Bitcoin Data & Intelligence for AI Agents

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

---

BTCFi API provides 31 Bitcoin data and intelligence endpoints accessible via x402 micropayments. Pay $0.01–$0.05 per query in USDC — no API keys, no subscriptions.

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...");

For Humans:

• Web Dashboard
• Telegram Bot — /price, /fees, /mempool, /address, /tx, /whale, /risk, /network
• Chrome Extension — price badge, whale alerts, address inspector
• Interactive API Docs

Endpoints

Group	Count	Price	Examples
Core	11	$0.01	fees, mempool, address, UTXOs, transactions, blocks
Intelligence	5	$0.02	fee prediction, whale alerts, risk scoring, network health
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
Streams	2	$0.01	real-time blocks, whale transactions (SSE)
System	4	Free	health, index, staking status

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. 🚀