Order List

최근 3 개월 동안 주문 목록을 검색합니다. 이 요청은 페이징을 지원하며 주문 시간에 따라 최신부터 가장 빠른 순서대로 저장됩니다.

  • 요청제한: 2초동안 20번의 요청까지 가능

  • HTTP 엔드포인트

    GET /api/spot/v3/orders

  • 인증된 요청 예시

    GET /api/spot/v3/orders?instrument_id=BTC-USDT&state=2&limit=2&&after=2500723297223680

  • 요청값

    Parameters Parameters Types Required Description
    instrument_id string Yes list the orders of specific trading pair
    state string Yes 주문 상태: -2 = Failed, -1 = Canceled, 0 = Open, 1 = Partially Filled, 2 = Fully Filled, 3 = Submitting, 4 = Canceling, 6 = Incomplete (open + partially filled), 7 = Complete (canceled + completely filled)
    after string No 요청 된 order_id, ledger_id 또는 trade_id 이전의 레코드를 리턴하기위한 데이터의 페이지 매김.
    before string No 요청 된 order_id, ledger_id 또는 trade_id보다 새로운 레코드를 반환하기위한 데이터의 페이지 매김.
    limit string No 요청 당 결과 수 최대 값은 100입니다. 기본값은 100입니다
  • 응답값

    Parameters Parameters Types Description
    order_id string 주문 ID
    client_oid string 사용자가 커스터마이징한 주문 ID
    price string 가격
    size string 개수
    notional string 총 매수 개수. 마켓 주문을 위해서 반환 됩니다.
    instrument_id string 트레이딩 페어
    type string limit, market (기본은 limit)
    side string 매수, 매도
    timestamp string 기록된 날짜 시간
    filled_size string 입력된 개수
    filled_notional string 입력된 총액
    state string 주문 상태: -2 = Failed, -1 = Canceled, 0 = Open, 1 = Partially Filled, 2 = Fully Filled, 3 = Submitting, 4 = Canceling
    order_type string 0: 일반 주문 한도 1: 포스트 2: FOK 3: IOC
    price_avg string 평균 가격
  • 응답 JSON Body 예시

    [
        [
            {
                "client_oid": "oktspot76",
                "created_at": "2019-03-18T07:26:49.000Z",
                "filled_notional": "3.9734",
                "filled_size": "0.001",
                "funds": "",
                "instrument_id": "BTC-USDT",
                "notional": "",
                "order_id": "2500723297813504",
                "order_type": "0",
                "price": "4013",
                "product_id": "BTC-USDT",
                "side": "buy",
                "size": "0.001",
                "status": "filled",
                "state": "2",
                "timestamp": "2019-03-18T07:26:49.000Z",
                "type": "limit"
            },
            {
                "client_oid": "oktspot75",
                "created_at": "2019-03-18T07:26:49.000Z",
                "filled_notional": "3.9734",
                "filled_size": "0.001",
                "funds": "",
                "instrument_id": "BTC-USDT",
                "notional": "",
                "order_id": "2500723297223680",
                "order_type": "0",
                "price": "4013",
                "product_id": "BTC-USDT",
                "side": "buy",
                "size": "0.001",
                "status": "filled",
                "state": "2",
                "timestamp": "2019-03-18T07:26:49.000Z",
                "type": "limit"
            },
            {
                "client_oid": "oktspot74",
                "created_at": "2019-03-18T07:08:24.000Z",
                "filled_notional": "3.9768",
                "filled_size": "0.001",
                "funds": "",
                "instrument_id": "BTC-USDT",
                "notional": "",
                "order_id": "2500650881647616",
                "order_type": "0",
                "price": "4016.8",
                "product_id": "BTC-USDT",
                "side": "buy",
                "size": "0.001",
                "status": "filled",
                "state": "2",
                "timestamp": "2019-03-18T07:08:24.000Z",
                "type": "limit"
            }
        ],
        {
            "before": "2500723297813504",
            "after": "2500650881647616"
        }
    ]