创建钱包

POST /open/v1/wallets。需要Bearer accessToken与逐请求签名。

每次创建返回一个钱包 ID 和一个 TRON 收款地址。接口不返回私钥和创建时的余额。

JSON请求参数

参数	类型	必填	说明
custom_id	string	是	同租户唯一，1至32个字符，无首尾空白
request_id	string	是	持久化幂等键，UTF-8 编码长度16至128字节，建议使用36位ASCII UUID

不传network、tenant_id、私钥或临时目标，禁止Query和Idempotency-Key请求头。

{
  "custom_id": "customer-001",
  "request_id": "123e4567-e89b-42d3-a456-426614174000"
}

成功响应

{
  "code": 0,
  "message": "",
  "data": {
    "id": "123456789012345678",
    "address": "TQyeXvAnmKsBqo6V48RmhAnZpWLmR2D7DM",
    "custom_id": "customer-001",
    "chain": "TRON",
    "created_at": "2030-01-01T00:00:00Z",
    "network": "nile"
  }
}

字段	类型	说明
data.id	string	钱包ID
data.address	string	TRON地址
data.custom_id	string	租户自定义ID
data.chain	string	TRON
data.network	string	资产所属网络：main（主网）或 nile（测试网络）
data.created_at	string	RFC3339创建时间

同键同参数返回原响应，同键改参数或重复custom_id返回409。后续通过钱包详情查询钱包余额和状态。初次余额同步前为null，显示待同步。

HTTP400参数错误、401鉴权失败、403租户不可用、409幂等或自定义ID冲突；成功HTTP200。签名及可运行客户端见下载示例。

完整字段与状态

查看全部响应字段、嵌套对象及枚举 · 业务状态与处理 · 错误码排查。