跳转到主要内容
简而言之
收款人是已保存的付款目标——有名称的钱包地址，您可以通过 ID 引用，而无需每次发送资金时都输入原始地址。将其视为您的加密支付联系人列表。

​
前提条件

1

API 密钥

从 Blockradar 控制台 获取您的 API 密钥。
2

已创建钱包

您需要 walletId 将收款人与钱包关联。

​
工作原理

收款人允许您一次注册一个目标地址，给它一个名称，并在所有未来的付款中通过 ID 引用它，消除错别字并创建清晰的审计记录。

保存一次，多次使用

将目标地址注册为命名收款人，并在任意数量的提款中重复使用。

减少人为错误

通过按 ID 引用地址而非手动输入，消除复制粘贴错误。

审计记录

每个收款人都有创建时间戳和名称，便于追踪付款对象。

地址白名单

将收款人作为地址白名单策略的一部分，将付款限制在预先批准的目标地址。

​
创建收款人

POST /v1/wallets/{walletId}/beneficiaries

const beneficiary = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/beneficiaries`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
    body: JSON.stringify({
      name: 'Alice 财务钱包',
      address: '0xabc123...',
      assetId: 'asset_usdc_base_mainnet'
    })
  }
).then(r => r.json());

​
管理收款人

操作端点
创建POST /v1/wallets/{walletId}/beneficiaries
获取全部GET /v1/wallets/{walletId}/beneficiaries
获取单个GET /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}
更新PATCH /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}
删除DELETE /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}

​
最佳实践

  • 清晰命名收款人 — 使用能识别人员、团队或用途的名称。
  • 定期审查 — 审计收款人列表，删除不再活跃的目标地址。
  • 结合白名单使用 — 如果合规要求将付款限制在已批准的地址，使用收款人作为白名单层。

​
API 参考

端点描述
创建收款人保存新的目标地址
获取全部列出所有已保存的收款人
获取单个按 ID 获取收款人
更新更新收款人详情
删除删除收款人