查询 Vault 余额

用户交易前需将 USDT 充值至个人合约金库（Vault）。每位用户拥有独立的 Vault，交易产生的资金变动将直接计入该 Vault。此接口用于查询终端用户 Vault 中的可用余额。

GET /api/v4/dexbuilder/user/balance

查询 Vault 余额

cURL

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

200

Example

{
  "code": 0,
  "message": "success",
  "reason": "<string>",
  "trace_id": "<string>",
  "data": {
    "available": "100.5"
  }
}

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

​

使用说明

• available 为 USDT 计价的 Vault 可用余额。调用时按 OpenAPI 要求提供 x-perp-device-type。

授权

KEY · string · header · 必填

Broker API Key

Timestamp · string · header · 必填

Unix 秒级时间戳

SIGN · string · header · 必填

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

请求头

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

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

x-perp-device-type · enum<string> · 必填

DexBuilder 平台 API 设备类型：1 Android、2 iOS、3 WEB。缺失或取值无效时返回 INVALID_DEVICE_TYPE。仅适用于列明此请求头的平台接口。

可用选项: 1, 2, 3

响应

200

application/json

查询成功

code · integer

业务码，0 表示成功

示例:

0

message · string

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

示例:

"success"

reason · string

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

trace_id · string

链路追踪 ID，排障时提供

data · object

Show child attributes