获取充值签名数据

构建链上充值所需的签名数据。

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

​

使用说明

• 建议先调用估算充值手续费，将 native_fee 原样传入，并将 lz_fee 按 USDT 6 位小数转换为整数。
• 首次成功调用可能为用户绑定 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 平台 API 设备类型：1 Android、2 iOS、3 WEB。缺失或取值无效时返回 INVALID_DEVICE_TYPE。仅适用于列明此请求头的平台接口。

可用选项: 1, 2, 3

请求体

application/json

address · string · 必填

用户钱包，须已绑定；与 X-User-Wallet-Address 一致

chain · enum<string> · 必填

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

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