查詢永續合約訂單清單

按狀態查詢永續合約訂單清單

GET /dex_futures/{settle}/orders

查詢永續合約訂單清單

cURL

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

按狀態查詢永續合約訂單清單。

授權

KEY · string · header · 必填

DexBuilder API Key

Timestamp · string · header · 必填

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

SIGN · string · header · 必填

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

路徑參數

settle · enum<string> · 必填

結算幣種

可用選項: usdt

查詢參數

status · enum<string> · 必填

訂單狀態

可用選項: open, finished

contract · string

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

limit · integer

單次回傳的最大記錄數量

offset · integer

清單偏移量，從 0 開始

last_id · string

上一頁最後一條記錄 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

改單自定義資訊