提交提现

提交已签名的提现请求。

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 Key 与签名。

​

使用说明

• 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 平台 API 设备类型：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> · 必填

链标识，与 GET /networks 的 network 一致。仅接受上述 canonical 值； 不接受简写别名 eth、sol、arb（请求将返回 INVALID_ARGUMENT）。

可用选项: 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

可选；省略时等于 address。OpenAPI 须与 sign_data 一致且仅支持已绑定钱包

响应

200

application/json

受理成功

code · integer

业务码，0 表示成功

示例:

0

message · string

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

示例:

"success"

reason · string

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

trace_id · string

链路追踪 ID，排障时提供

data · object

Show child attributes