WebSocket APIPublic API

WebSocket을 이용한 방식으로, 현재가, 호가, 체결에 대한 정보를 수신할 수 있습니다.

WebSocket 을 이용하여 수신할 수 있는 정보
  • 현재가(ticker)
  • 호가(orderbook)
  • 체결(transaction)

접속정보wss://pubwss.bithumb.com/pub/ws

접속 성공 시 응답 메시지

{
	"status" : "0000",
	"resmsg" : "Connected Successfully"
}

필터 설정 응답

필드, 설명, 타입으로 구성된 표
성공실패
{"status":"0000", "resmsg":"Filter Registered Successfully"}{"status":"5100", "resmsg":"Invalid Filter Syntax"}

구독 요청 형식

필드, 설명, 타입으로 구성된 표
필드설명타입
type구독 메시지 종류("ticker" / "transaction" / "orderbookdepth")String
symbolsBTC_KRW, ETH_KRW, …Array (String)
(optional) tickTypestick 종류 ("30M"/"1H"/"12H"/"24H"/"MID")Array (String)
- 예제
  • 현재가(ticker)
    {"type":"ticker", "symbols": ["BTC_KRW", "ETH_KRW"], "tickTypes": ["30M", "1H", "12H", "24H", "MID" ]}
  • 체결(transaction)
    {"type":"transaction", "symbols":["BTC_KRW" , "ETH_KRW"]}
  • 변경호가(orderbookdepth)
    {"type":"orderbookdepth", "symbols":["BTC_KRW" , "ETH_KRW"]}

Example Response (ticker)

{
	"type" : "ticker",
	"content" : {
		"symbol" : "BTC_KRW",			// 통화코드
		"tickType" : "24H",					// 변동 기준시간- 30M, 1H, 12H, 24H, MID
		"date" : "20200129",				// 일자
		"time" : "121844",					// 시간
		"openPrice" : "2302",				// 시가
		"closePrice" : "2317",				// 종가
		"lowPrice" : "2272",				// 저가
		"highPrice" : "2344",				// 고가
		"value" : "2831915078.07065789",	// 누적거래금액
		"volume" : "1222314.51355788",	// 누적거래량
		"sellVolume" : "760129.34079004",	// 매도누적거래량
		"buyVolume" : "462185.17276784",	// 매수누적거래량
		"prevClosePrice" : "2326",			// 전일종가
		"chgRate" : "0.65",					// 변동률
		"chgAmt" : "15",					// 변동금액
		"volumePower" : "60.80"			// 체결강도
	}
}

Example Response (orderbookdepth)

{
	"type" : "orderbookdepth",
		"content" : {
		"list" : [
			{
				"symbol" : "BTC_KRW",
				"orderType" : "ask",		// 주문타입 – bid / ask
				"price" : "10593000",		// 호가
				"quantity" : "1.11223318",	// 잔량
				"total" : "3"				// 건수
			},
			{"symbol" : "BTC_KRW", "orderType" : "ask", "price" : "10596000", "quantity" : "0.5495", "total" : "8"},
			{"symbol" : "BTC_KRW", "orderType" : "ask", "price" : "10598000", "quantity" : "18.2085", "total" : "10"},
			{"symbol" : "BTC_KRW", "orderType" : "bid", "price" : "10532000", "quantity" : "0", "total" : "0"},
			{"symbol" : "BTC_KRW", "orderType" : "bid", "price" : "10572000", "quantity" : "2.3324", "total" : "4"},
			{"symbol" : "BTC_KRW", "orderType" : "bid", "price" : "10571000", "quantity" : "1.469", "total" : "3"},
			{"symbol" : "BTC_KRW", "orderType" : "bid", "price" : "10569000", "quantity" : "0.5152", "total" : "2"}
		],
		"datetime":1580268255864325		// 일시
	}
}

Example Response (transaction)

{
	"type" : "transaction",
	"content" : {
		"list" : [
			{
				"symbol" : "BTC_KRW",					// 통화코드
				"buySellGb" : "1",							// 체결종류(1:매도체결, 2:매수체결)
				"contPrice" : "10579000",					// 체결가격
				"contQty" : "0.01",							// 체결수량
				"contAmt" : "105790.00",					// 체결금액
				"contDtm" : "2020-01-29 12:24:18.830039",	// 체결시각
				"updn" : "dn"								// 직전 시세와 비교 : up-상승, dn-하락
			}
		]
	}
}