BTCFi API

io.github.aiindigo925Published by GitHub account aiindigo925v3.0.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceSecurity & MonitoringData & Analytics

Overview

AI-generated overview

Gives an assistant Bitcoin, Ethereum, Solana, Lightning, Runes and Taproot data through a paid x402 micropayment API.

What you can do
The MCP server exposes Bitcoin intelligence endpoints: fee estimates, mempool summaries, address balances, UTXO and transaction history, block data, and signed transaction broadcast. It also covers analytics such as whale detection, address risk scoring, MVRV, SOPR, NUPL and HODL waves, plus ZK proof generation and verification, Solv Protocol reserves and yield, Runes and Taproot Assets, Lightning node and channel data, portfolios, alerts, and price feeds. A free tier allows 100 calls per day per IP without signup.
When to use it
Use it when an assistant needs live on-chain Bitcoin or cross-chain data and analysis, for example checking fees before a transaction, screening an address, or tracking whale activity. It suits agents that can pay per query in USDC rather than manage API keys.
Requirements
Runs locally via npx @aiindigo/btcfi-mcp (Node.js required) and calls the remote btcfi.aiindigo.com API over the network. Free endpoints need no credentials; paid endpoints need an X-Payment header with a USDC micropayment proof on Base or Solana. The optional SVM_PRIVATE_KEY environment variable holds a Solana private key for x402 payments. Self-hosting needs UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN, X402_NETWORK and X402_FACILITATOR_URL.
Before you install
Paid endpoints spend real USDC per query, roughly $0.01 to $0.05, so costs accumulate with use. The optional SVM_PRIVATE_KEY is a Solana private key; treat it as a sensitive secret and never expose it. The server can broadcast signed transactions, which is an irreversible write action. Addresses, transaction IDs and portfolio identifiers are sent to a third-party API.

Installation

In SourceWeft

  1. Open BTCFi API in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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:

bash
curl https://btcfi.aiindigo.com/api/v1/fees
json
{  "fastest": 12,  "30min": 8,  "1hr": 5,  "economy": 3,  "fastestUSD": "$2.40",  "recommended": "8 sat/vB"}

Quick Start

AI Agents (MCP):

bash
npx @aiindigo/btcfi-mcp

SDK:

bash
npm install @aiindigo/btcfi
typescript
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:

bash
# Free endpoint — no auth neededcurl https://btcfi.aiindigo.com/api/v1/mempool
# Paid endpoint — requires x402 micropaymentcurl -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)
  • NPM supply chain policy: 7-day cooling period, npq guard, lockfile validation

Report vulnerabilities: [email protected]

Self-Hosted

Run the API locally for development or private deployment:

bash
git clone https://github.com/aiindigo925/btcfi-api.gitcd btcfi-apinpm installcp .env.example .env    # Configure environment variablesnpm 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
NPM-SUPPLY-CHAIN-POLICY.mdSupply chain security policy

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

Source: README.md at commit a8e957c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v3.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts