> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 地址 API

> 为您的用户生成和管理子地址。

地址 API 允许您为每个用户生成专用的充值地址。每个地址都是主钱包的子地址，并继承其网络和资产配置。

## 功能概述

* 为用户生成新的充值地址
* 查询地址详情、余额和交易历史
* 更新地址元数据
* 将地址加入或移出提现白名单

## 核心概念

**一个用户一个地址。** 切勿在不同用户之间复用地址。每个地址应永久分配给一个用户，以便正确归属充值。

**EVM 兼容性。** 在 EVM 兼容链上，单个地址可跨所有支持的 EVM 网络使用。

## 端点

| 方法       | 端点                                                       | 描述       |
| -------- | -------------------------------------------------------- | -------- |
| `GET`    | `/wallets/{walletId}/addresses`                          | 列出所有地址   |
| `POST`   | `/wallets/{walletId}/addresses`                          | 生成新地址    |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}`              | 获取地址详情   |
| `PATCH`  | `/wallets/{walletId}/addresses/{addressId}`              | 更新地址元数据  |
| `POST`   | `/wallets/{walletId}/addresses/{addressId}/whitelist`    | 将地址加入白名单 |
| `DELETE` | `/wallets/{walletId}/addresses/{addressId}/whitelist`    | 将地址移出白名单 |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}/balance`      | 获取单一资产余额 |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}/balances`     | 获取所有资产余额 |
| `GET`    | `/wallets/{walletId}/addresses/{addressId}/transactions` | 列出交易记录   |

<Card title="完整 API 参考" icon="book" href="/zh/api-reference/addresses/get-addresses">
  在 API 参考选项卡中查看所有地址端点。
</Card>