按档位创建 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