Place BBO Order

Place BBO Order.

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
}

Place BBO Order through the DexBuilder PerpDEX REST API.

Authorizations

KEY · string · header · required

DexBuilder API Key

Timestamp · string · header · required

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

SIGN · string · header · required

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

Path Parameters

settle · enum<string> · required

結算幣種

Available options: usdt

Body

application/json

contract · string · required

永續合約

size · integer<int64> · required

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

direction · enum<string> · required

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

Available options: sell, buy

level · integer<int64> · required

盤口檔位，最大 20

Required range: 1 <= x <= 20

iceberg · integer<int64>

冰山單顯示數量

close · boolean

是否平倉

reduce_only · boolean

是否只減倉

tif · enum<string>

訂單有效方式

Available options: gtc, ioc, poc, fok

text · string

自定義訂單資訊

auto_size · enum<string>

雙向持倉平倉方向

Available options: close_long, close_short

stp_act · enum<string>

自成交防護策略

Available options: co, cn, cb, -

default_leverage · string

預設槓桿

limit_vip · integer<int64>

對手方 VIP 等級限制

pid · integer<int64>

Position ID

Response

200 - application/json

建立成功

contract · string · required

永續合約

size · integer<int64> · required

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

direction · enum<string> · required

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

Available options: sell, buy

level · integer<int64> · required

盤口檔位，最大 20

Required range: 1 <= x <= 20

iceberg · integer<int64>

冰山單顯示數量

close · boolean

是否平倉

reduce_only · boolean

是否只減倉

tif · enum<string>

訂單有效方式

Available options: gtc, ioc, poc, fok

text · string

自定義訂單資訊

auto_size · enum<string>

雙向持倉平倉方向

Available options: close_long, close_short

stp_act · enum<string>

自成交防護策略

Available options: co, cn, cb, -

default_leverage · string

預設槓桿

limit_vip · integer<int64>

對手方 VIP 等級限制

pid · integer<int64>

Position ID