미체결 주문 조회

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

요청 메서드

GET

예시

Bash

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

쿼리 매개변수

매개변수	필수 여부	타입	예시	설명
symbol	아니요	string	BTC-USDT	거래쌍. 특정 거래쌍을 조회할 때 필수이며, 생략 시 모든 거래쌍을 조회합니다.
from	아니요	int	122	페이지네이션을 위한 시작 order_sn
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

응답 매개변수

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

결과 필드

매개변수	필수 여부	타입	예시	설명
order_id	예	integer	121	주문 ID
order_sn	예	string	BL123456789987523	주문 일련번호
symbol	예	string	MCO-BTC	거래쌍
ctime	예	string	2018-10-02 10:33:33	주문 생성 시간
type	예	int	1	주문 유형: 1 = 시장가, 2 = 지정가
side	예	string	buy	주문 방향: buy / sell
price	예	string	0.123456	주문 가격. 시장가 주문(type=1)의 경우 이 값은 0입니다.
number	예	string	1.0000	주문 수량. 시장가 매수 주문(type=1, side=buy)의 경우 이 값은 0입니다.
total_price	예	string	0.123456	주문 금액. 시장가 매도 주문(type=1, side=sell)의 경우 이 값은 0입니다.
deal_number	예	string	0.00000	체결 수량
deal_price	예	string	0.00000	평균 체결 가격
status	예	int	1	주문 상태: 1 = 미체결, 2 = 부분 체결, 4 = 취소 중

응답 예시

JSON

{
    "errno": 0,
    "errmsg": "success",
    "result": [
        {
            "order_id": 121,
            "order_sn": "BL123456789987523",
            "symbol": "MCO-BTC",
            "ctime": "2018-10-02 10:33:33",
            "type": "2",
            "side": "buy",
            "price": "0.123456",
            "number": "1.0000",
            "total_price": "0.123456",
            "deal_number": "0.00000",
            "deal_price": "0.00000",
            "status": 1
        },
        {
            "order_id": 122,
            "order_sn": "SL123456789987523",
            "symbol": "MCO-BTC",
            "ctime": "2018-10-02 10:33:33",
            "type": "2",
            "side": "sell",
            "price": "0.123456",
            "number": "1.0000",
            "total_price": "0.123456",
            "deal_number": "0.00000",
            "deal_price": "0.00000",
            "status": 1
        },
        {
            "order_id": 123,
            "order_sn": "BM123456789987523",
            "symbol": "MCO-BTC",
            "ctime": "2018-10-02 10:33:33",
            "type": "1",
            "side": "buy",
            "price": "0",
            "number": "0",
            "total_price": "1",
            "deal_number": "0.00000",
            "deal_price": "0.00000",
            "status": 1
        },
        {
            "order_id": 124,
            "order_sn": "SM123456789987523",
            "symbol": "MCO-BTC",
            "ctime": "2018-10-02 10:33:33",
            "type": "1",
            "side": "sell",
            "price": "0",
            "number": "1.0000",
            "total_price": "0",
            "deal_number": "0.00000",
            "deal_price": "0.00000",
            "status": 1
        }
    ]
}