查询单个订单详情

根据订单 ID 查询订单详情

GET /dex_futures/{settle}/orders/{order_id}

查询单个订单详情

cURL

curl --request GET \
  --url https://api.dexbuilder.com/api/v1/dex_futures/{settle}/orders/{order_id} \
  --header 'KEY: <api-key>' \
  --header 'SIGN: <api-key>' \
  --header 'Timestamp: <api-key>'

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>"
}

根据订单 ID 或自定义订单 ID 查询订单详情。

授权

KEY · string · header · 必填

DexBuilder API Key

Timestamp · string · header · 必填

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

SIGN · string · header · 必填

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

路径参数

settle · enum<string> · 必填

结算币种

可用选项: usdt

order_id · string · 必填

订单 ID 或自定义订单 ID

响应

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

改单自定义信息