[{"data":1,"prerenderedAt":9},["ShallowReactive",2],{"api-documentation:guide\u002Fquickstart":3},{"title":4,"slug":5,"group":6,"version":7,"html":8},"빠른 시작","guide\u002Fquickstart","시작하기","0.4.0","\u003Ch1 id=\"빠른-시작\">빠른 시작\u003C\u002Fh1>\n\u003Cp>먼저 키 없이 공개 API를 호출한 뒤, API 키로 계정과 잔고를 확인합니다. 모든 예제의 마켓·지갑·주문 ID는 설명용 값이며 실제 조회 결과로 바꿔 사용하세요.\u003C\u002Fp>\n\u003Ch2 id=\"1-서버-시간과-마켓-확인\">1. 서버 시간과 마켓 확인\u003C\u002Fh2>\n\u003Cpre>\u003Ccode class=\"language-sh\">curl 'https:\u002F\u002Fapi.btxpro.co.kr\u002Fv1\u002Ftime'\ncurl 'https:\u002F\u002Fapi.btxpro.co.kr\u002Fv1\u002Fmarkets'\ncurl 'https:\u002F\u002Fapi.btxpro.co.kr\u002Fv1\u002Fmarket\u002Fticker?symbol=BTC-USDT'\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>성공 응답은 \u003Ccode>data\u003C\u002Fcode>, \u003Ccode>requestId\u003C\u002Fcode>, \u003Ccode>serverTime\u003C\u002Fcode>으로 구성됩니다. \u003Ccode>\u002Fhealth\u003C\u002Fcode>는 예외로 본문 없는 HTTP 200을 반환합니다.\u003C\u002Fp>\n\u003Ch2 id=\"2-api-키-발급\">2. API 키 발급\u003C\u002Fh2>\n\u003Cp>BTX 웹의 \u003Cstrong>마이페이지 → API\u003C\u002Fstrong>(\u003Ccode>\u002Fmy-page\u002Fapi\u003C\u002Fcode>)에서 발급합니다. OTP 활성화와 발급 시 OTP 확인이 필요합니다.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>잔고·주문 조회와 개인 WS: \u003Ccode>read\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>주문 생성·취소: \u003Ccode>trade\u003C\u002Fcode> 추가\u003C\u002Fli>\n\u003Cli>공개 시세·Feed와 공개 WS: API 키 불필요\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Secret Key는 발급 결과에 한 번만 표시됩니다. 서버의 비밀 관리 도구에 저장하고, 브라우저 프런트엔드에 넣지 마세요. 키는 계정에서 볼 수 있는 전체 지갑에 적용되며 지갑별 제한은 제공하지 않습니다.\u003C\u002Fp>\n\u003Ch2 id=\"3-서명된-조회-실행\">3. 서명된 조회 실행\u003C\u002Fh2>\n\u003Cp>키를 비밀 관리 도구 또는 현재 프로세스 환경에 주입한 상태에서 실행합니다. 문서 예제는 주문을 생성하지 않고 \u003Ccode>GET \u002Fv1\u002Faccount\u003C\u002Fcode>만 호출합니다.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-sh\">node signed-request.mjs\npython signed_request.py\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Ca href=\"\u002Fapi-docs\u002Fguide\u002Fexamples\u002F\">예제 다운로드와 실행 방법\u003C\u002Fa>을 확인하세요. 자체 클라이언트를 만들 경우 \u003Ca href=\"\u002Fapi-docs\u002Fguide\u002Fauthentication\u002F\">HMAC 인증 규칙\u003C\u002Fa>을 따라야 합니다.\u003C\u002Fp>\n\u003Cp>저장소에서 기존 Go 예제 클라이언트를 사용하는 경우 \u003Ccode>backend-base\u003C\u002Fcode>에서:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-sh\">go run .\u002Fcmd\u002Fetc\u002Fexternalapiclient -base-url https:\u002F\u002Fapi.btxpro.co.kr -command verify-key\ngo run .\u002Fcmd\u002Fetc\u002Fexternalapiclient -base-url https:\u002F\u002Fapi.btxpro.co.kr -command wallets\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Ccode>verify-key\u003C\u002Fcode>는 계정·지갑·개인 스트림의 초기 스냅샷을 확인한 뒤 종료합니다. 주문을 전송하지 않습니다.\u003C\u002Fp>\n\u003Ch2 id=\"4-공개-websocket-구독\">4. 공개 WebSocket 구독\u003C\u002Fh2>\n\u003Cp>키가 필요 없는 공개 연결은 브라우저에서도 사용할 수 있습니다.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-js\">const socket = new WebSocket('wss:\u002F\u002Fapi-ws.btxpro.co.kr\u002Fv1\u002Fmarket\u002Fstream')\nsocket.onopen = () => socket.send(JSON.stringify({\n  id: 'sub-1',\n  op: 'subscribe',\n  args: [{ channel: 'ticker', symbol: 'BTC-USDT' }],\n}))\nsocket.onmessage = ({ data }) => console.log(JSON.parse(data))\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>\u003Ccode>subscribed\u003C\u002Fcode> 응답 다음에 현재 캐시된 시세와 실시간 이벤트가 전달됩니다. 개인 WS는 연결 요청에 인증 헤더가 필요하므로 서버용 WS 클라이언트를 사용합니다.\u003C\u002Fp>\n",1793249660037]