建立永續合約訂單

建立一筆永續合約訂單

POST /dex_futures/{settle}/orders

建立永續合約訂單

cURL

curl --request POST \
  --url https://api.dexbuilder.com/api/v1/dex_futures/{settle}/orders \
  --header 'Content-Type: application/json' \
  --header 'KEY: <api-key>' \
  --header 'SIGN: <api-key>' \
  --header 'Timestamp: <api-key>' \
  --data '
{
  "contract": "BTC_USDT",
  "size": "<string>",
  "price": "<string>",
  "iceberg": "<string>",
  "close": true,
  "reduce_only": true,
  "text": "<string>",
  "bbo": "<string>",
  "default_leverage": "<string>",
  "pid": 123,
  "order_value": "<string>",
  "trade_value": "<string>",
  "market_order_slip_ratio": "<string>"
}
'

201

{
  "contract": "BTC_USDT",
  "size": "<string>",
  "price": "<string>",
  "iceberg": "<string>",
  "close": true,
  "reduce_only": true,
  "tif": "gtc",
  "text": "<string>",
  "auto_size": "close_long",
  "stp_act": "co",
  "bbo": "<string>",
  "default_leverage": "<string>",
  "pid": 123,
  "order_value": "<string>",
  "trade_value": "<string>",
  "market_order_slip_ratio": "<string>",
  "id": 123,
  "user": 123,
  "create_time": 123,
  "update_time": 123,
  "finish_time": 123,
  "finish_as": "<string>",
  "status": "open",
  "left": "<string>",
  "fill_price": "<string>",
  "is_close": true,
  "is_reduce_only": true,
  "is_liq": true,
  "tkfr": "<string>",
  "mkfr": "<string>",
  "stp_id": 123,
  "amend_text": "<string>"
}

該介面用於建立一筆永續合約訂單。

該介面需要 API Key、時間戳和請求籤名認證。

size 表示合約張數，不是幣的數量。每張合約對應的標的資產數量可透過合約資訊中的 quanto_multiplier 取得。

當 price 為 0 且 tif 為 ioc 時，可用於提交市價單。

授權

KEY · string · header · 必填

DexBuilder API Key

Timestamp · string · header · 必填

Unix 時間戳（秒），與目前時間差不得超過 60 秒

SIGN · string · header · 必填

使用 API Secret 對簽名字串執行 HMAC-SHA512 後的十六進制簽名

路徑參數

settle · enum<string> · 必填

結算幣種

可用選項: usdt

主體

application/json

contract · string · 必填

永續合約

範例:

"BTC_USDT"

size · string · 必填

合約張數；正數買入、負數賣出，平倉可為 0

price · string · 必填

委託價格；price=0 且 tif=ioc 時為市價單

iceberg · string

冰山單顯示數量，0 表示非冰山單

close · boolean

是否平倉；為 true 時 size 需為 0

reduce_only · boolean

是否只減倉

tif · enum<string>

訂單有效方式

可用選項: gtc, ioc, poc, fok

text · string

自定義訂單資訊

auto_size · enum<string>

雙向持倉平倉方向

可用選項: close_long, close_short

stp_act · enum<string>

自成交防護策略

可用選項: co, cn, cb, -

bbo · string

對手價相關參數

default_leverage · string

預設槓桿

pid · integer<int64>

Position ID

order_value · string

訂單價值

trade_value · string

成交價值

market_order_slip_ratio · string

市價單自定義最大滑點比例

回應

201 - application/json

建立成功

contract · string · 必填

永續合約

範例:

"BTC_USDT"

size · string · 必填

合約張數；正數買入、負數賣出，平倉可為 0

price · string · 必填

委託價格；price=0 且 tif=ioc 時為市價單

iceberg · string

冰山單顯示數量，0 表示非冰山單

close · boolean

是否平倉；為 true 時 size 需為 0

reduce_only · boolean

是否只減倉

tif · enum<string>

訂單有效方式

可用選項: gtc, ioc, poc, fok

text · string

自定義訂單資訊

auto_size · enum<string>

雙向持倉平倉方向

可用選項: close_long, close_short

stp_act · enum<string>

自成交防護策略

可用選項: co, cn, cb, -

bbo · string

對手價相關參數

default_leverage · string

預設槓桿

pid · integer<int64>

Position ID

order_value · string

訂單價值

trade_value · string

成交價值

market_order_slip_ratio · string

市價單自定義最大滑點比例

id · integer<int64>

訂單 ID

user · integer<int64>

使用者 ID

create_time · number<double>

建立時間

update_time · number<double>

更新時間

finish_time · number<double>

完成時間

finish_as · string

訂單完成原因

status · enum<string>

訂單狀態

可用選項: open, finished

left · string

未成交數量

fill_price · string

平均成交價

is_close · boolean

是否平倉單

is_reduce_only · boolean

是否只減倉

is_liq · boolean

是否強平單

tkfr · string

Taker 費率

mkfr · string

Maker 費率

stp_id · integer<int64>

STP 組欄位

amend_text · string

改單自定義資訊