批量创建永续合约订单

批量创建永续合约订单

POST /dex_futures/{settle}/batch_orders

批量创建永续合约订单

cURL

curl --request POST \
  --url https://api.dexbuilder.com/api/v1/dex_futures/{settle}/batch_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>"
  }
]
'

200

[
  {
    "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>"
  }
]

批量创建永续合约订单。

授权

KEY · string · header · 必填

DexBuilder API Key

Timestamp · string · header · 必填

Unix 时间戳（秒），与当前时间差不得超过 60 秒

SIGN · string · header · 必填

使用 API Secret 对签名字符串执行 HMAC-SHA512 后的十六进制签名

路径参数

settle · enum<string> · 必填

结算币种

可用选项: usdt

请求体

application/json

Maximum array length: 10

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

市价单自定义最大滑点比例

响应

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

改单自定义信息