跳到主要內容

設定部位止盈

資訊
  • 此介面需要簽名，具體簽名規則請參閱認證
  • 此介面會觸發限頻，具體規則請參閱限頻

HTTP 請求​

POST /futures/set-position-take-profit

請求參數​

參數名是否必須類型說明
markettruestring市場名稱
market_typetruestring市場類型。
注意：在現貨相關功能中，僅可使用SPOT 或MARGIN
在合約相關功能中，只可使用FUTURES
take_profit_typetruestring止盈觸發價格類型。CoinEx支援在設定「止盈停損」時選擇不同的觸發價格類型，使用者可自由選擇「最新成交價」或「標記價格」作為觸發價格。
take_profit_pricetruestring止盈價格

請求回應​

參數名類型說明
position_idint倉位ID
marketstring市場名稱
market_typestring市場類型
sidestring倉位方向
margin_modestring倉位類型
open_intereststring持倉數量
close_avblstring可平倉數量。剩餘可平倉的部位數量
ath_position_amountstring史上最大倉位數量
unrealized_pnlstring未實現收益。未平倉合約的當前盈虧，透過標記價格或最新成交價估算得出
realized_pnlstring已實現盈虧
avg_entry_pricestring平均開倉價格
cml_position_valuestring累計倉位價值
max_position_valuestring最大倉位價值
take_profit_pricestring止盈價格
stop_loss_pricestring停損價格
take_profit_typestring止盈觸發價格類型。CoinEx支援在設定「止盈停損」時選擇不同的觸發價格類型，使用者可自由選擇「最新成交價」或「標記價格」作為觸發價格。
stop_loss_typestring止損觸發價格類型。CoinEx支援在設定「止盈停損」時選擇不同的觸發價格類型，使用者可自由選擇「最新成交價」或「標記價格」作為觸發價格。
leverageint槓桿倍數
margin_avblstring可用保證金。當前保證金數量=起始保證金+追加保證金-減少保證金
ath_margin_sizestring史上最大保證金數量
position_margin_ratestring倉位保證金率
maintenance_margin_ratestring維持保證金率。CoinEx採用階梯梯維持保證金制度。
倉位數量越多，維持保證金率越高，使用者可選擇的槓桿倍數越低；
倉位數量越少，維持保證金率越低，使用者可選擇的槓桿倍數越高
maintenance_margin_valuestring維持保證金數量。維持保證金：維持目前倉位所需的最低保證金水準。
（正向合約）維持保證金 = 開倉標記價格 * 部位數量 * 維持保證金率
（反向合約）維持保證金 =（合約面額 * 合約張數 / 開倉標記價格）* 維持保證金率
liq_pricestring強平價。
（多倉）強平價=結算價格*（1-強平保證金率）/（1-維持保證金率）
（空倉）強平價=結算價格*（1+強平保證金率）/（ 1+維持保證金率）
bkr_pricestring破產價格。
（多倉）破產價=結算價格*（1-強平保證金率）
（空倉）破產價=結算價格*（1+強平保證金率）
adl_levelint自動減倉風險等級，為[1, 5]範圍內的數字，數字越小等級越低，反之越高
settle_pricestring結算價格，以標記價格計算
settle_valuestring結算價值，以標記價格計算
created_atint訂單創建時間
updated_atint訂單更新時間

請求範例​

{
    "market": "CETUSDT",
    "market_type": "FUTURES",
    "take_profit_type": "mark_price",
    "take_profit_price": "0.059"
}

回應範例​

{
    "code": 0,
    "data": {
        "position_id": 927266133,
        "market": " CETUSDT",
        "market_type": "FUTURES",
        "side": "long",
        "margin_mode": "cross",
        "open_interest": "1000000",
        "close_avbl": "1000000",
        "ath_position_amount": "1000000",
        "unrealized_pnl": "8391.123989502",
        "realized_pnl": "110396.83471965",
        "avg_entry_price": "0.0631",
        "cml_position_value": "1118787.958709152",
        "max_position_value": "1302421.11392201",
        "take_profit_price": "0.072",
        "stop_loss_price": "",
        "take_profit_type": "mark_price",
        "stop_loss_type": "",
        "leverage": "10",
        "margin_avbl": "210396.83471965",
        "ath_margin_size": "210396.83471965",
        "position_margin_rate": "0.050",
        "maintenance_margin_rate": "0.005",
        "maintenance_margin_value": "5000",
        "liq_price": "0.05679",
        "bkr_price": "0.053635",
        "adl_level": 5,
        "base_fee": "",
        "quote_fee": "11.6582326221",
        "discount_fee": "0",
        "maker_fee_rate": "0",
        "taker_fee_rate": "0.0003",
        "settle_price": "0.06817",
        "settle_value": "1291322.83913829",
        "created_at": 1691482451000,
        "updated_at": 1691482451000
    },
    "message": "OK"
}