전략 주문 등록

URL: /v1/futures/order/place_strategy

인증 필요

예

요청 메서드: POST

예시

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가 비어있을 때), 두 개의 주문 ID가 쉼표로 구분되어 반환되며, 첫 번째는 이익실현 주문 ID, 두 번째는 손실제한 주문 ID입니다

응답 예시

JSON

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