Public 웹소켓

Public 웹소켓 이용 안내

Public 웹소켓은 별도의 인증 없이 수신이 가능합니다. 제공하는 데이터는 아래와 같습니다.

  • 오더북 응답 (ORDERBOOK)
  • 티커 응답 (TICKER)
  • 체결정보 응답 (TRADE)
  • 차트 응답 (CHART)

Public 웹소켓 기본 정보

웹소켓 커넥션

  • URI : wss://stream.coinone.co.kr

메세지 포맷

  • 코인원 웹소켓을 통해 주고받는 메시지는 JSON 포맷입니다.
  • 응답의 타임스탬프는 밀리초 단위입니다.

지원하는 거래쌍

  • 거래지원중인 모든 마켓에 대해 지원 합니다.

제약사항

  • IP 당 최대 20개의 연결을 허용합니다.
    • 20개의 연결을 초과할 경우 4290 Close Code 와 함께 연결이 자동 종료됩니다. 이때 CONNECTED 메시지를 먼저 받은 뒤 종료될 수 있습니다.
  • request_type / channel / format 의 값은 대문자로 정확하게 입력되어야 합니다.
  • 서버는 마지막 PING 요청 이후 30분이 지났을 경우 유휴연결로 판단해 연결을 종료합니다. 연결종료를 방지하기 위해 PING 요청을 주기적으로 서버에 송신해야 합니다.
  • 웹소켓에 업데이트가 있을 경우 기존 연결이 종료될 수 있습니다. 연결이 종료될 경우 재 연결을 할 수 있도록 고려해야 합니다.

Public 웹소켓 요청 방법

Request

필드타입필수설명
request_typeString필수실행할 요청 종류: SUBSCRIBE / UNSUBSCRIBE / PING
channelString조건부구독 채널명: ORDERBOOK / TICKER / TRADE / CHART
PING 요청 시 생략
topicObject조건부quote_currency, target_currency 등의 정보를 JSON 형식으로 입력
PING 요청 시 생략
formatString선택단축 변수명으로 구독 원하는 경우 SHORT 입력
기본값: DEFAULT

웹소켓 연결 예시 - wscat 이용

wscat -c wss://stream.coinone.co.kr

Connected (press CTRL+C to quit)
< {"response_type":"CONNECTED","data":{"session_id":"57a97041-a6ee-aa86-fb6d-6f51f626dc4c"}}

Error Message

코드메시지설명
160010Invalid Request올바르지 않은 양식으로 요청한 경우
160011Invalid Type잘못 입력한 필드가 있을 경우. 필드명은 field 키로 반환됩니다.
160012Invalid Topic구독 요청한 Topic 이 올바르지 않을 경우

Error Response

에러 발생시 다음과 같은 형태로 에러 메세지가 전달됩니다.

{
  "response_type":"ERROR",
  "error_code":160012,
  "message":"Invalid Topic"
}

160011 에러는 잘못 입력한 필드명을 field 키로 함께 전달합니다.

{
  "response_type":"ERROR",
  "error_code":160011,
  "message":"Invalid Type",
  "field":"channel"
}