修改單個訂單 - DexBuilder Docs

curl --request PUT \ --url https://api.dexbuilder.com/api/v1/dex_futures/{settle}/orders/{order_id} \ --header 'Content-Type: application/json' \ --header 'KEY: <api-key>' \ --header 'SIGN: <api-key>' \ --header 'Timestamp: <api-key>' \ --data ' { "size": "<string>", "price": "<string>", "amend_text": "<string>", "text": "<string>" } '

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

order_id

string

必填

訂單 ID 或自定義訂單 ID

主體

application/json

size

string

新的訂單數量，包含已成交部分

price

string

新的訂單價格

amend_text

string

改單自定義資訊

text

string

訂單自定義資訊

回應

200 - application/json

修改成功

contract

string

必填

永續合約

範例:

"BTC_USDT"

size

string

必填

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

price

string

必填

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

iceberg

string

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

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

市價單自定義最大滑點比例

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

改單自定義資訊