多链资产明细查询指南：地址维度查资产、链上信息与Web3钱包API实战

只需一个地址，即可实时掌握以太坊、比特币、Fractal Bitcoin 等15+主链与主流二层的全部 token 余额；既能快速捕捉铭文行情，又能一键屏蔽风险空投。

1. 核心功能一览

多维资产查询
统一接口一次性返回主链币（ETH、BTC）、所有 ERC-20、BRC-20、Runes、SRC-20、Fractal Bitcoin FBRC-20、ARC-20 等各类资产余额。
智能风险过滤
支持过滤“空投地雷”代币，默认自动剔除风险币种，资产列表更干净。
极速调试体验
RESTful API + 真实链上数据 → 毫秒级响应，可直接嵌入自托管钱包、DApp 或数据分析面板。

2. 快速上手：如何调用钱包API

2.1 请求方式

GET https://web3.okx.com/api/v5/wallet/asset/all-token-balances-by-address

2.2 必填参数

参数名	类型	说明
address	string	公链地址（0x开头或bc1开头均可）
chains	string	逗号分隔的链名；例: ethereum,base,optimism,dogecoin

2.3 可选参数

filter
0 = 过滤风险空投币（默认）
1 = 不过滤，显示全部

示例请求

curl "https://web3.okx.com/api/v5/wallet/asset/all-token-balances-by-address?address=0xabc...&chains=ethereum,bitcoin,base&filter=0"

3. 手把手调试案例

场景：查询某 U 本位地址在三条链上的资产明细

复制测试地址：bc1ph8p3...
将链名字符串写为：bitcoin,fractal,ethereum
过滤器保持默认
Bash 一键执行，约 200 ms 返回 JSON。

👉 立即测试你的钱包地址，30 秒看懂资产分布！

返回样例节选

{
  "tokenAssets":[
    {
      "chainIndex":"bitcoin",
      "symbol":"BRC-20 ORDI",
      "balance":"150.5",
      "transferAmount":"150.5",
      "availableAmount":"0",
      "tokenType":"2"
    },
    {
      "chainIndex":"ethereum",
      "symbol":"USDC",
      "balance":"2000.000012",
      "tokenType":"1"
    }
  ]
}

解读：

ORDI 已铭刻完成，150.5 枚可立即转账；无需再铭刻。
USDC 为传统 ERC-20，无“可转 / 待铭刻”概念。

4. 常见问题 FAQ

Q1：最多支持多少条链同时查询？
A：单请求可写 50 个链名，足够覆盖主流场景。

Q2：原生 BTC 余额会返回在哪个字段？
A：原生 BTC 的 symbol 为 "BTC"，tokenType 为 1，其余同常规 token。

Q3：如何识别被风控的代币？
A：每条资产附带 isRiskToken:true|false，一目了然。

Q4：为什么部分铭文资产有“transferAmount”与“availableAmount”两项？
A：BRC-20、FBRC-20 需先铭刻才能转账；前者表示已铭刻、可直接交易的数量，后者为“待铭刻”状态。

Q5：返回价格单位是？
A：全部以 美元 U本位 计价，便于统一评估持仓市值。

Q6：接口频率限制？
A：默认 100 次/s；如需更高可联系技术支持。

👉 解锁更高 QPS，让你的链上数据面板永不卡顿！

5. 扩展场景：把钱包即服务（WaaS）搬到产品里

DApp 仪表盘
嵌入同款 API，在用户连接钱包后即时拉取跨链资产。
财富管理工具
统计 NFT、DeFi LP、铭文市值，生成一目了然的饼图。
空投狩猎机器人
结合 isRiskToken 字段，实时帮社区过滤垃圾币。

6. 结语

无需自建节点、不用运维海量 SDK，只需一条链上信息查询 API，即可省时省力完成地址维度查资产。从比特币铭文到 EVM 全线代币，一键搞定全部资产明细。现在就把钱包 API 集成，释放多链钱包的无限可能！