List Orders by Time Range

List Orders by Time Range.

GET /dex_futures/{settle}/orders_timerange

按時間範圍查詢訂單清單

cURL

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

List Orders by Time Range 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

Query Parameters

contract · string

永續合約，不傳則回傳全部

from · integer<int64>

開始時間，Unix 秒

to · integer<int64>

結束時間，Unix 秒

limit · integer

單次回傳的最大記錄數量

offset · integer

清單偏移量，從 0 開始

Response

200 - application/json

查詢成功

contract · string · required

永續合約

Example:

"BTC_USDT"

size · string · required

合約張數；正數買入、負數賣出，平倉可為 0

price · string · required

委託價格；price=0 且 tif=ioc 時為市價單

iceberg · string

冰山單顯示數量，0 表示非冰山單

close · boolean

是否平倉；為 true 時 size 需為 0

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

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>

訂單狀態

Available options: 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

改單自定義資訊