资产目录

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

地址校验

POST /v1/addresses/validate

API key 权限范围: read

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

请求体

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

请求示例：

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

响应 (200, AddressValidation)

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

响应示例：

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

失败时返回统一错误体，见 错误处理。

支持的资产

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

响应示例：

{
  "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"
    }
  ]
}

失败时返回统一错误体，见 错误处理。

支持的链

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

响应示例：

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

失败时返回统一错误体，见 错误处理。