提交提現

提交已簽名的提現請求。

POST /api/v4/dexbuilder/withdraw/submit

提交提現

cURL

curl --request POST \
  --url https://api.dexbuilder.com/api/v4/dexbuilder/withdraw/submit \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --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 '
{
  "r": "<string>",
  "v": 123,
  "s": "<string>",
  "chain": "ethereum",
  "token_address": "<string>",
  "address": "<string>",
  "token_amount": "<string>",
  "timestamp": 123,
  "token_symbol": "<string>",
  "to_address": "<string>"
}
'

200

Example

{
  "code": 0,
  "message": "success",
  "reason": "<string>",
  "trace_id": "<string>",
  "data": {
    "event_id": "<string>",
    "success": true
  }
}

提交已簽名的提現請求。

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

​

使用說明

• r、v、s 為使用者的簽名分量；timestamp 為毫秒級時間戳，須與獲取提現簽名資料的回傳值一致。
• to_address 可省略；若提供，須與已綁定的 address 一致，且與簽名資料請求保持一致。
• Idempotency-Key 必填。同一使用者在此介面以相同 Key 重試時，回傳首次成功的回應。success=true 表示已受理；最終狀態請查詢提現狀態。

授權

KEY · string · header · 必填

Broker API Key

Timestamp · string · header · 必填

Unix 秒級時間戳

SIGN · string · header · 必填

使用 Broker Secret Key 生成的 HMAC-SHA512 十六進制簽名

標頭

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

目標終端使用者錢包地址。網關校驗該錢包對應的使用者屬於當前 Broker。

Idempotency-Key · string · 必填

冪等鍵，最長 128 字符，建議使用 UUID。同一使用者在同一提交介面使用相同 Key 重試時，服務端回傳首次成功請求的回應；網路超時後可使用原 Key 重試。不同請求不得復用 Key。

Maximum string length: 128

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

DexBuilder 設備類型：1 Android、2 iOS、3 WEB。缺少或無效時回傳 INVALID_DEVICE_TYPE。僅適用於明確列出此請求標頭的平台介面。

可用選項: 1, 2, 3

主體

application/json

r · string · 必填

對 sign_data.data 簽名的 r（0x hex）

v · integer · 必填

簽名 v，整數（如 27/28）

s · string · 必填

簽名 s（0x hex）

chain · enum<string> · 必填

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

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

範例:

"ethereum"

token_address · string · 必填

代幣合約

address · string · 必填

使用者錢包，須與 sign_data 請求一致

token_amount · string · 必填

提現數量

timestamp · integer<int64> · 必填

須等於 sign_data 回應中的 timestamp

token_symbol · string · 必填

代幣符號

to_address · string

選填；若提供，必須與綁定的簽名錢包地址一致。不支援提現至第三方地址。

回應

200

application/json

受理成功

code · integer

業務碼，0 表示成功

範例:

0

message · string

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

範例:

"success"

reason · string

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

trace_id · string

鏈路追蹤 ID，排障時提供

data · object

Show child attributes