加密货币地址余额查询技能Skill 用法详解

加密货币地址余额查询：一个技能搞定多链钱包余额核对

一句话价值主张：输入一个链上地址，自动识别所属公链并调用免费公共 API 返回原生币余额，无需 API 密钥即可完成比特币、以太坊、BSC、Solana、莱特币等多链查询。

先看几条核心结论：

多链覆盖：原生支持 BTC、ETH、BSC、SOL、LTC 五大主流链，并通过 Blockchair 额外延伸至 DOGE、BCH、Dash、Ripple、Stellar、Cardano、Zcash 等链。
零密钥起步：基本查询不需要注册任何 API 密钥，直接用免费公共接口即可返回结果。
自动换算：把比特币的「聪」、以太坊与 BSC 的「wei」、Solana 的「lamports」统一换算为 BTC / ETH / BNB / SOL / LTC 等原生货币单位。
自带限流策略：技能内置了请求间隔、结果缓存、429 指数退避等速率限制最佳实践，避免被公共接口拒绝。
可组合：可与「获取加密货币价格」类技能配合，把余额进一步换算为法币估值。

该技能叫什么？如何一键安装 AI 技能提升开发效率？

技能中文名：加密货币地址余额查询技能Skill 技能英文名：check-crypto-address-balance 技能ID：13129

它解决的是一个非常具体的痛点：区块链数据分散在上百条链、几十个浏览器和几十套 API 之间，同一个「查余额」的动作，在比特币上要处理「聪」，在以太坊上要处理「wei」，在 Solana 上要发 JSON-RPC POST 请求，在莱特币上又要换一套返回结构。开发者往往为了一个简单的余额核对，写一堆重复的适配代码；非技术用户则需要在不同区块链浏览器之间来回切换、手动数小数点。

这个技能把「地址格式识别 → 选择合适公链 API → 请求 → 单位换算 → 输出原生币余额」这一整条链路打包成一个标准能力，交给 AI 助手按需调用。

一键安装 AI 技能提升开发效率的思路，本质是把重复的链上查询逻辑从「每次重写」变成「一次接入、处处复用」：

确认安装前提：你需要一个支持 AI 技能（Skill）机制的环境，例如支持技能市场的 AI 客户端或本地技能目录。技能本身基于公开 HTTP 接口实现，不依赖复杂的私有 SDK 或付费节点。
按名称或 ID 检索技能：在技能市场或技能管理入口中搜索英文名 check-crypto-address-balance，或直接使用技能 ID 13129 定位；若为本地技能目录方式接入，则按平台规范把技能说明文件放入对应目录。具体命令与目录规范因平台而异，以官方说明为准。
启用并授权：技能需要发起外部 HTTPS 请求（访问 blockchain.info、etherscan.io、bscscan.com、Solana 公共 RPC、chain.so、blockchair.com 等），请在环境允许出网的前提下启用，企业内网环境需放行这些域名。
验证是否生效：安装完成后，直接对 AI 助手说一句「帮我查一下这个比特币地址的余额：1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa」。若返回以 BTC 为单位的余额数值（并说明已由「聪」换算），且能解释所用接口，即表示技能已正常工作。
进阶建议：生产环境建议为 Etherscan / BscScan 申请免费 API 密钥以提升速率上限，具体申请方式与配额 以官方说明为准。

该技能的主要功能和特点

多链余额查询：覆盖 BTC、ETH、BSC、SOL、LTC，并提供每条链至少一个备选免费 API，避免单点不可用。
地址格式自动识别链：BTC 地址以 1、3 或 bc1 开头；ETH/BSC 地址以 0x 开头且为 42 个字符；SOL 为 32–44 位 base58 字符串且不含 0x；LTC 以 L 或 M 开头。用户不必先说明是哪条链。
单位自动换算：比特币「聪」除以 1e8 得 BTC；以太坊与 BSC 的「wei」除以 1e18 得 ETH / BNB；Solana 的「lamports」除以 1e9 得 SOL；莱特币接口本身即返回 LTC，直接读取确认余额字段。
无需 API 密钥：官方描述明确指出「无需 API 密钥即可进行基本查询」，适合快速验证、脚本原型和一次性核对。
速率限制工程化：内置对同一 API 请求间隔 1–2 秒、结果缓存至少 30 秒、HTTP 429 时指数退避的建议，并用表格标注各接口的限流值（如 Blockchain.info 约 1 请求/10 秒、Blockchair 30 请求/分钟、BlockCypher 200 请求/小时）。
多链辅助函数：技能内置 Node.js 版统一入口函数 getBalance(chain, address)，把四条链的差异封装在一个调用里，Solana 走独立分支处理 JSON-RPC。
生态延伸：通过 Blockchair 可覆盖 BTC、ETH、LTC、DOGE、BCH、Dash、Ripple、Groestlcoin、Stellar、Monero（需查看密钥）、Cardano、Zcash（t 地址）等额外链。
与普通工具的差异：普通区块链浏览器是「人去查、人去看」；本技能是「AI 去查、AI 解释」，并且能在一个对话里连续对多个链、多个地址做批量核对与汇总，还能与价格类技能串联做估值。

如何使用该技能？

步骤一：直接用自然语言发起查询

把地址丢给 AI 助手即可，例如：「查一下 0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae 的余额」。技能会从格式判断这是 ETH/BSC 地址，再结合上下文或询问确认具体链。

步骤二：理解技能的输入与输出

输入是一个链上公开地址（可选指定链）；输出是该地址在对应链上的原生币余额，单位统一为主币（BTC、ETH、BNB、SOL、LTC），而不是最小单位。

步骤三：命令行方式（BTC 示例）

# 使用 Blockchain.info，返回单位：聪，需除以 100000000 转为 BTC
curl -s "https://blockchain.info/q/addressbalance/1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"

步骤四：命令行方式（ETH / BSC / SOL / LTC 示例）

# 以太坊：返回 wei
curl -s "https://api.etherscan.io/api?module=account&action=balance&address=0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae&tag=latest" | jq -r '.result'

# BSC：与 Etherscan 同一套接口，返回 wei
curl -s "https://api.bscscan.com/api?module=account&action=balance&address=0x8894E0a0c962CB723c1976a4421c95949bE2D4E3&tag=latest" | jq -r '.result'

# Solana：JSON-RPC，返回 lamports
curl -s https://api.mainnet-beta.solana.com -X POST -H "Content-Type: application/json" -d '
{"jsonrpc":"2.0","id":1,"method":"getBalance","params":["vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg"]}' | jq '.result.value'

# 莱特币：直接返回 LTC
curl -s "https://chain.so/api/v2/get_address_balance/LTC/LTC_ADDRESS/6" | jq -r '.data.confirmed_balance'

步骤五：在代码里统一调用

技能的 Node.js 辅助函数把多链差异收敛成一个入口，调用方式为 getBalance('ETH', '0x...')，返回值已是换算后的原生币数量，可直接参与后续计算或写入报表。

步骤六：控制频率

批量查询时，对同一 API 保持 1–2 秒间隔；对同一地址的重复查询使用至少 30 秒缓存；遇到 HTTP 429 采用指数退避重试，不要高频轮询。

同类型竞品对比分析

方案名称	定位	核心功能	安装 / 使用门槛	适用场景	优势与不足
本技能（check-crypto-address-balance）	AI 助手内置的多链余额查询能力	自动识别链、多链余额查询、单位换算、内置限流策略	在支持技能的环境中添加即可，基本查询无需 API 密钥	对话式核对、脚本原型、多链批量查询、开发辅助	优势：零密钥起步、多链统一出口、可与 AI 对话组合；不足：依赖公共接口稳定性，高频场景仍需自备密钥
区块链浏览器网页（如 Blockchain.com、Etherscan、BscScan 站点）	人工查询工具	余额、交易记录、代币、合约等全量浏览	打开网页输入地址即可，零门槛	一次性人工核对、查看交易明细	优势：信息最全、可视化强；不足：需人工逐链切换、无法批量、不能直接进入程序流程
商业节点 / RPC 服务（如付费节点与区块链数据服务商）	生产级基础设施	高并发 RPC、归档数据、WebSocket 订阅	需注册、申请密钥、配置配额，通常涉及付费	钱包服务、交易所级高频查询、DApp 后端	优势：稳定、配额高、SLA 保障；不足：接入成本与费用较高，小规模需求性价比低
通用多链数据聚合 API（如 Blockchair 直接调用）	数据聚合接口	多链余额与链上统计，含额外元数据	需自行读文档、写请求、处理返回结构，匿名调用有频率限制	数据分析、批量报表	优势：一次接入覆盖多链；不足：仍需自行做单位换算与链识别，不具备对话式交互

该技能的典型应用场景与实际体验情况

场景一：独立开发者做收款对账 开发者做了个小工具，用户用 BTC 或 ETH 付款后需要核验到账。痛点是每条链都要单独写适配、单独处理单位。使用方式是让技能返回换算后的 BTC / ETH 数值，直接与订单金额比对。实际体验：上手几乎零成本，getBalance 这类统一入口省掉了大量 if-else；注意点是要给查询加缓存，避免用户频繁刷新触发限流。

场景二：社群运营核实用户晒出的地址 社群管理员经常遇到用户贴地址声称「已转账」。使用方式是把地址发给 AI 助手，几秒内拿到余额和所属链。实际体验：BTC、ETH、SOL 这类格式特征明显的地址识别很快；需要注意的是 ETH 与 BSC 地址格式完全相同（都是 0x 开头 42 位），必须结合上下文确认到底查哪条链，否则会查到 0 或错链结果。

场景三：安全与尽调人员做地址筛查 在空投、合作方核验等场景里，需要快速确认某个地址是否为「空钱包」。使用方式是批量提交地址，由技能逐条查询并汇总。实际体验：批量时速率限制是主要瓶颈，Blockchain.info 约 1 请求/10 秒的约束必须遵守；建议优先用限流更宽松的接口，并对结果做 30 秒以上缓存。

场景四：数据分析与研究 研究者需要抓取一组地址在各链上的余额分布。使用方式是通过 Blockchair 多链接口或各链专用接口组合调用，再由 AI 汇总成表格。实际体验：Blockchair 一次覆盖多链很省事，但返回结构带额外元数据，需要明确取哪个字段；另外 Solana 走独立 JSON-RPC，不能与其余链共用同一套解析逻辑。

整体上手难度：低。对话式调用完全不需要懂代码；代码级调用需要理解各链最小单位换算，但技能文档已把换算规则写清楚。注意事项：公共接口可能因维护临时不可用、部分接口返回字段可能调整、地址查询虽为公开数据但仍应注意隐私与合规。

该技能能为用户带来的价值

效率提升：把「切换多个浏览器 + 手动换算小数位」压缩成一次提问，多链核对从分钟级缩短到秒级。
门槛降低：基本查询无需 API 密钥、无需注册账号，非技术人员也能完成链上余额核对；开发者不必为每条链重写适配代码。
错误减少：单位换算是链上查询最容易出错的地方（聪、wei、lamports 各有 8、18、9 位小数），技能把换算内置，减少「少看几个零」的误判。
成本可控：优先使用免费公共接口，小规模需求零成本；真正上量时再按官方说明申请免费密钥，路线平滑。
长期价值：多链统一出口的设计让新增链的成本很低，Blockchair 已把 DOGE、BCH、Dash、Cardano 等十余条链接入视野，后续扩展不需要重构调用方式；同时可与价格类技能串联，形成「余额 + 估值」的完整链路。

常见问题 FAQ

Q1：这个技能怎么安装？ A：在支持 AI 技能的环境里，用英文名 check-crypto-address-balance 或技能 ID 13129 检索并添加；若为本地技能目录方式，按平台规范放置技能说明文件即可。具体命令、目录路径与授权方式因平台而异，以官方说明为准。安装后用任意一个公开地址试查一次即可验证是否生效。

Q2：使用需要付费或申请 API 密钥吗？ A：不需要。技能的核心卖点就是「使用免费公共 API」「无需 API 密钥即可进行基本查询」。只有当你需要更高频率（例如 Etherscan、BscScan 的免费密钥可提升速率上限）或生产级稳定性时，才建议按官方说明申请密钥。

Q3：适合哪些人使用？ A：适合需要频繁核对链上余额的人，包括做收款对账的开发者、需要核实用户晒单的社群运营、做地址筛查的安全与尽调人员，以及需要抓取余额数据的研究者。只需要偶尔查一次余额的普通用户，直接用区块链浏览器网页也够用。

Q4：和直接用区块链浏览器网站相比，优势在哪？ A：浏览器胜在信息全、可视化好，但要人工逐链切换、无法批量、结果进不了程序流程。本技能胜在「对话即查询」和「多链统一出口」，适合批量核对、脚本集成和与 AI 工作流串联。两者是互补关系，不是替代关系。

Q5：为什么查到的余额是 0，或者查询失败了？ A：常见原因有三类。第一，链选错了——ETH 与 BSC 地址格式完全相同（都是 0x 开头 42 位），必须在正确的链上查询。第二，地址本身确实为空或尚未激活。第三，触发了公共接口的速率限制，返回 HTTP 429，此时应等待后重试并对结果做缓存。此外，公共节点偶发不稳定也会导致失败，可切换到该链的备选 API 重试。