钱包账户管理完全指南：一文掌握多链地址生命周期

·

为什么选择钱包即服务？

使用钱包即服务（WaaS）API，DApp 可在分钟级别内完成「创建 – 查询 – 删除」钱包账户的完整生命周期，而无需自建节点、私钥托管或复杂签名。核心关键词已悄然融入：钱包账户管理、Web3 API、多链地址、钱包创建、链上信息查询、交易广播、签名 SDK。

钱包账户管理能做什么？

钱包账户管理 API 把以下五大动作打包进一条标准化的 REST 路线：

  1. 创建账户
    一次性为比特币、EVM、Solana 等主流公链生成对应公钥–私钥对，返回聚合后的账户 ID。
  2. 更新账户
    修改别名、标签，或追加/解绑新的链。API 会即时同步到签名 SDK，避免重签。
  3. 删除账户
    彻底移除账户及其派生地址。被删除的地址将在链上依然有效，但平台侧无法再用其发起交易。
  4. 查询账户
    列表形式拉取所有已创建的账户，支持按创建时间、链类型、标签过滤。
  5. 查询地址详情
    输入账户 ID，批量输出该账户下每种链的派生地址、余额小计、最近交易哈希。
提示：以上动作全部走 HTTPS，内容加密传输，私钥永远保留在用户端，绝不外泄。

快速开始：5 步上手钱包即服务

  1. 注册开发者后台 → 2. 拿到 API Key → 3. 选择支持的网络（见下节）→ 4. 调通「创建账户」 → 5. 调「查询账户」验证余额。
    若追求极速接入，可直接复制官方 Postman 示例并替换你的密钥。

支持的网络总览

目前支持 30+ 网络：
比特币主网、L2（Lightning、Stacks）、EVM 系列（ETH、BSC、Polygon、Arbitrum、Optimism、Base）、非 EVM（Solana、TON、Aptos、Sui、Tron）。
官方每季度主动迭代更新；测试网与主网签名方法完全一致，一键切换。

👉 立即体验零配置的多链地址创建流程

各接口精讲

1. 创建账户

请求示例（省略敏感参数）：

POST /api/v5/wallet/account/create
{
  "chains": ["BTC", "ETH", "SOL"],
  "label": "VIP用户A",
  "memo": "Scene_Marketing_Airdrop"
}

响应亮点：accountId 是全局唯一字符串，后续所有「查询」类 API 都依赖它；同时返回各链的派生地址和二维码，方便用户扫码收款。

2. 更新账户

仅需携带要调整的字段：

PATCH /api/v5/wallet/account/{accountId}
{
  "label": "VIP用户A_已升级"
}

平台型 DApp 可通过「监听 Webhook + Update」做用户分层，实现个人礼金、Gas 补贴等运营玩法。

3. 删除账户

删除是软删除，键值仅对用户侧失效；如需彻底销毁私钥，可配合客户端签名 SDK 本地擦写。

4. 查询账户

高并发场景可叠加分页参数：

GET /api/v5/wallet/account/list?pageSize=50&chain=EVM

返回字段已按余额从高到低排序，降低前端排序压力。

5. 查询账户下的地址

一次性拿回全部链的详情，含「是否已激活」「合约地址 flag」。NFT、DeFi 合约的空投检测脚本常以该接口为核心。

进阶用法：把钱包 API 嵌进产品链路

👉 点此查看完整错误码清单，减少调试时间

常见问题 FAQ

Q1：私钥到底存在哪？
A：加密后在用户端设备和签名 SDK 中生成，平台不存储明文。

Q2：EVM 地址是否符合 EIP55 校验格式？
A：是的，所有 EVM 派生地址均返回带大小写混合验证码的规范格式。

Q3：能否只创建比特币地址不做 EVM？
A：请求体 chains 数组直接填 ["BTC"] 即可，后续亦可通过「更新账户」追加。

Q4：删除账户后，原地址还能收款吗？
A：可以。删除仅影响平台侧标记，不影响链上资产安全；建议先转走再删除。

Q5：一个 API Key 能创建多少个账户？
A：默认 2,000 个；可在控制台提交工单提升额度，通常 1 个工作日内批复。

Q6：交易广播接口能与钱包账户管理 API 混用吗？
A：完全兼容。账户管理仅解决「地址生命周期」，交易广播负责「签名后上链」，两者按场景串联即可。

最佳实践小结

至此，你已掌握钱包账户管理的核心要点。从最初的一条「钱包创建」请求，到最终执行「交易广播」将资产打到链上，全流程无缝且高安全。祝编码愉快，愿每一次 accountId 的诞生都为 Web3 世界带来新的可能！