提交订单

提交订单

POST /api/v4/broker/event_contracts/orders

提交订单

cURL

curl --request POST \
  --url https://api.dexbuilder.com/api/v4/broker/event_contracts/orders \
  --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 '
{
  "token_id": "<string>",
  "price": "<string>",
  "size": "<string>",
  "total_cost": "<string>",
  "client_order_id": "<string>",
  "post_only": true,
  "sell_all": true,
  "expire_time": 123
}
'

200

{
  "client_order_id": "<string>",
  "created_at": 123,
  "order_id": "<string>",
  "status": "processing"
}

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

提交订单。

授权

KEY · string · header · 必填

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

请求头

Timestamp · string · 必填

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

SIGN · string · 必填

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

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

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

请求体

application/json

token_id · string · 必填

side · enum<string> · 必填

可用选项: BUY, SELL

price · string

size · string

total_cost · string

order_type · enum<string>

订单有效方式：GTC、GTD、FOK 或 FAK

可用选项: GTC, GTD, FOK, FAK

order_mode · enum<string>

下单模式：LIMIT 或 MARKET

可用选项: LIMIT, MARKET

client_order_id · string

post_only · boolean

sell_all · boolean

expire_time · integer

响应

200

application/json

请求成功

响应对象。

client_order_id · string

created_at · integer

order_id · string

status · enum<string>

可用选项: processing