獲取充值簽名資料

構建鏈上充值所需的簽名資料。

POST /api/v4/dexbuilder/deposit/sign_data

獲取充值簽名資料

cURL

curl --request POST \
  --url https://api.dexbuilder.com/api/v4/dexbuilder/deposit/sign_data \
  --header 'Content-Type: application/json' \
  --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>' \
  --data '
{
  "address": "<string>",
  "chain": "ethereum",
  "token_address": "<string>",
  "token_amount": "<string>",
  "token_symbol": "<string>",
  "native_fee": 123,
  "lz_fee": 123
}
'

200

Example

{
  "code": 0,
  "message": "success",
  "reason": "<string>",
  "trace_id": "<string>",
  "data": {
    "account_id": "<string>",
    "broker_hash": "<string>",
    "token_hash": "<string>",
    "token_amount": "<string>",
    "contract_address": "<string>",
    "data": "<string>"
  }
}

構建鏈上充值所需的簽名資料。

使用 Broker API Key 呼叫，並在請求頭提供 X-User-Wallet-Address。網關會校驗錢包與 Broker 的歸屬關係。 認證規則見Broker API 認證與簽名。

​

使用說明

• 建議先呼叫估算充值手續費，將 native_fee 原樣傳入，並將 lz_fee 按 USDT 六位小數轉換為整數。
• 首次成功呼叫可能為使用者綁定 Perp 帳戶；重複呼叫不會重複綁定。回傳的 contract_address 與 data 用於構造鏈上交易。
• x-perp-device-type 必填，僅支援 1、2、3。

授權

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

主體

application/json

address · string · 必填

使用者錢包，須已綁定；與 X-User-Wallet-Address 一致

chain · enum<string> · 必填

網路標識：base、bsc、ethereum、solana 或 arbitrum。

可用選項: base, bsc, ethereum, solana, arbitrum

範例:

"ethereum"

token_address · string · 必填

代幣合約地址

token_amount · string · 必填

充值數量，十進制字符串

token_symbol · string · 必填

代幣符號

native_fee · integer<int64>

來自 POST /deposit/fee 的 native_fee（int64，鏈原生幣最小單位）

lz_fee · integer<int64>

來自 POST /deposit/fee：USDT 6 位小數轉 int64（如 lz_fee 字符串 "0.5" → 500000）；native_fee 原樣 int64

回應

200

application/json

成功

code · integer

業務碼，0 表示成功

範例:

0

message · string

人類可讀說明，成功時為 success

範例:

"success"

reason · string

錯誤原因標識；成功時通常為空字符串

trace_id · string

鏈路追蹤 ID，排障時提供

data · object

Show child attributes