[{"data":1,"prerenderedAt":9},["ShallowReactive",2],{"api-documentation:rest\u002Ftrading":3},{"title":4,"slug":5,"group":6,"version":7,"html":8},"거래","rest\u002Ftrading","REST API","0.4.0","\u003Ch1 id=\"주문과-체결\">주문과 체결\u003C\u002Fh1>\n\u003Cp>REST 기본 주소는 \u003Ccode>https:\u002F\u002Fapi.btxpro.co.kr\u003C\u002Fcode>입니다. 모든 요청은 서명하며, 조회는 read, 생성·취소는 trade 권한이 필요합니다.\u003C\u002Fp>\n\u003Ch2 id=\"지원하는-주문\">지원하는 주문\u003C\u002Fh2>\n\u003Cp>현재는 \u003Ccode>type: \"limit\"\u003C\u002Fcode>, \u003Ccode>timeInForce: \"GTC\"\u003C\u002Fcode>인 지정가 주문만 지원합니다. \u003Ccode>side\u003C\u002Fcode>는 \u003Ccode>buy\u003C\u002Fcode> 또는 \u003Ccode>sell\u003C\u002Fcode>입니다. 시장가, post-only, IOC\u002FFOK, quote 수량 주문은 지원하지 않습니다.\u003C\u002Fp>\n\u003Ch2 id=\"주문-생성\">주문 생성\u003C\u002Fh2>\n\u003Cpre>\u003Ccode class=\"language-http\">POST https:\u002F\u002Fapi.btxpro.co.kr\u002Fv1\u002Forders\nContent-Type: application\u002Fjson\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  \"symbol\": \"BTC-USDT\",\n  \"walletId\": 21,\n  \"side\": \"buy\",\n  \"type\": \"limit\",\n  \"timeInForce\": \"GTC\",\n  \"quantity\": \"0.100000000\",\n  \"price\": \"65000.000000000\"\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>위 JSON은 서명 전 본문의 예시입니다. 전송할 JSON 바이트로 서명한 뒤 인증 헤더를 붙여 요청합니다. 응답은 엔진 결과를 최대 10초 기다린 후 반환하며, 성공 시 \u003Ccode>data.orderId\u003C\u002Fcode>와 주문 상태를 확인합니다. 성공·실패 모델의 전체 필드는 \u003Ca href=\"\u002Fapi-docs\u002Fgenerated\u002Fschemas\u002F#schema-order\">주문 모델\u003C\u002Fa>을 확인하세요.\u003C\u002Fp>\n\u003Ch2 id=\"조회와-취소\">조회와 취소\u003C\u002Fh2>\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>GET\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fv1\u002Forders\u002Fopen\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>walletId\u003C\u002Fcode>, \u003Ccode>symbol\u003C\u002Fcode>, \u003Ccode>limit\u003C\u002Fcode> 선택\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>GET\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fv1\u002Forders\u002Fhistory\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>walletId\u003C\u002Fcode>, \u003Ccode>symbol\u003C\u002Fcode>, \u003Ccode>limit\u003C\u002Fcode>, \u003Ccode>startTime\u003C\u002Fcode>, \u003Ccode>endTime\u003C\u002Fcode> 선택\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>GET\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fv1\u002Forders\u002F{orderId}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>orderId 필수\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>DELETE\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fv1\u002Forders\u002F{orderId}\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>orderId 필수, \u003Ccode>walletId\u003C\u002Fcode>, \u003Ccode>symbol\u003C\u002Fcode>은 일치 여부 확인용\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>DELETE\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fv1\u002Forders\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>walletId\u003C\u002Fcode> 필수, \u003Ccode>symbol\u003C\u002Fcode>, \u003Ccode>limit\u003C\u002Fcode> 선택\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>GET\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>\u002Fv1\u002Ffills\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>walletId\u003C\u002Fcode>, \u003Ccode>symbol\u003C\u002Fcode>, \u003Ccode>limit\u003C\u002Fcode>, \u003Ccode>startTime\u003C\u002Fcode>, \u003Ccode>endTime\u003C\u002Fcode> 선택\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>단건 취소 예시 경로:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">DELETE \u002Fv1\u002Forders\u002F987654?walletId=21&symbol=BTC-USDT\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>서명할 쿼리는 정렬된 \u003Ccode>symbol=BTC-USDT&walletId=21\u003C\u002Fcode>입니다. 서명 예제가 전송 쿼리도 같은 방식으로 생성합니다.\u003C\u002Fp>\n\u003Cp>일괄 취소는 지정한 지갑의 대상 주문을 선택합니다. 최대 16개 엔진 명령을 동시에 처리하고, 배치 전체가 하나의 10초 제한을 공유합니다. 결과의 \u003Ccode>items\u003C\u002Fcode>와 \u003Ccode>hasMore\u003C\u002Fcode>를 확인하세요. 개별 취소 실패도 항목별로 확인해야 하며 HTTP 성공만으로 전체 주문의 취소를 판단하면 안 됩니다.\u003C\u002Fp>\n\u003Ch2 id=\"timeouts-and-retries\">주문 타임아웃과 재시도\u003C\u002Fh2>\n\u003Cp>\u003Ccode>ENGINE_TIMEOUT\u003C\u002Fcode>은 주문이 실패했다는 확정 응답이 아닙니다. 엔진에서 처리됐지만 응답을 받지 못했을 수 있습니다.\u003C\u002Fp>\n\u003Col>\n\u003Cli>같은 생성·취소 요청을 자동으로 다시 보내지 않습니다.\u003C\u002Fli>\n\u003Cli>미체결 주문, 주문 이력, 체결 이력을 조회합니다.\u003C\u002Fli>\n\u003Cli>개인 WS를 사용한다면 재연결 후 새 스냅샷도 반영합니다.\u003C\u002Fli>\n\u003Cli>결과를 식별하지 못하면 중복 주문 위험을 감수하는 자동 재전송 대신 운영 확인 절차로 전환합니다.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>고객 주문 ID, 멱등성 키, 요청 상태 조회 엔드포인트는 현재 없습니다. \u003Ccode>requestId\u003C\u002Fcode>와 WS 명령 \u003Ccode>id\u003C\u002Fcode>는 요청·응답을 연결하는 값입니다.\u003C\u002Fp>\n",1793249660042]