BTCFi API

本地服务

btcfi.aiindigo.com金融数据05 周前更新

代码仓库访问官网

关于 BTCFi API

BTCFi API 为 AI Agent 提供比特币及跨链数据，涵盖市场、网络活动、风险分析、资产和证明等接口。它支持 MCP，并通过 x402 USDC 微支付提供服务，无需 API 密钥或订阅。

主要功能

01比特币及跨链数据
02地址、交易和区块查询
03风险、费用和链上指标
04Runes、Taproot Assets 与 Lightning 数据
05零知识证明接口
06无需 API 密钥的 x402 微支付

适用场景

01查看费用、内存池和区块活动
02评估地址风险及 UTXO
03追踪 Runes、资产和 Lightning 通道
04查询 Ethereum 与 Solana 余额和费用

MCP 相关

提供包含 45 个工具的 MCP 服务，可通过 @aiindigo/btcfi-mcp 包供 AI Agent 使用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "aiindigo925-btcfi": {
      "command": "npx",
      "args": [
        "-y",
        "@aiindigo/btcfi-mcp"
      ],
      "env": {
        "SVM_PRIVATE_KEY": "<SVM_PRIVATE_KEY>"
      }
    }
  }
}

启动命令npx -y @aiindigo/btcfi-mcp

需要配置的环境变量

SVM_PRIVATE_KEY密钥Solana private key for x402 payments (optional, Base payments work without)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@aiindigo/btcfi-mcp3.0.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

BTCFi API

面向 AI Agent 的比特币智能 API

已上线：btcfi.aiindigo.com · 由 AI Indigo 构建 · GitHub

BTCFi API 是一个原生支持 Agent 的比特币智能平台，在 Bitcoin、Ethereum、Solana、Lightning Network、Runes 和 Taproot Assets 上提供 80 多个端点。平台由 x402 小额支付提供支持，每次查询支付 $0.01–$0.05 的 USDC 即可，无需 API 密钥或订阅。CoinGecko 集成提供多币种定价（38 种法定货币）。AI Agent 可通过 /llms.txt 发现端点，并使用 MCP、SDK 或原始 HTTP 接入。

免费套餐

每个 IP 每天可调用 100 次——无需注册或 API 密钥，只需发送请求：

curl https://btcfi.aiindigo.com/api/v1/fees

{
  "fastest": 12,
  "30min": 8,
  "1hr": 5,
  "economy": 3,
  "fastestUSD": "$2.40",
  "recommended": "8 sat/vB"
}

快速入门

AI Agent（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...");

原始 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 规范：

https://btcfi.aiindigo.com/openapi.json

API 参考

Bitcoin 核心端点

端点	说明	价格
`GET /api/v1/fees`	手续费估算（最快、30 分钟、1 小时、经济）及美元价值	$0.01
`GET /api/v1/mempool`	内存池摘要、交易数量、大小、手续费直方图	$0.01
`GET /api/v1/address/{addr}`	地址余额、交易数量、接收和支出统计	$0.01
`GET /api/v1/address/{addr}/utxos`	未花费的交易输出	$0.01
`GET /api/v1/address/{addr}/txs`	交易历史记录	$0.01
`GET /api/v1/tx/{txid}`	完整交易详情	$0.01
`GET /api/v1/tx/{txid}/status`	确认状态	$0.01
`POST /api/v1/tx/broadcast`	广播已签名的交易	$0.05
`GET /api/v1/block/latest`	包含详情的最新区块	$0.01
`GET /api/v1/block/{id}`	按高度或哈希查询区块	$0.01

智能端点

端点	说明	价格
`GET /api/v1/intelligence/fees`	AI 手续费预测（1 小时、6 小时、24 小时窗口）	$0.02
`GET /api/v1/intelligence/whales`	检测大额交易	$0.02
`GET /api/v1/intelligence/risk/{addr}`	地址风险评分	$0.02
`GET /api/v1/intelligence/network`	哈希率、难度、拥堵情况	$0.02
`GET /api/v1/intelligence/consolidate/{addr}`	UTXO 整合建议	$0.02
`GET /api/v1/intelligence/mvrv`	MVRV 比率	$0.02
`GET /api/v1/intelligence/sopr`	SOPR（已花费输出利润率）	$0.02
`GET /api/v1/intelligence/nupl`	NUPL（未实现净利润/亏损）	$0.02
`GET /api/v1/intelligence/hodl-waves`	HODL 波段分布	$0.02

安全端点

端点	说明	价格
`GET /api/v1/security/threat/{addr}`	YARA 模式威胁分析（8 种模式）	$0.02

ZK 证明端点

端点	说明	价格
`POST /api/v1/zk/balance-proof`	证明余额 ≥ 阈值	$0.03
`POST /api/v1/zk/age-proof`	证明 UTXO 年龄 ≥ N 个区块	$0.03
`POST /api/v1/zk/membership`	证明集合成员资格	$0.03
`POST /api/v1/zk/verify`	验证任意 ZK 证明	$0.01

Solv Protocol 端点

端点	说明	价格
`GET /api/v1/solv/reserves`	SolvBTC 供应量、支持率、TVL	$0.02
`GET /api/v1/solv/yield`	xSolvBTC APY、收益策略	$0.02
`GET /api/v1/solv/liquidity`	跨链 SolvBTC 分布	$0.02
`GET /api/v1/solv/risk`	多因素风险评估	$0.02

跨链端点

Ethereum（$0.01）：

端点	描述
`GET /api/v1/eth/gas`	ETH Gas 价格
`GET /api/v1/eth/address/{addr}`	ETH 地址余额
`GET /api/v1/eth/tx/{hash}`	ETH 交易详情

Solana（$0.01）：

端点	描述
`GET /api/v1/sol/fees`	SOL 优先费用
`GET /api/v1/sol/address/{addr}`	SOL 地址余额

Runes 端点

端点	描述	价格
`GET /api/v1/runes`	列出所有 Bitcoin Runes 代币	$0.02
`GET /api/v1/runes/trending`	按 24 小时活跃度排列的热门 Runes	$0.02
`GET /api/v1/runes/{ticker}`	Runes 代币详情	$0.02
`GET /api/v1/runes/{ticker}/holders`	持有者分布	$0.02
`GET /api/v1/runes/{ticker}/transfers`	最近转账	$0.02

Taproot Assets 端点

端点	描述	价格
`GET /api/v1/taproot/assets/{addr}`	地址持有的 Taproot Assets	$0.02
`GET /api/v1/taproot/assets/{addr}/{assetId}`	Taproot Asset 详情	$0.02

Lightning Network 端点

端点	描述	价格
`GET /api/v1/lightning/node/{pubkey}`	Lightning 节点信息	$0.02
`GET /api/v1/lightning/channels/{chanId}`	通道详情	$0.02
`GET /api/v1/lightning/routing-fee`	路由费用估算	$0.02
`GET /api/v1/intelligence/lightning`	Lightning Network 智能分析	$0.02

投资组合端点

端点	描述	价格
`GET /api/v1/portfolio`	列出投资组合	$0.01
`GET /api/v1/portfolio/{userId}`	获取用户投资组合	$0.01
`GET /api/v1/portfolio/{userId}/analytics`	投资组合分析	$0.02
`GET /api/v1/intelligence/portfolio/{addr}`	地址投资组合分析	$0.02

警报端点

端点	描述	价格
`GET /api/v1/alerts`	列出警报规则	免费
`GET /api/v1/alerts/rules`	管理警报规则	免费
`DELETE /api/v1/alerts/rules/{id}`	删除警报规则	免费
`GET /api/v1/alerts/history`	警报触发历史记录	免费
`POST /api/v1/alerts/evaluate`	评估警报条件	免费

价格端点

端点	描述	价格
`GET /api/v1/price`	BTC 价格（CoinGecko：38 种法定货币）	免费

实时数据流

端点	描述	价格
`GET /api/v1/stream`	SSE：新区块、费用变化、内存池激增	$0.01
`GET /api/v1/stream/whales`	SSE：巨鲸交易警报（`?min=100` BTC）	$0.01

Agent 集成

端点	描述	价格
`GET /api/mcp`	MCP 服务信息和工具	免费
`GET /llms.txt`	AI Agent 发现文件	免费
`GET /api/v1/agent-skills`	Agent 技能注册表	免费

系统端点

端点	描述	价格
`GET /api/health`	系统健康检查	免费
`GET /api/v1/staking/status`	质押等级和速率限制状态	免费

定价

类别	价格（USDC）
比特币核心（费用、内存池、地址、交易、区块）	$0.01
智能分析（巨鲸、风险、MVRV、SOPR、NUPL、HODL 波段、集群、图谱）	$0.02
安全（威胁分析）	$0.02
Solv Protocol（储备、收益、流动性、风险）	$0.02
Runes（代币、持有者、转账、趋势）	$0.02
Taproot Assets（资产列表、资产详情）	$0.02
闪电网络（节点、通道、路由费用）	$0.02
投资组合（地址、分析）	$0.01–$0.02
ZK 证明（余额、年龄、成员资格）	$0.03
交易广播	$0.05
Ethereum / Solana	$0.01
流（SSE）	$0.01
价格（CoinGecko 多币种）	免费
警报（规则、历史记录、评估）	免费
系统（运行状况、状态）	免费
Agent 发现（/llms.txt、/api/mcp）	免费

**免费额度：**每个 IP 每天 100 次调用，无需注册。

身份验证

BTCFi API 使用 x402 微支付——无需 API 密钥、OAuth 或订阅。

免费端点——无需身份验证。直接发送请求即可。
付费端点——在 X-Payment 标头中附上 USDC 微支付证明。
支付网络：
- Base（EVM L2）——Coinbase 结算服务商，零费用，ERC-3009
- Solana——由非营利组织 PCEF 提供的 NLx402，零费用

请求签名（可选，用于提高速率限制）：

使用 Ed25519（Solana）或 secp256k1（EVM）进行基于钱包的签名
标头：X-Signature、X-Nonce、X-Signer、X-Timestamp

免费供用户使用

**完全免费——无需注册、API 密钥或密钥。**这是一个公开仓库。只需打开 Telegram：

@BTC_Fi_Bot — 38 个命令 + 行内模式： /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 — 实时巨鲸交易警报，每 15 分钟自动发布
Web Dashboard — 实时 BTC 价格、费用、内存池、地址查询、巨鲸监控

安全

基于钱包的请求签名（Ed25519 + secp256k1）
加密响应（Curve25519 + XSalsa20-Poly1305）
零知识证明（Groth16）
8 种 YARA 风格的威胁检测模式
防重放随机数保护
PEAC Protocol 加密回执
分级速率限制（免费：100 次/分钟，已签名：500 次/分钟，付费：无限制）
NPM 供应链策略：7 天冷却期、npq 防护、锁文件验证

报告漏洞：[email protected]

自托管

在本地运行 API，用于开发或私有部署：

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

必需的环境变量：

UPSTASH_REDIS_REST_URL — 用于缓存的 Redis 连接
UPSTASH_REDIS_REST_TOKEN — Redis 身份验证令牌
X402_NETWORK — 支付网络（base 或 solana）
X402_FACILITATOR_URL — x402 结算服务商端点

文档

文档	描述
docs/ROADMAP.md	项目历史和未来规划
docs/ARCHITECTURE.md	系统设计和端点参考
docs/SECURITY.md	安全模型和功能
docs/CHANGELOG.md	版本历史
NPM-SUPPLY-CHAIN-POLICY.md	供应链安全策略

软件包与分发

软件包	说明
`@aiindigo/btcfi`	TypeScript SDK — 28 个方法
`@aiindigo/btcfi-mcp`	MCP 服务 — 为 Claude、ChatGPT、Gemini 提供 45 个工具
MCP Registry	`io.github.aiindigo925/btcfi`
Glama	已收录 — 可搜索的 MCP 目录
@BTC_Fi_Bot	Telegram 机器人 — 28 条命令 + 行内模式

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解指南。

许可证

无需令牌。无需 API 密钥。只有 Bitcoin 数据。重在交付，而非空谈。 🚀

支持 Markdown

登录后评论

基本信息

作者: aiindigo925
语言: node
版本: 3.0.1
传输方式: stdio
收录时间: 2026年2月11日
最近更新: 5 周前
官方 Registry: io.github.aiindigo925/btcfi

报告问题

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

BTCFi API

关于 BTCFi API

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

BTCFi API

免费套餐

快速入门

API 参考

Bitcoin 核心端点

智能端点

安全端点

ZK 证明端点

Solv Protocol 端点

跨链端点

Runes 端点

Taproot Assets 端点

Lightning Network 端点

投资组合端点

警报端点

价格端点

实时数据流

Agent 集成

系统端点

定价

身份验证

免费供用户使用

安全

自托管

文档

软件包与分发

贡献

许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？