[{"data":1,"prerenderedAt":9},["ShallowReactive",2],{"api-documentation:guide\u002Ferrors":3},{"title":4,"slug":5,"group":6,"version":7,"html":8},"에러","guide\u002Ferrors","연동과 운영","0.4.0","\u003Ch1 id=\"에러와-호출-제한\">에러와 호출 제한\u003C\u002Fh1>\n\u003Cp>REST 오류는 HTTP 상태 코드와 \u003Ccode>error.code\u003C\u002Fcode>를 함께 확인합니다. WS 명령 오류는 \u003Ccode>event: \"error\"\u003C\u002Fcode>의 \u003Ccode>error.code\u003C\u002Fcode>와 명령 \u003Ccode>id\u003C\u002Fcode>를 확인합니다. \u003Ca href=\"\u002Fapi-docs\u002Fguide\u002Fconventions\u002F#rest-responses\">오류 응답 형식\u003C\u002Fa>을 참고하세요.\u003C\u002Fp>\n\u003Ch2 id=\"오류-코드\">오류 코드\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>HTTP\u003C\u002Fth>\n\u003Cth>코드\u003C\u002Fth>\n\u003Cth>다음 행동\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd>400\u003C\u002Ftd>\n\u003Ctd>INVALID_REQUEST, WALLET_REQUIRED, UNSUPPORTED_OPERATION\u003C\u002Ftd>\n\u003Ctd>파라미터·walletId·명령 확인\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>MISSING_AUTH, INVALID_API_KEY\u003C\u002Ftd>\n\u003Ctd>인증 헤더와 키 상태 확인\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>INVALID_SIGNATURE\u003C\u002Ftd>\n\u003Ctd>실제 경로·정렬 쿼리·본문 바이트로 다시 서명\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>401\u003C\u002Ftd>\n\u003Ctd>TIMESTAMP_OUT_OF_RANGE\u003C\u002Ftd>\n\u003Ctd>시간 동기화와 수신 시간 범위 확인\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>403\u003C\u002Ftd>\n\u003Ctd>NO_PERMISSION, ORDER_BLOCKED\u003C\u002Ftd>\n\u003Ctd>키·계정·거래 제한 확인\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>404\u003C\u002Ftd>\n\u003Ctd>ENDPOINT_NOT_FOUND, WALLET_NOT_FOUND, MARKET_NOT_FOUND, ORDER_NOT_FOUND\u003C\u002Ftd>\n\u003Ctd>경로·ID·접근 범위 확인\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>405\u003C\u002Ftd>\n\u003Ctd>METHOD_NOT_ALLOWED\u003C\u002Ftd>\n\u003Ctd>응답 Allow 헤더와 요청 메서드 확인\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>409\u003C\u002Ftd>\n\u003Ctd>INVALID_NONCE\u003C\u002Ftd>\n\u003Ctd>레거시 nonce 형식 확인. 새 구현은 생략\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>409\u003C\u002Ftd>\n\u003Ctd>DUPLICATE_COMMAND_ID\u003C\u002Ftd>\n\u003Ctd>같은 연결에서 처리 중인 명령 ID 확인\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>413\u003C\u002Ftd>\n\u003Ctd>PAYLOAD_TOO_LARGE\u003C\u002Ftd>\n\u003Ctd>본문 크기 축소\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>422\u003C\u002Ftd>\n\u003Ctd>MARKET_NOT_TRADING, ORDER_ALREADY_CLOSED, INSUFFICIENT_BALANCE, UNSUPPORTED_ORDER_OPTION\u003C\u002Ftd>\n\u003Ctd>마켓·주문 상태, 잔고, 주문 옵션 확인\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>422\u003C\u002Ftd>\n\u003Ctd>ENGINE_REJECTED_{status}\u003C\u002Ftd>\n\u003Ctd>엔진 거절 결과 확인. 같은 요청 무조건 재시도 금지\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>429\u003C\u002Ftd>\n\u003Ctd>RATE_LIMITED\u003C\u002Ftd>\n\u003Ctd>읽기는 Retry-After와 백오프 적용\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>500\u003C\u002Ftd>\n\u003Ctd>INTERNAL_ERROR\u003C\u002Ftd>\n\u003Ctd>requestId 기록. 읽기만 제한적으로 재시도\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>501\u003C\u002Ftd>\n\u003Ctd>AMEND_NOT_SUPPORTED\u003C\u002Ftd>\n\u003Ctd>원자적 주문 정정 미지원. 원래 주문은 유지\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>503\u003C\u002Ftd>\n\u003Ctd>ENGINE_UNAVAILABLE, SERVICE_UNAVAILABLE\u003C\u002Ftd>\n\u003Ctd>의존성 복구 확인. 쓰기는 주문 상태도 대조\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>504\u003C\u002Ftd>\n\u003Ctd>ENGINE_TIMEOUT\u003C\u002Ftd>\n\u003Ctd>처리 결과 불명. 주문·체결 조회 후 결정\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>HTTP 코드와 함께 반환되는 세부 오류는 엔드포인트와 실행 시점에 따라 달라집니다. 검증·권한 오류는 요청을 수정하지 않은 채 반복하지 마세요.\u003C\u002Fp>\n\u003Ch2 id=\"호출-제한\">호출 제한\u003C\u002Fh2>\n\u003Cp>현재 환경 설정의 요청 예산은 IP당 \u003Cstrong>10초에 1000회\u003C\u002Fstrong>입니다. 메모리에서 게이트웨이 인스턴스별로 관리하며 전역 계정 할당량이 아닙니다. 운영 설정이 변경되면 실제 응답의 429와 \u003Ccode>Retry-After\u003C\u002Fcode>를 우선합니다.\u003C\u002Fp>\n\u003Cp>HTTP 업그레이드와 수신한 WS 명령도 IP 요청 예산을 소비합니다. 서버가 보내는 WS 이벤트는 소비하지 않습니다. 재접속이나 헤더 변경으로 IP 예산을 초기화할 수 없습니다.\u003C\u002Fp>\n\u003Cp>일반 429는 IP ban을 의미하지 않으며 위반 점수도 추가하지 않습니다. 외부 API의 JSON·스키마 위반은 IP별로 REST·WS에 공유해 집계하며, 2분 집계 구간에 5회가 되면 10분 동안 차단합니다. 잘못된 WS 프레임·인코딩은 즉시 차단합니다.\u003C\u002Fp>\n\u003Cp>API 키의 허용 IP 목록에 없는 주소는 HTTP 403 \u003Ccode>IP_NOT_ALLOWED\u003C\u002Fcode>를 받습니다. 키를 발급한 IP 정책을 확인하세요. 이 거절은 위반 점수에 포함하지 않습니다.\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 요청 본문\u003C\u002Ftd>\n\u003Ctd>1 MiB\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>receive window\u003C\u002Ftd>\n\u003Ctd>기본 5초, 최대 60초\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>거래 목록 limit\u003C\u002Ftd>\n\u003Ctd>최대 1000\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>Feed 목록 limit\u003C\u002Ftd>\n\u003Ctd>기본 20, 최대 100\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>주문 엔진 응답 대기\u003C\u002Ftd>\n\u003Ctd>10초\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>일괄 취소\u003C\u002Ftd>\n\u003Ctd>동시 최대 16개, 배치 전체 10초\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>공개·개인 WS 명령 크기\u003C\u002Ftd>\n\u003Ctd>각각 8 KiB \u002F 16 KiB\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\u003Cp>WS의 ping\u002Fpong·구독·대기열 제한은 \u003Ca href=\"\u002Fapi-docs\u002Fwebsocket\u002Foverview\u002F#heartbeat-and-limits\">연결 규칙\u003C\u002Fa>에 있습니다.\u003C\u002Fp>\n\u003Ch2 id=\"재시도-정책\">재시도 정책\u003C\u002Fh2>\n\u003Cp>읽기의 429는 Retry-After 이후, 일시적인 5xx는 제한된 지수 백오프와 jitter로 재시도합니다. 주문 생성·취소의 연결 종료·타임아웃은 \u003Ca href=\"\u002Fapi-docs\u002Frest\u002Ftrading\u002F#timeouts-and-retries\">주문 결과 확인\u003C\u002Fa>을 먼저 수행합니다. timestamp 검증은 멱등성을 보장하지 않습니다.\u003C\u002Fp>\n",1793249660045]