콘텐츠로 이동

미체결 주문 조회

엔드포인트: /v1/futures/orders/open

요청 매개변수

필수

메서드: GET

예시

Bash
curl -X GET "https://oapi.websea.com/v1/futures/orders/open?symbol=ETH-USDT&limit=20" \
  -H "Token: YOUR_TOKEN" \
  -H "Nonce: 1700000000_abcd1" \
  -H "Signature: GENERATED_SIGNATURE"

쿼리 매개변수

매개변수 필수 여부 타입 예시 설명
symbol 아니요 string ETH-USDT 거래쌍. 특정 심볼을 조회할 때 필수이며, 생략 시 모든 심볼을 조회합니다.
from 아니요 int 122 페이지네이션을 위한 시작 order_id
direct 아니요 string prev 조회 방향. 기본값: prev (시간/ID 역순); next (시간/ID 정순). 예시 시퀀스: 1,2,3,4,5. from=4일 때, prev는 3,2,1을 반환하고 next는 5를 반환합니다.
limit 아니요 int 20 반환할 레코드 수. 기본값: 20, 최대값: 100
is_full 아니요 int 1 증거금 모드: 1 격리 증거금, 2 교차 증거금

응답 매개변수

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

결과 필드

매개변수 필수 여부 타입 예시 설명
order_id string BG5000181583375122413SZXEIX 주문 ID
ctime int 1576746253 주문 생성 시간 (Unix 타임스탬프)
symbol string ETH-USDT 거래쌍
price string 1 주문 가격
price_avg string 0 평균 체결 가격
lever_rate int 10 레버리지 배수
amount string 10 주문 수량
deal_amount string 0 체결 수량
type string buy-limit 주문 유형
status int 1 주문 상태 (1=대기 중, 2=부분 체결, 3=체결 완료, 4=취소 중, 5=부분 취소됨, 6=취소됨)
contract_type string open 포지션 작업: 포지션 오픈은 open, 포지션 종료는 close
trigger_price string 1 트리거 가격
stop_profit_price string 15 이익실현 가격
stop_loss_price string 10 손실제한 가격

응답 예시

JSON
{
    "errno": 0,
    "errmsg": "success",
    "result": [
        {
            "order_id": "BG5000181583375122413SZXEIX",
            "ctime": 1576746253,
            "symbol": "ETH-USDT",
            "price": "1",
            "price_avg": "0",
            "lever_rate": 10,
            "amount": "10",
            "deal_amount": "0",
            "type": "buy-limit",
            "status": 1,
            "contract_type": "open",
            "trigger_price": "1",
            "stop_profit_price": "15",
            "stop_loss_price": "10"
        }
    ]
}