提交訂單

提交訂單

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"
}

提交訂單。

該介面為私有介面，需要按照事件合約認證要求完成認證後呼叫。

授權

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