Skip to content
plugmcp
DirectorySkillsCategoriesBlog
EN/中文
Sign inSign up
Home/Servers/BTCFi API

BTCFi API

by io.github.aiindigo925

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

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command
npx -y @aiindigo/[email protected]
Credentials from the publisher
  • SVM_PRIVATE_KEY — Solana private key for x402 payments (optional, Base payments work without)
Provider
Claude Code
SVM_PRIVATE_KEY=<secret> claude mcp add io.github.aiindigo925-btcfi -- npx -y @aiindigo/[email protected]

Run in a terminal.

Claude Desktop
{
  "mcpServers": {
    "io.github.aiindigo925-btcfi": {
      "command": "npx",
      "args": [
        "-y",
        "@aiindigo/[email protected]"
      ],
      "env": {
        "SVM_PRIVATE_KEY": "<secret>"
      }
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

View more
  • Firecrawl🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
  • N
    NotionToken-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents.
  • Context7Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

Related skills

View all
  • reaReverse engineer anything with agents, from app behavior down to native binaries.
  • rea-changelog-updatePrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.
  • rea-tool-designDesign or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.

Questions

How do I install BTCFi API?
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does BTCFi API need an API key?
The publisher lists these environment variables: SVM_PRIVATE_KEY.
What transport does BTCFi API use?
BTCFi API runs locally over stdio.
When was BTCFi API last checked?
Last checked 2026-10-21. Bitcoin data for AI agents. 27 tools with x402 micropayments. No API keys needed.

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

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

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:

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

How do I install BTCFi API?
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does BTCFi API need an API key?
The publisher lists these environment variables: SVM_PRIVATE_KEY.
What transport does BTCFi API use?
BTCFi API runs locally over stdio.
When was BTCFi API last checked?
Last checked 2026-10-21. Bitcoin data for AI agents. 27 tools with x402 micropayments. No API keys needed.

No tool list yet. Remote servers get one after the first health check.

plugmcp

Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.

  • github.com/TODO
  • x.com/TODO
  • linkedin.com/company/TODO

PlugMCP, 2026

Product
  • Browse
  • Install
  • Host your own
  • Pricing
  • Voice mode
  • Browser
Directory
  • All MCP servers
  • MCP Apps
  • Tools
  • Agent skills
  • Categories
  • New
  • Voice
  • Submit a server
Developers
  • Docs
  • Blog
  • Club
  • Work with us
  • What is MCP
  • What is WebMCP
  • Status
Company
  • About
  • Contact
  • Terms
  • Privacy
  • DPA