[{"data":1,"prerenderedAt":9},["ShallowReactive",2],{"api-documentation:guide\u002Fconventions":3},{"title":4,"slug":5,"group":6,"version":7,"html":8},"공통 규칙","guide\u002Fconventions","시작하기","0.4.0","\u003Ch1 id=\"응답과-공통-규칙\">응답과 공통 규칙\u003C\u002Fh1>\n\u003Ch2 id=\"주소와-경로\">주소와 경로\u003C\u002Fh2>\n\u003Cp>REST는 \u003Ccode>https:\u002F\u002Fapi.btxpro.co.kr\u003C\u002Fcode>, WS는 \u003Ccode>wss:\u002F\u002Fapi-ws.btxpro.co.kr\u003C\u002Fcode>입니다. 대부분의 REST 경로는 \u003Ccode>\u002Fv1\u003C\u002Fcode>으로 시작하며 \u003Ccode>\u002Fhealth\u003C\u002Fcode>, \u003Ccode>\u002Fready\u003C\u002Fcode>만 예외입니다. WS 연결 경로는 \u003Ccode>\u002Fv1\u002Fmarket\u002Fstream\u003C\u002Fcode>, \u003Ccode>\u002Fv1\u002Fuser\u002Fstream\u003C\u002Fcode>입니다.\u003C\u002Fp>\n\u003Ch2 id=\"rest-responses\">REST 응답\u003C\u002Fh2>\n\u003Cp>일반적인 성공 응답:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  \"data\": {},\n  \"requestId\": \"req_1783420800123456789\",\n  \"serverTime\": 1783420800123\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>오류 응답:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  \"error\": { \"code\": \"INVALID_REQUEST\", \"message\": \"Request is invalid.\" },\n  \"requestId\": \"req_1783420800123456789\",\n  \"serverTime\": 1783420800123\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Ccode>GET \u002Fhealth\u003C\u002Fcode>는 본문 없는 HTTP 200, WS 업그레이드는 HTTP 101이므로 이 JSON envelope를 사용하지 않습니다. JSON 응답에는 \u003Ccode>Cache-Control: no-store\u003C\u002Fcode>가 설정됩니다.\u003C\u002Fp>\n\u003Ch2 id=\"요청-추적\">요청 추적\u003C\u002Fh2>\n\u003Cp>\u003Ccode>X-Request-Id\u003C\u002Fcode>가 응답 헤더와 JSON의 \u003Ccode>requestId\u003C\u002Fcode>에 포함됩니다. 클라이언트가 이 헤더를 지정할 경우 80자 이내의 영문·숫자·\u003Ccode>-_.:\u003C\u002Fcode>로 구성합니다. 장애 문의나 로그 연계에 사용하며, 주문의 중복 처리를 방지하는 값은 아닙니다.\u003C\u002Fp>\n\u003Ch2 id=\"숫자와-시각\">숫자와 시각\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>가격·수량·금액·수수료·잔고는 십진수 \u003Cstrong>문자열\u003C\u002Fstrong>입니다. 부동소수점 변환 대신 decimal 연산을 사용합니다.\u003C\u002Fli>\n\u003Cli>\u003Ccode>orderId\u003C\u002Fcode>와 같은 문자열 ID는 숫자로 변환하지 않고 보존합니다.\u003C\u002Fli>\n\u003Cli>\u003Ccode>serverTime\u003C\u002Fcode>, 주문 조회의 \u003Ccode>startTime\u003C\u002Fcode>·\u003Ccode>endTime\u003C\u002Fcode>은 Unix 밀리초입니다.\u003C\u002Fli>\n\u003Cli>Feed의 \u003Ccode>publishedMicrotime\u003C\u002Fcode>·\u003Ccode>creationMicrotime\u003C\u002Fcode>·\u003Ccode>updateMicrotime\u003C\u002Fcode> 및 WS 체결의 \u003Ccode>microtime\u003C\u002Fcode>은 Unix 마이크로초입니다. 개별 모델의 필드명을 확인하세요.\u003C\u002Fli>\n\u003Cli>마켓 식별자는 \u003Ccode>BTC-USDT\u003C\u002Fcode>와 같은 \u003Ccode>symbol\u003C\u002Fcode>입니다. 현재 지원 여부와 통화 ID는 마켓 목록에서 확인합니다.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"쿼리와-목록\">쿼리와 목록\u003C\u002Fh2>\n\u003Cp>쿼리 키는 한 번만 보내고 빈 값을 보내지 마세요. 정확한 기본값·범위는 \u003Ca href=\"\u002Fapi-docs\u002Fgenerated\u002Frest\u002F\">전체 엔드포인트\u003C\u002Fa>에 표시됩니다.\u003C\u002Fp>\n\u003Cp>거래 목록의 \u003Ccode>limit\u003C\u002Fcode> 최대값은 1000입니다. 주문·체결 이력은 기본적으로 요청 시점까지 최근 30일을 조회하며 \u003Ccode>startTime\u003C\u002Fcode>, \u003Ccode>endTime\u003C\u002Fcode>으로 범위를 지정할 수 있습니다. \u003Ccode>hasMore\u003C\u002Fcode>가 있는 응답은 추가 데이터가 있을 수 있음을 표시합니다. 거래 이력 API는 Feed의 \u003Ccode>cursor\u003C\u002Fcode> 페이지네이션을 제공하지 않습니다.\u003C\u002Fp>\n\u003Cp>Feed 일반 목록은 기본 20개, 최대 100개이며 \u003Ccode>hasMore\u003C\u002Fcode>와 \u003Ccode>nextCursor\u003C\u002Fcode>를 제공합니다. 다음 페이지에는 이전 응답의 \u003Ccode>nextCursor\u003C\u002Fcode>를 \u003Ccode>cursor\u003C\u002Fcode>로 전달합니다. cursor는 정렬 방식에 연결되므로 정렬을 바꾸면 초기화합니다. \u003Ccode>q\u003C\u002Fcode> 검색은 \u003Ccode>sort\u003C\u002Fcode>·\u003Ccode>cursor\u003C\u002Fcode>와 함께 사용할 수 없으며 결과 개수는 limit으로 제한됩니다.\u003C\u002Fp>\n\u003Ch2 id=\"권한\">권한\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>공개 REST·공개 WS\u003C\u002Ftd>\n\u003Ctd>없음\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>GET \u002Fv1\u002Faccount\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>유효한 서명된 키\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>지갑·잔고·주문·체결 조회\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>주문 생성·취소\u003C\u002Ftd>\n\u003Ctd>trade\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>개인 WS 연결\u003C\u002Ftd>\n\u003Ctd>read\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>개인 WS 주문 명령\u003C\u002Ftd>\n\u003Ctd>read로 연결한 뒤 trade 추가 확인\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>현재 키의 접근 범위는 계정에서 볼 수 있는 전체 지갑입니다. 외부 API에는 지갑별 키 범위 설정이 없습니다.\u003C\u002Fp>\n",1793249660039]