查詢 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 認證與簽名。

​

使用說明

• 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 設備類型：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