---
url: /reference/catalog.md
---
# 资产目录

资产目录：支持的链、资产，地址校验

## 地址校验

```http
POST /v1/addresses/validate
```

API key 权限范围: `read`

地址校验：格式是否正确、是否平台内地址（平台内地址提现走内部转账，不上链）

**请求体**

| 字段 | 类型 | 说明 |
|---|---|---|
| `address` | string | 地址 |
| `chain_code` | string | 链代码 |

请求示例：

```json
{
  "address": "TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf",
  "chain_code": "TRON"
}
```

**响应** (200, `AddressValidation`)

| 字段 | 类型 | 说明 |
|---|---|---|
| `internal` | boolean | 是否平台内的用户充值地址：是则提现到该地址走内部转账（即时到账、不上链、无手续费） |
| `normalized_address` | string | 规整后的地址（EVM 为全小写）；无效时为空 |
| `valid` | boolean | 格式是否正确 |

响应示例：

```json
{
  "internal": false,
  "normalized_address": "TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf",
  "valid": false
}
```

失败时返回统一错误体，见 [错误处理](/guide/errors)。

## 支持的资产

```http
GET /v1/assets
```

API key 权限范围: `read`

支持的资产：链 × 币种（精度、合约、最小充值 / 提现额、手续费），可按链过滤

**请求参数**

| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| `chain_code` | 查询 | string | 否 | 链代码：可选，不传返回所有启用链的资产 |

**响应** (200, `AssetList`)

| 字段 | 类型 | 说明 |
|---|---|---|
| `assets` | object (Asset)\[] |  |
| `assets[].chain_code` | string |  |
| `assets[].contract_address` | string | 合约地址；原生币为空 |
| `assets[].decimals` | integer |  |
| `assets[].deposit_enabled` | boolean |  |
| `assets[].explorer_url_template` | string | 区块浏览器交易链接模板，{txHash} 替换为交易哈希 |
| `assets[].min_deposit_amount` | string | 以下金额为主单位十进制字符串 |
| `assets[].min_withdraw_amount` | string |  |
| `assets[].token_code` | string | 币种代码，如 USDT |
| `assets[].token_name` | string |  |
| `assets[].withdraw_enabled` | boolean |  |
| `assets[].withdraw_fee` | string |  |

响应示例：

```json
{
  "assets": [
    {
      "chain_code": "TRON",
      "contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
      "decimals": 6,
      "deposit_enabled": false,
      "explorer_url_template": "https://tronscan.org/#/transaction/{txHash}",
      "min_deposit_amount": "1",
      "min_withdraw_amount": "10",
      "token_code": "USDT",
      "token_name": "Tether USD",
      "withdraw_enabled": false,
      "withdraw_fee": "1"
    }
  ]
}
```

失败时返回统一错误体，见 [错误处理](/guide/errors)。

## 支持的链

```http
GET /v1/chains
```

API key 权限范围: `read`

支持的链：只返回启用的链

**响应** (200, `ChainList`)

| 字段 | 类型 | 说明 |
|---|---|---|
| `chains` | object (Chain)\[] |  |
| `chains[].code` | string | 链代码：TRON / ETH / BSC |
| `chains[].evm_chain_id` | string | EVM chainId（如 "1"、"56"），TRON 为空 |
| `chains[].name` | string |  |

响应示例：

```json
{
  "chains": [
    {
      "code": "TRON",
      "evm_chain_id": "",
      "name": "TRON"
    }
  ]
}
```

失败时返回统一错误体，见 [错误处理](/guide/errors)。