API V2 버전, Websocket 오더 업그레이드 푸쉬 API “orders#${symbol}” 지원

안녕하세요.

글로벌 디지털 자산 거래소 ‘후오비 코리아’입니다.

후오비 코리아는 2020년4월3일부터, API V2버전 Websocket에서 오더 업그레이드 푸쉬 기능 “orders#${symbol}”를 지원합니다.

새로 지원되는 기능은 온라인 배포 한 달 후, 즉 2020년 5월4일부터 V1 버전 Websocket 오더에서 지원을 중단할 예정입니다.
1） 오더 업그레이드 푸쉬 “orders.$symbol”；
2） 오더 업그레이드 푸쉬（NEW）“orders.$symbol.update”；
3） 현재 오더 및 과거 오더 기록 조회 “order.list”；
4） 오더 번호로 오더 기록 조회 “orders.detail”。

적용 일자: 2020년 4월 3일

구체적인 변경 내용과 파라미터는 API 문서를 참고하세요.

후오비 코리아 드림
2020년 4월 4일

## 오더 업그레이드 구독
API Key권한: 읽기
오더 업그레이드 푸쉬는 아래 한가지 이벤트만 충족하면 업그레이드됩니다:
- 오더 생성（eventType=creation）;
- 오더 체결（eventType=trade）;
- 오더 철회（eventType=cancellation）.
서로 다른 유형에 따라 푸쉬한 소식 중, 필드 리스트는 약간 다릅니다.

### 구독 주제
` orders#${symbol}`

### 구독 파라미터

> Subscribe request
```json
{
"action": "sub",
"ch": " orders#btcusdt"
}

```

> Response

```json
{
"action": "sub",
"code": 200,
"ch": " orders#btcusdt",
"data": {}
}
```

### 데이터 업그레이드 필드 리스트

오더 생성 후 –

주의: 스탑리밋 오더가 아직 발동되지 않은 경우 API는 해당 오더의 생성을 푸쉬하지 않습니다. 스탑리밋 오더가 발동되었지만 미체결된 경우 API는 “creation”이벤트를 푸쉬합니다. 그리고 푸쉬 데이터중의 오더 유형은 기존의 오더 유형 “buy-stop-limit” 혹은 “sell-stop-limit”가 아닌 “buy-limit”혹은 “sell-limit”로 변경됩니다.

```json
{
"action":"push",
"ch":"orders#btcusdt",
"data":
{
"orderSize":"2.000000000000000000",
"orderCreateTime":1583853365586,
"orderPrice":"77.000000000000000000",
"type":"sell-limit",
"orderId":27163533,
"clientOrderId":"a001",
"orderStatus":"submitted",
"symbol":"btcusdt",
"eventType":"creation"
}
}
```

오더 체결후–

주의: taker 오더 한 개가 동시에 상대방 오더와 체결된 후 생성된 오더는 각각 푸쉬됩니다. (1건으로 통일되서 푸쉬되지 않음)

```json
{
"action":"push",
"ch":"orders#btcusdt",
"data":
{
"tradePrice":"76.000000000000000000",
"tradeVolume":"1.013157894736842100",
"tradeId":301,
"tradeTime":1583854188883,
"aggressor":true,
"execAmt":"1.013157894736842100",
"remainAmt":"0.000000000000000400000000000000000000",
"orderId":27163536,
"clientOrderId":"",
"orderStatus":"filled",
"symbol":"btcusdt",
"eventType":"trade"
}
}
```

오더 철회 후–

```json
{
"action":"push",
"ch":"orders#btcusdt",
"data":
{
"lastActTime":1583853475406,
"remainAmt":"2.000000000000000000",
"orderId":27163533,
"clientOrderId":"a001",
"orderStatus":"canceled",
"symbol":"btcusdt",
"eventType":"cancellation"
}
}
```

상기 API 가 지원되고 1개월 후, 즉2020년5월4일부터 후오비 코리아는 V1버전 Websocket API는 해제됩니다.
1） 오더 업그레이드 푸쉬 “orders.$symbol”；
2） 오더 업그레이드 푸쉬（NEW）“orders.$symbol.update”；
3） 현재 오더 및 오더 기록 조회 “order.list”；
4） 오더 번호로 오더 조회 “orders.detail”。
새로 오픈한 “orders#${symbol}”를 구독하여 오더 업그레이드 푸쉬를 받고 기존 RESTful 오더 조회 API를 통하여 오더 리스트 및 오더 내역을 획득할 수 있습니다.

이 섹션의 문서

댓글