按檔位建立 BBO 訂單

按指定盤口檔位建立 BBO 永續合約訂單

POST /dex_futures/{settle}/bbo_orders

按檔位建立 BBO 訂單

cURL

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

200

{
  "contract": "<string>",
  "size": 123,
  "direction": "sell",
  "level": 10,
  "iceberg": 123,
  "close": true,
  "reduce_only": true,
  "tif": "gtc",
  "text": "<string>",
  "auto_size": "close_long",
  "stp_act": "co",
  "default_leverage": "<string>",
  "limit_vip": 123,
  "pid": 123
}

按指定盤口檔位建立 BBO 永續合約訂單。

授權

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 · 必填

永續合約

size · integer<int64> · 必填

交易數量；正數買入、負數賣出

direction · enum<string> · 必填

sell 取得買盤檔位，buy 取得賣盤檔位

可用選項: sell, buy

level · integer<int64> · 必填

盤口檔位，最大 20

必填範圍: 1 <= x <= 20

iceberg · integer<int64>

冰山單顯示數量

close · boolean

是否平倉

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, -

default_leverage · string

預設槓桿

limit_vip · integer<int64>

對手方 VIP 等級限制

pid · integer<int64>

Position ID

回應

200 - application/json

建立成功

contract · string · 必填

永續合約

size · integer<int64> · 必填

交易數量；正數買入、負數賣出

direction · enum<string> · 必填

sell 取得買盤檔位，buy 取得賣盤檔位

可用選項: sell, buy

level · integer<int64> · 必填

盤口檔位，最大 20

必填範圍: 1 <= x <= 20

iceberg · integer<int64>

冰山單顯示數量

close · boolean

是否平倉

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, -

default_leverage · string

預設槓桿

limit_vip · integer<int64>

對手方 VIP 等級限制

pid · integer<int64>

Position ID