查询钱包列表

查询终端用户的全部已绑定钱包。

GET /api/v4/dexbuilder/wallet/list

查询钱包列表

cURL

curl --request GET \
  --url https://api.dexbuilder.com/api/v4/dexbuilder/wallet/list \
  --header 'KEY: <api-key>' \
  --header 'SIGN: <api-key>' \
  --header 'Timestamp: <api-key>' \
  --header 'X-User-Wallet-Address: <x-user-wallet-address>'

200

Example

{
  "code": 0,
  "message": "success",
  "reason": "<string>",
  "trace_id": "<string>",
  "data": {
    "items": [
      {
        "wallet_id": "<string>",
        "vm": "<string>",
        "address": "<string>",
        "status": "<string>",
        "is_primary": true,
        "bound_at": 123
      }
    ]
  }
}

查询终端用户的全部已绑定钱包。

使用 Broker API Key 调用，并在请求头提供 X-User-Wallet-Address。网关会校验钱包与 Broker 的归属关系。 认证规则见Broker API Key 与签名。

​

使用说明

• 当前返回全部已绑定钱包，不分页。钱包对象中的 vm 表示虚拟机类型（evm 或 solana），具体网络请查询资产网络；bound_at 为 Unix 毫秒时间戳。

授权

KEY · string · header · 必填

Broker API Key

Timestamp · string · header · 必填

Unix 秒级时间戳

SIGN · string · header · 必填

使用 Broker Secret Key 生成的 HMAC-SHA512 十六进制签名

请求头

X-User-Wallet-Address · string · 必填

目标终端用户钱包地址。网关校验该钱包对应的用户属于当前 Broker。

响应

200

application/json

查询成功

code · integer

业务码，0 表示成功

示例:

0

message · string

人类可读说明，成功时为 success

示例:

"success"

reason · string

错误原因标识；成功时通常为空字符串

trace_id · string

链路追踪 ID，排障时提供

data · object

Show child attributes