선물 포지션 오픈 / 종료

엔드포인트: /v1/futures/order/create

요청 매개변수

필수

메서드: POST

예시

Bash

curl -X POST "https://oapi.websea.com/v1/futures/order/create" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "Token: YOUR_TOKEN" \
  -H "Nonce: 1700000000_abcd1" \
  -H "Signature: GENERATED_SIGNATURE" \
  -d "contract_type=open" \
  -d "type=buy-limit" \
  -d "symbol=BTC-USDT" \
  -d "amount=100" \
  -d "price=1"

요청 매개변수

매개변수	필수 여부	타입	예시	설명
contract_type	예	string	open	작업 유형: 포지션 오픈은 open, 포지션 종료는 close
type	예	string	buy-limit	주문 유형: buy-limit, sell-limit, buy-market, sell-market, buy-tactics, sell-tactics, buy-market-tactic, sell-market-tactics
lever_rate	예	int	10	레버리지 배수 (포지션 오픈 및 전략 주문 시 필수; 포지션 종료 시에는 필요하지 않음)
price	아니요	number	1	주문 가격 (모든 지정가 주문 시 필수)
amount	예	number	100	계약 수량
symbol	예	string	ETH-USDT	선물 거래쌍
trigger_price	아니요	string	5	트리거 가격 (조건부 및 전략 주문, 지정가 이익실현/손실제한 주문 시 필수)
stop_loss_price	아니요	string	3	손실제한 가격 (trigger_price와 상호 배타적)
stop_profit_price	아니요	string	7	이익실현 가격 (trigger_price와 상호 배타적)
is_full	아니요	int	1	증거금 모드: 1 격리 증거금, 2 교차 증거금. 기본값: 1

응답 매개변수

매개변수	필수 여부	타입	예시	설명
errno	예	int	0	상태 코드
errmsg	예	string	success	상태 메시지
result	예	object	예시 참조	결과 데이터

결과 필드

매개변수	필수 여부	타입	예시	설명
order_id	예	string	BL786401542840282676	주문 ID

응답 예시

JSON

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