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

Intelligence Endpoints

Security Endpoints

ZK Proof Endpoints

Solv Protocol Endpoints

Cross-Chain Endpoints

Ethereum ($0.01):

Solana ($0.01):

Runes Endpoints

Taproot Assets Endpoints

Lightning Network Endpoints

Portfolio Endpoints

Alerts Endpoints

Price Endpoints

Real-Time Streams

Agent Integration

System Endpoints

Pricing

Free Tier: 100 calls/day per IP, no signup required.

Authentication

BTCFi API uses x402 micropayments — no API keys, no OAuth, no subscriptions.

1. Free endpoints — No authentication. Just make a request.
2. Paid endpoints — Include an X-Payment header with a USDC micropayment proof.
3. 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 3001

Required environment variables:

• UPSTASH_REDIS_REST_URL — Redis connection for caching
• UPSTASH_REDIS_REST_TOKEN — Redis auth token
• X402_NETWORK — Payment network (base or solana)
• X402_FACILITATOR_URL — x402 facilitator endpoint

Documentation

Packages & Distribution

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