利益確定・損切り注文の作成

エンドポイント: /v1/futures/order/place_strategy

リクエスト認証

必要

リクエストメソッド: POST (form-urlencoded)

例

Bash

curl -X POST "https://oapi.websea.com/v1/futures/order/place_strategy" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "Token: YOUR_TOKEN" \
  -H "Nonce: 1700000000_abcd1" \
  -H "Signature: GENERATED_SIGNATURE" \
  --data-urlencode "strategy_type=1" \
  --data-urlencode "symbol=ETH-USDT" \
  --data-urlencode "margin_mode=1" \
  --data-urlencode "side=1" \
  --data-urlencode "price=1865.5" \
  --data-urlencode "quantity=100" \
  --data-urlencode "trigger_price=1850" \
  --data-urlencode "stop_loss_price=1830" \
  --data-urlencode "take_profit_price=1900"

リクエストパラメータ

パラメータ名	必須	型	例	説明
strategy_type	はい	num	1	利益確定・損切りタイプ： 1：通常の利益確定・損切り（成行・指値を含む） 2：ポジション利益確定・損切り（数量指定不可） 3：トレール注文（移動止盈止损）
symbol	はい	string	ETH-USDT	取引ペア名
margin_mode	はい	string	1	マージンモード： 1：分離マージン（逐倉） 2：全資産マージン（全倉）
side	はい	number	1	売買方向： 1：ロング（多） 2：ショート（空）
price	いいえ	number	1	注文価格。指定しない場合は成行注文。strategy_type=1 で指値注文を行う場合に指定。
quantity	いいえ	number	100	数量（枚数、>0）。strategy_type=1/3 の場合は必須。strategy_type=2 の場合は指定不可（全ポジションが対象）。
trigger_price	いいえ	string	5	トリガー価格。strategy_type=1 で価格（指値）を指定した場合に必須。strategy_type=3 ではアクティベーション価格として推奨。
stop_loss_price	いいえ	string	3	損切り価格（>0 かつ取引ペアの価格精度内）。
take_profit_price	いいえ	string	7	利益確定価格（>0 かつ取引ペアの価格精度内）。
callback_rate	いいえ	num	0.2	コールバック率（例：20%=0.2）。strategy_type=3 の場合に必須。有効範囲：[0.0001-0.1]

レスポンスパラメータ

パラメータ名	必須	型	例	説明
errno	はい	int	0	ステータスコード
errmsg	はい	string	ok	ステータスメッセージ
result	はい	obj	例を参照	レスポンス結果

resultパラメータの説明

パラメータ名	必須	型	例	説明
order_id	はい	string	BL786401542840282676	注文ID；strategy_type=1で成行注文の場合（priceが空の時）、2つの注文IDがカンマで区切られて返され、1つ目は利益確定注文ID、2つ目は損切り注文IDとなります

レスポンス例

JSON

{
  "errno": 0,
  "errmsg": "ok",
  "result": {
    "order_id": "BL786401542840282676"
  }
}