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"
}

Quick Start

AI Agents (MCP):

npx @aiindigo/btcfi-mcp

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

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

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 | Descripti

... View full README on GitHub