BTCFi API — Bitcoin + BTCFi Data for AI Agents

# BTCFi API — Agent Discovery File # https://btcfi.aiindigo.com # Bitcoin data, BTCFi intelligence, ZK proofs & real-time streams for AI agents ## Overview BTCFi API is an agent-native Bitcoin intelligence platform providing 33 endpoints across Bitcoin, Ethereum, and Solana blockchains. All paid endpoints use x402 micropayments in USDC (no API keys, no subscriptions). Several endpoints are free. Base URL: https://btcfi.aiindigo.com OpenAPI: https://btcfi.aiindigo.com/openapi.json MCP Server: npx @aiindigo/btcfi-mcp (27 tools, stdio transport) SDK: npm install @aiindigo/btcfi (28 methods) ## Authentication - x402 micropayment: X-Payment header with USDC payment proof - Wallet signing: X-Signature + X-Nonce + X-Signer + X-Timestamp headers - Free endpoints: No authentication required - Internal services: X-Internal-Key header (pre-shared) ## Payment Networks - Base (EVM L2): Coinbase facilitator, zero fees, ERC-3009 - Solana: NLx402 (PCEF nonprofit), zero fees ## Pricing (USDC per query) - $0.01: Core queries (fees, mempool, address, UTXOs, tx, blocks, streams) - $0.02: Intelligence (whale alerts, risk scoring, fee prediction, network health) - $0.02: Security (YARA-pattern threat analysis) - $0.02: Solv Protocol (reserves, yield, liquidity, risk) - $0.03: ZK proof generation (balance, age, membership) - $0.05: Transaction broadcast (write operation) - Free: Health check, staking status, API index, dashboard ## Free Endpoints (No Payment Required) - GET /api/health — System health check - GET /api/v1 — API index with all endpoint listings - GET /api/v1/staking/status — Staking tier and rate limit status - GET /api/v1/webhooks — List webhooks (X-API-Key required) - POST /api/v1/webhooks — Register webhook (X-API-Key required) - DELETE /api/v1/webhooks?id={id} — Remove webhook (X-API-Key required) - POST /api/v1/webhooks/test — Test fire webhook (X-API-Key required) - POST /api/v1/webhooks/evaluate — Evaluate triggers (X-API-Key required) - GET /

{ "openapi": "3.1.0", "info": { "title": "BTCFi API", "version": "3.0.0", "description": "Bitcoin data, intelligence, security, Solv Protocol, and ZK proofs for AI agents via x402 micropayments", "contact": { "name": "AI Indigo", "email": "ai@aiindigo.com", "url": "https://aiindigo.com" }, "license": { "name": "MIT", "url": "https://opensource.org/licenses/MIT" } }, "servers": [{ "url": "https://btcfi.aiindigo.com", "description": "Production" }], "paths": { "/a