[{"data":1,"prerenderedAt":9},["ShallowReactive",2],{"api-documentation:websocket\u002Foverview":3},{"title":4,"slug":5,"group":6,"version":7,"html":8},"WS 연결","websocket\u002Foverview","WebSocket API","0.4.0","\u003Ch1 id=\"websocket-연결과-공통-규칙\">WebSocket 연결과 공통 규칙\u003C\u002Fh1>\n\u003Cp>외부 WebSocket은 운영 환경에서 \u003Cstrong>\u003Ccode>wss:\u002F\u002Fapi-ws.btxpro.co.kr\u003C\u002Fcode>\u003C\u002Fstrong> 호스트를 사용합니다. REST의 \u003Ccode>api.btxpro.co.kr\u003C\u002Fcode>와 구분해서 사용합니다.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>스트림\u003C\u002Fth>\n\u003Cth>전체 연결 주소\u003C\u002Fth>\n\u003Cth>용도\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>공개\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>wss:\u002F\u002Fapi-ws.btxpro.co.kr\u002Fv1\u002Fmarket\u002Fstream\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>ticker 구독·해제\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>개인\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>wss:\u002F\u002Fapi-ws.btxpro.co.kr\u002Fv1\u002Fuser\u002Fstream\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>주문·체결·잔고 수신과 주문 명령\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>공개·개인 스트림은 별도 연결입니다. 개인 주문 명령은 개인 이벤트를 수신하는 \u003Cstrong>동일 연결\u003C\u002Fstrong>로 전송합니다. 별도 거래용 호스트나 경로는 없습니다.\u003C\u002Fp>\n\u003Ch2 id=\"연결-방법\">연결 방법\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>공개 스트림은 키 없이 HTTP GET을 WebSocket으로 업그레이드합니다. 쿼리 파라미터는 받지 않습니다.\u003C\u002Fli>\n\u003Cli>개인 스트림은 GET 업그레이드 요청에 \u003Ca href=\"\u002Fapi-docs\u002Fguide\u002Fauthentication\u002F#websocket-authentication\">인증 헤더\u003C\u002Fa>를 포함합니다.\u003C\u002Fli>\n\u003Cli>연결 후에는 UTF-8 JSON 텍스트 프레임을 사용합니다.\u003C\u002Fli>\n\u003Cli>공개 스트림은 \u003Ccode>subscribe\u003C\u002Fcode>를 보내야 시세를 받습니다. 개인 스트림은 연결 직후 \u003Ccode>snapshot\u003C\u002Fcode>을 받으며 별도 subscribe가 없습니다.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"heartbeat-and-limits\">heartbeat와 제한\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>항목\u003C\u002Fth>\n\u003Cth>제한\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>서버 ping\u003C\u002Ftd>\n\u003Ctd>30초마다 WebSocket 제어 프레임\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>pong 제한\u003C\u002Ftd>\n\u003Ctd>75초\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>공개 명령 크기\u003C\u002Ftd>\n\u003Ctd>8 KiB\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>개인 명령 크기\u003C\u002Ftd>\n\u003Ctd>16 KiB\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>명령 ID\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>[A-Za-z0-9._:-]+\u003C\u002Fcode>, 최대 64자\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>공개 구독\u003C\u002Ftd>\n\u003Ctd>개별 symbol 최대 100개 또는 wildcard 하나\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>개인 명령 대기열\u003C\u002Ftd>\n\u003Ctd>연결당 32개\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>공개·개인 이벤트 큐\u003C\u002Ftd>\n\u003Ctd>각각 256개 \u002F 128개\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>개인 키·권한 재확인\u003C\u002Ftd>\n\u003Ctd>명령마다, 유휴 연결은 60초마다\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>라이브러리의 ping\u002Fpong 처리를 사용하세요. JSON \u003Ccode>{\"op\":\"ping\"}\u003C\u002Fcode> 명령은 프로토콜에 없습니다. 서버가 이벤트를 보내는 속도를 따라가지 못하면 \u003Ccode>1013 \u002F EVENT_BUFFER_OVERFLOW\u003C\u002Fcode>로 종료됩니다.\u003C\u002Fp>\n\u003Ch2 id=\"sequence와-명령-id\">sequence와 명령 ID\u003C\u002Fh2>\n\u003Cp>공개 데이터 이벤트는 연결마다 \u003Ccode>sequence: 1\u003C\u002Fcode>부터 연속 증가합니다. 개인 연결은 초기 \u003Ccode>snapshot\u003C\u002Fcode>이 0, 이후 \u003Ccode>order\u003C\u002Fcode>·\u003Ccode>fill\u003C\u002Fcode>·\u003Ccode>balance\u003C\u002Fcode>가 공통 sequence로 1부터 연속 증가합니다.\u003C\u002Fp>\n\u003Cp>구독 확인이나 개인 명령의 \u003Ccode>response\u003C\u002Fcode>·\u003Ccode>error\u003C\u002Fcode>는 데이터 sequence를 사용하지 않습니다. 개인 주문 이벤트가 명령 성공 응답보다 먼저 도착할 수도 있습니다. 명령 \u003Ccode>id\u003C\u002Fcode>와 데이터 \u003Ccode>sequence\u003C\u002Fcode>를 별도로 추적하세요.\u003C\u002Fp>\n\u003Ch2 id=\"다음-가이드\">다음 가이드\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Ca href=\"\u002Fapi-docs\u002Fwebsocket\u002Fmarket\u002F\">공개 시세: subscribe, unsubscribe, ticker\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fapi-docs\u002Fwebsocket\u002Fuser\u002F\">개인 이벤트: snapshot, order, fill, balance\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fapi-docs\u002Fwebsocket\u002Fcommands\u002F\">주문 명령: create, cancel, amend\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fapi-docs\u002Fwebsocket\u002Frecovery\u002F\">재연결과 상태 복구\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>\u003Ca href=\"\u002Fapi-docs\u002Fgenerated\u002Fwebsocket\u002F\">모든 메시지 스키마\u003C\u002Fa>\u003C\u002Fli>\n\u003C\u002Ful>\n",1793249660044]