Back to Directory/AI & ML

BTCFi API

Bitcoin data for AI agents. 27 tools with x402 micropayments. No API keys needed.

AI & MLTypeScriptv3.0.1
View on GitHub

BTCFi API

Bitcoin Intelligence API for AI Agents

License: MIT Version

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

EndpointDescriptionPrice
GET /api/v1/feesFee estimates (fastest, 30min, 1hr, economy) with USD values$0.01
GET /api/v1/mempoolMempool 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}/utxosUnspent transaction outputs$0.01
GET /api/v1/address/{addr}/txsTransaction history$0.01
GET /api/v1/tx/{txid}Full transaction details$0.01
GET /api/v1/tx/{txid}/statusConfirmation status$0.01
POST /api/v1/tx/broadcastBroadcast signed transaction$0.05
GET /api/v1/block/latestLatest blocks with details$0.01
GET /api/v1/block/{id}Block by height or hash$0.01

Intelligence Endpoints

EndpointDescriptionPrice
GET /api/v1/intelligence/feesAI fee prediction (1h, 6h, 24h windows)$0.02
GET /api/v1/intelligence/whalesLarge transaction detection$0.02
GET /api/v1/intelligence/risk/{addr}Address risk scoring$0.02
GET /api/v1/intelligence/networkHashrate, difficulty, congestion$0.02
GET /api/v1/intelligence/consolidate/{addr}UTXO consolidation advice$0.02
GET /api/v1/intelligence/mvrvMVRV ratio$0.02
GET /api/v1/intelligence/soprSOPR (Spent Output Profit Ratio)$0.02
GET /api/v1/intelligence/nuplNUPL (Net Unrealized Profit/Loss)$0.02
GET /api/v1/intelligence/hodl-wavesHODL wave distribution$0.02

Security Endpoints

EndpointDescriptionPrice
GET /api/v1/security/threat/{addr}YARA-pattern threat analysis (8 patterns)$0.02

ZK Proof Endpoints

EndpointDescriptionPrice
POST /api/v1/zk/balance-proofProve balance ≥ threshold$0.03
POST /api/v1/zk/age-proofProve UTXO age ≥ N blocks$0.03
POST /api/v1/zk/membershipProve set membership$0.03
POST /api/v1/zk/verifyVerify any ZK proof$0.01

Solv Protocol Endpoints

EndpointDescriptionPrice
GET /api/v1/solv/reservesSolvBTC supply, backing ratio, TVL$0.02
GET /api/v1/solv/yieldxSolvBTC APY, yield strategies$0.02
GET /api/v1/solv/liquidityCross-chain SolvBTC distribution$0.02
GET /api/v1/solv/riskMulti-factor risk assessment$0.02

Cross-Chain Endpoints

Ethereum ($0.01):

EndpointDescription
GET /api/v1/eth/gasETH gas prices
GET /api/v1/eth/address/{addr}ETH address balance
GET /api/v1/eth/tx/{hash}ETH transaction details

Solana ($0.01):

EndpointDescription
GET /api/v1/sol/feesSOL priority fees
GET /api/v1/sol/address/{addr}SOL address balance

Runes Endpoints

EndpointDescriptionPrice
GET /api/v1/runesList all Bitcoin Runes tokens$0.02
GET /api/v1/runes/trendingTrending Runes by 24h activity$0.02
GET /api/v1/runes/{ticker}Runes token details$0.02
GET /api/v1/runes/{ticker}/holdersHolder distribution$0.02
GET /api/v1/runes/{ticker}/transfersRecent transfers$0.02

Taproot Assets Endpoints

EndpointDescriptionPrice
GET /api/v1/taproot/assets/{addr}Taproot Assets held by address$0.02
GET /api/v1/taproot/assets/{addr}/{assetId}Taproot Asset details$0.02

Lightning Network Endpoints

EndpointDescriptionPrice
GET /api/v1/lightning/node/{pubkey}Lightning node info$0.02
GET /api/v1/lightning/channels/{chanId}Channel details$0.02
GET /api/v1/lightning/routing-feeRouting fee estimate$0.02
GET /api/v1/intelligence/lightningLightning network intelligence$0.02

Portfolio Endpoints

EndpointDescriptionPrice
GET /api/v1/portfolioList portfolios$0.01
GET /api/v1/portfolio/{userId}Get user portfolio$0.01
GET /api/v1/portfolio/{userId}/analyticsPortfolio analytics$0.02
GET /api/v1/intelligence/portfolio/{addr}Address portfolio analysis$0.02

Alerts Endpoints

EndpointDescriptionPrice
GET /api/v1/alertsList alert rulesFree
GET /api/v1/alerts/rulesManage alert rulesFree
DELETE /api/v1/alerts/rules/{id}Delete alert ruleFree
GET /api/v1/alerts/historyAlert trigger historyFree
POST /api/v1/alerts/evaluateEvaluate alert conditionsFree

Price Endpoints

EndpointDescriptionPrice
GET /api/v1/priceBTC price (CoinGecko: 38 fiat currencies)Free

Real-Time Streams

EndpointDescriptionPrice
GET /api/v1/streamSSE: new blocks, fee changes, mempool surges$0.01
GET /api/v1/stream/whalesSSE: whale transaction alerts (?min=100 BTC)$0.01

Agent Integration

EndpointDescriptionPrice
GET /api/mcpMCP server info and toolsFree
GET /llms.txtAI agent discovery fileFree
GET /api/v1/agent-skillsAgent skill registryFree

System Endpoints

EndpointDescriptionPrice
GET /api/healthSystem health checkFree
GET /api/v1/staking/statusStaking tier and rate limit statusFree

Pricing

CategoryPrice (USDC)
Core Bitcoin (fees, mempool, address, tx, block)$0.01
Intelligence (whales, risk, MVRV, SOPR, NUPL, HODL waves, cluster, graph)$0.02
Security (threat analysis)$0.02
Solv Protocol (reserves, yield, liquidity, risk)$0.02
Runes (tokens, holders, transfers, trending)$0.02
Taproot Assets (asset list, asset details)$0.02
Lightning Network (nodes, channels, routing fees)$0.02
Portfolio (addresses, analytics)$0.01–$0.02
ZK Proofs (balance, age, membership)$0.03
Transaction broadcast$0.05
Ethereum / Solana$0.01
Streams (SSE)$0.01
Price (CoinGecko multi-currency)Free
Alerts (rules, history, evaluate)Free
System (health, status)Free
Agent Discovery (/llms.txt, /api/mcp)Free

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

DocDescription
docs/ROADMAP.mdProject history and future plans
docs/ARCHITECTURE.mdSystem design and endpoint reference
docs/SECURITY.mdSecurity model and features
docs/CHANGELOG.mdVersion history

Packages & Distribution

PackageDescription
@aiindigo/btcfiTypeScript SDK — 28 methods
@aiindigo/btcfi-mcpMCP Server — 45 tools for Claude, ChatGPT, Gemini
MCP Registryio.github.aiindigo925/btcfi
GlamaIndexed — searchable MCP directory
@BTC_Fi_BotTelegram bot — 28 commands + inline mode

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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @aiindigo/btcfi-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-aiindigo925-btcfi": {
      "command": "npx",
      "args": [
        "-y",
        "@aiindigo/btcfi-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@aiindigo/btcfi-mcpnpm

Compatible MCP Clients

BTCFi API works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More

Exa MCP Server: AI-Native Search for Claude and CursorExa built its search index for AI agents from the start, and its MCP server reflects that: four tools, a local and a hosted deployment path, and a code-search tool most web-search servers don't ship. Here's the real breakdown, verified against Exa's own docs.Read articlePerplexity MCP Server: The 4 Tools Explained (2026)Perplexity ships one of the most widely used MCP servers in the ecosystem, yet its own CTO has said the company is moving away from MCP internally. Here's the real tool breakdown, and the tension nobody covering Perplexity's MCP server usually mentions.Read articleElevenLabs MCP Server: Voice Cloning and TTS via ClaudeThe ElevenLabs MCP server puts text-to-speech, voice cloning, and transcription directly into Claude's toolset. This guide covers what the server exposes, how to install it, and where it fits next to MCPFind's media and ai-ml category servers.Read article