想快速知道一个地址里到底有多少 比特币生态铭文、ERC20 甚至 Runes？本文用五分钟带你掌握「Total Token Balances」接口：输入地址，即可获得多链资产清单，还能自动过滤高风险空投。
核心关键词：多链代币查询、资产余额API、比特币铭文、风险管理、Web3数据接口
为什么需要「Total Token Balances」？
在 Web3 世界里，钱包地址常常藏宝般地分散在多条链：
- 以太坊地址也空投 Arbitrum 代币；
- Fractal Bitcoin 上可能躺着 FBRC-20 铭文；
- 更有不知名的空投币，一夜翻倍一夜归零。
一次性逐链找资产，工具稀缺且耗时。本接口通过 一并发 GET 请求 完成 多链代币查询，节省 90% 手动工作，并额外做一次 风险空投过滤。
支持范围与资产类型
| 资产类别 | 示例链 | 说明 |
|---|---|---|
| 原生代币 | ETH, BTC, BNB, SOL | 链主币余额 |
| ERC20 | Ethereum, Polygon | 80% DeFi 代币 |
| 比特币铭文 | BRC-20, ARC-20, Runes, SRC-20 | Meme 铭文、实验代币 |
| Fractal Bitcoin | FBRC-20 | 新增比特币扩展链支持 |
所有类型均在同一个 资产余额 API 内返回，结构一致，解析零障碍。
调用方式与关键字段
你只需要记住 3 个核心 查询参数：
- address（必需）
想要探查的钱包地址，可以是 EVM、Bitcoin、Solana 任意格式。 - chains（逗号分隔，最多 50 条）
例如：ethereum,polygon,arbitrum,bitcoin可精准聚焦目标链。 filter（可选）
- 0：自动剔除高风险空投；(默认)
- 1：不过滤，照单全收。
示例请求
GET https://web3.okx.com/api/v5/wallet/asset/all-token-balances-by-address?address=0x…&chains=ethereum,bitcoin&filter=0返回的主体 tokenAssets 包含：
- symbol & balance：一眼看懂代币余额
- tokenPrice：实时 USD 计价，轻松算总资产市值
- rawBalance + availableAmount：铭文类资产的「可转移额度」与「待铭额」
- isRiskToken：
true代表此类空投已标记为高风险代币，供你做风控决策。
即学即用：👉 三行代码即可批量读取任何地址的「比特币铭文余额」，立即试试！
场景示例
1. 链上分析师：Big Query 替代方案
过去用 Google BigQuery + 自建表，同步成本高。现在 1 个 GET 就把 多链代币余额 API 当数据仓库直接调取，报告时间从 2 天缩短至 10 分钟。
2. 钱包运营：实时仪表盘
DApp 内置「我的资产」页，后台每 15 秒轮询接口，前端用tokenPrice 动态算估值，再对 isRiskToken 弹红色提醒。
3. 铭文资产卖家
BRC-20 热门波动只用「transferAmount」便知道可供出售数量，无需逐笔浏览区块浏览器。
FAQ：最常见 5 个疑惑一次说清
Q1：一次最多查询多少条链？
最多 50 条。若列表较长，建议拆分为链簇分批调用，降低响应时间。
Q2：为什么某些币 balance 与钱包客户端对不上？
确认你是否把 filter=0（默认）设成 1。若过滤了可疑空投，本地展示“0 余额”的官方确实会更多。
Q3：比特币标准的 SRC-20 也能识别吗？
Yes。接口统一返回，tokenType=2 标识铭文资产，解析逻辑一致。
Q4：如何处理隐私地址？
接口只读取链上公开数据，不会触发签名。腾挪代币需链上交易，因此此方法 100% 无权限风险。
Q5：实时价格延迟多久？
tokenPrice 每 30 秒刷新一次。高频交易产品可在本地缓存并自行缩短轮询。
调优技巧：链选太少担心遗漏怎么办？
- 第一次查询：用 多链代币查询 + filter=0，剔除垃圾；
- 发现新空投后改用 filter=1 复查，验证是否标记 false - 及时抓取早期红利。
这样做兼顾精准风控与收益发现。
在高频场景里，可把常见的主网 + L2 + 铭文链固化成预设模板，保存到前端配置。👉 自动生成地址资产简报，10 秒搞定空投监控
一句话总结
「Total Token Balances」把 资产余额、比特币铭文、实时价格、风险评估 四合一打包给你。只需一个 HTTP 调用，就能让你的钱包工具、研究报告或投资策略拥有面对 多链代币查询 的“上帝视角”。现在就动手，去把那个地址翻个底朝天吧！