Request
요청은 JSON Object를 이용하며 응답 또한 JSON Object 입니다. 요청은 크게 ticket field, method field, format field 로 나누어집니다.
Request format
[{Ticket Field},{Method Field},{Format Field}]
Ticket Field
필드명 | 타입 | 내용 | 필수 여부 | 기본 값 |
|---|---|---|---|---|
| ticket | String | 요청자를 식별할 수 있는 값 | O |
Method Field
필드명 | 타입 | 내용 | 필수 여부 | 기본 값 |
|---|---|---|---|---|
| method | String | 요청 메서드 - LIST_SUBSCRIPTIONS: 구독중인 타입 조회 | O |
Format Field
Simple로 지정될 경우 응답의 필드명이 모두 간소화됩니다.
필드명 | 타입 | 내용 | 필수 여부 | 기본 값 |
|---|---|---|---|---|
| format | String | 수신할 포맷 - DEFAULT: 기본형- SIMPLE: 축약형 | X | DEFAULT |
주의 사항 - Format Field
실시간 데이터를 수신할 때와 동일한 Format Field 로 요청하시길 권장드립니다.
Format Field 는 현재 연결에 대한 전체 포맷을 지정합니다. 따라서
SIMPLE포맷으로 웹소켓 데이터를 수신하다가LIST_SUBSCRIPTIONS요청을DEFAULT포맷으로 요청할 경우, 이전에 요청한 데이터가DEFAULT포맷으로 변경되어 내려가게 됩니다.
Response
| 필드명 | 축약형 (format: SIMPLE) | 내용 | 타입 | 값 |
|---|---|---|---|---|
| method | mthd | 요청 메서드 | String | LIST_SUBSCRIPTIONS |
| result | rslt | 요청 결과 | List of Objects | |
| result.type | rslt.ty | 데이터 타입 | String | |
| result.codes | rslt.cds | 마켓 코드 리스트 | List of String | |
| result.level | rslt.lv | 호가 모아보기 단위 | Double | |
| ticket | tckt | 요청자를 식별할 수 있는 값 | Long |
주의 사항 - 요청 수 제한
LIST_SUBSCRIPTIONS역시 요청 수 제한에 포함됩니다. 자세한 기준은 요청 수 제한 페이지의 "WebSocket 데이터 요청"을 참고하시길 바랍니다.
Example
Request
예제 1. LIST_SUBSCRIPTIONS 요청
[
{
"method": "LIST_SUBSCRIPTIONS"
},
{
"ticket": "unique uuid"
}
]
Response
예제 1. public 데이터
{
"method": "LIST_SUBSCRIPTIONS",
"result": [
{
"type": "ticker",
"codes": ["KRW-BTC", "KRW-ETH"]
},
{
"type": "orderbook",
"codes": ["KRW-BTC", "KRW-ETH"],
"level": 0
}
],
"ticket": "unique uuid"
}
예제 2. private 데이터
{
"method": "LIST_SUBSCRIPTIONS",
"result": [
{
"type": "myAsset"
},
{
"type": "myOrder",
"codes": ["KRW-BTC", "KRW-ETH"]
}
],
"ticket": "unique uuid"
}