事件合约转账

在现货账户与事件合约账户之间发起 USDT 划转

POST /api/v4/broker/event_contracts/transfer

事件合约转账

cURL

curl --request POST \
  --url https://api.dexbuilder.com/api/v4/broker/event_contracts/transfer \
  --header 'Content-Type: application/json' \
  --header 'KEY: <api-key>' \
  --header 'SIGN: <sign>' \
  --header 'Timestamp: <timestamp>' \
  --header 'X-User-Wallet-Address: <x-user-wallet-address>' \
  --data '
{
  "currency": "USDT",
  "amount": "<string>",
  "client_oid": "<string>"
}
'

200

{
  "amount": "1.2",
  "currency": "USDT",
  "from_account": "spot",
  "status": "SUCCESS",
  "to_account": "sub_spot",
  "transfer_id": "123"
}

此接口仅供 Broker 使用。请求须携带 Broker API Key、Timestamp、SIGN 和 X-User-Wallet-Address。网关确认钱包属于当前 Broker 后转发。请按外部 /api/v4/broker/... 路径计算签名。详见Broker API 认证与签名.

在支持的账户之间发起 USDT 划转。

授权

KEY · string · header · 必填

Broker API Key（由项目方管理流程创建）

请求头

Timestamp · string · 必填

Unix 秒级时间戳，与网关时间差不超过 60 秒

SIGN · string · 必填

按实际外部请求路径、Query 和 Body 生成的 HMAC-SHA512 十六进制签名

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

目标终端用户的钱包地址；网关校验该钱包属于当前 Broker

请求体

application/json

from_account · enum<string> · 必填

可用选项: spot, sub_spot, event_contract

to_account · enum<string> · 必填

可用选项: spot, sub_spot, event_contract

currency · enum<string> · 必填

可用选项: USDT

amount · string · 必填

client_oid · string · 必填

响应

200

application/json

请求成功

响应对象。

amount · string

示例:

"1.2"

currency · enum<string>

可用选项: USDT

示例:

"USDT"

from_account · enum<string>

可用选项: spot, sub_spot

示例:

"spot"

status · enum<string>

可用选项: SUCCESS

示例:

"SUCCESS"

to_account · enum<string>

可用选项: spot, sub_spot

示例:

"sub_spot"

transfer_id · string

示例:

"123"