자주 나타나는 봇 및 주문 오류 메시지 (그리고 그 의미)

#자주 나타나는 봇 및 주문 오류 메시지 (그리고 그 의미)

봇이 무언가를 수행할 수 없을 때 짧은 메시지를 보여주지만, 그에 대해 무엇을 해야 할지가 항상 분명하지는 않습니다. 이 문서는 빠른 조회용입니다. 본 메시지를 찾아 그 의미를 이해하고, 직접 해결해야 할 문제인지 아니면 거래소가 스스로 해결하는 문제인지 파악하세요. 더 깊이 알아보려면 각 그룹에서 전용 문제 해결 가이드로 연결됩니다.

---

#잔액 및 증거금

표시되는 메시지	의미	조치 방법
“잔액이 부족합니다. 계정 자금을 확인해 주세요.”	이 주문을 위한 거래소의 사용 가능 자금이 부족합니다.	거래소에 자금을 추가하거나 봇의 주문 금액을 낮추세요.
“증거금이 부족합니다. 포지션 크기를 줄이거나 증거금을 추가해 주세요.”	선물: 이 레버리지에서 포지션에 필요한 증거금이 부족합니다.	증거금을 추가하거나, 포지션 크기를 낮추거나, 레버리지를 조정하세요.
“주문 금액이 너무 작습니다. 봇 거래 금액을 늘려 주세요.”	거래쌍의 최소 주문 크기 미만입니다.	봇 금액을 거래쌍의 최소값 이상으로 늘리세요.

➡️ 심층 가이드: 봇이 일시정지되거나 중지된 이유는? 및 봇에 필요한 자본은 얼마인가.

#API 키 및 권한

표시되는 메시지	의미	조치 방법
“API 키 오류입니다. API 키가 유효하고 거래 권한이 있는지 확인해 주세요.”	키가 유효하지 않거나, 취소되었거나, 거래 권한이 없습니다.	거래가 활성화된 상태로 키를 다시 확인하거나 재생성하세요.
“API 키가 IP 제한되어 있습니다. 서버 IP를 화이트리스트에 추가해 주세요.”	키의 IP 허용 목록에 Freya의 서버 IP가 포함되어 있지 않습니다.	연결 화면에 표시된 IP를 키의 화이트리스트에 추가하세요.

➡️ 심층 가이드: 거래소를 연결할 수 없나요? API 키 오류.

#레버리지 및 증거금 모드 (선물)

표시되는 메시지	의미	조치 방법
“유효하지 않은 레버리지 값입니다. 거래소 설정을 확인해 주세요.”	이 거래쌍에서 허용되지 않는 레버리지입니다.	거래쌍의 허용 범위 내에서 레버리지를 선택하세요.
“포지션 가치가 이 레버리지에서 허용되는 최댓값을 초과합니다. 레버리지 또는 포지션 크기를 줄여 주세요.”	선택한 레버리지 구간에 비해 명목 가치가 너무 큽니다.	레버리지 또는 포지션 크기를 줄이세요.
“포지션 모드 불일치입니다. Hedge/One-Way 모드 설정을 확인해 주세요.”	봇의 방향이 거래소의 포지션 모드와 충돌합니다.	거래소의 Hedge/One-Way 모드를 봇에 맞추세요 — Hedge 모드 vs One-Way를 참조하세요.
“다중 자산 모드가 격리 증거금과 충돌합니다. 교차 증거금으로 전환하거나 다중 자산 모드를 비활성화해 주세요.”	다중 자산 증거금은 격리 증거금과 함께 사용할 수 없습니다.	거래소에서 교차 증거금으로 전환하거나 다중 자산 모드를 끄세요.

➡️ 관련 문서: 증거금 유형: 교차 vs 격리 · Hedge 모드 vs One-Way.

#주문 문제

표시되는 메시지	의미	조치 방법
“최대 미체결 주문 수에 도달했습니다. 일부 주문을 먼저 종료해 주세요.”	거래소의 미체결 주문 한도에 도달했습니다.	일부 미체결 주문을 취소한 다음 다시 시도하세요.
“주문 가격이 시장 가격에서 너무 많이 벗어났습니다. 다시 시도해 주세요.”	지정가가 시장가 대비 거래소의 허용 범위를 벗어났습니다.	다시 시도하세요. 지정가 진입의 경우 시장가에 더 가까운 가격을 설정하세요.
“Reduce-only 주문이 거부되었습니다. 포지션이 이미 종료되었을 수 있습니다.”	청산 전용 주문이 거부되었습니다 — 보통 청산할 것이 남아 있지 않기 때문입니다.	거래소에서 포지션을 확인하세요. 이미 종료되었을 가능성이 높습니다.
“시장이 취소 전용 모드입니다. 지금 새 주문을 발주할 수 없습니다.”	거래소가 시장을 취소 전용 모드로 전환했습니다(점검/정산).	기다리세요 — 거래소가 다시 열리면 해결됩니다. 사용자의 잘못이 아닙니다.
“거래소에서 주문을 찾을 수 없습니다. 체결되었거나 취소되었을 수 있습니다.”	참조된 주문이 더 이상 존재하지 않습니다.	보통 문제없습니다 — 체결되었거나 취소된 것입니다. 거래를 확인하세요.

➡️ 심층 가이드(청산 문제): 거래가 종료되지 않아요.

#거래쌍 (상장 폐지)

표시되는 메시지	의미	조치 방법
“거래쌍을 찾을 수 없습니다. 거래소에서 상장 폐지되었을 수 있습니다.”	거래소에서 거래쌍이 제거되었거나 이름이 변경되었습니다.	봇을 활성 상태로 상장된 거래쌍으로 변경하세요.
“거래소에서 거래쌍을 찾을 수 없습니다. 상장 폐지되었을 수 있습니다.”	거래소가 해당 종목이 존재하지 않는다고 보고합니다.	현재 상장된 거래쌍을 선택하세요.

이는 거래소 측 변경이며 사용자의 잘못이 아닙니다 — 거래소가 코인을 상장 폐지하면 어떤 봇도 그것을 계속 거래할 수 없습니다.

#청산 주문 발주 (“포지션을 수동으로 확인해 주세요”)

표시되는 메시지	의미	조치 방법
“익절/손절 주문 발주에 실패했습니다. 포지션을 수동으로 확인해 주세요.”	진입은 체결되었지만 청산 보호를 발주할 수 없었습니다 — 포지션이 보호되지 않고 있을 수 있습니다.	지금 거래소에서 직접 익절/손절을 설정한 다음 봇을 확인하세요.
“DCA 체결 후 TP/SL 업데이트에 실패했습니다. 포지션을 수동으로 확인해 주세요.”	안전 주문 체결 후 청산 주문을 새 평균가로 업데이트할 수 없었습니다.	청산 레벨이 새로운 평균 진입가를 반영하는지 확인하세요.
“청산 주문(TP/SL)이 Freya Finance 외부에서 취소되었습니다. 포지션이 더 이상 보호되지 않습니다.”	청산 주문이 Freya 외부의 거래소에서 취소되었습니다.	포지션을 다시 보호하거나(TP/SL 설정) 종료하세요.

#일시적인 문제 (Freya가 재시도함)

표시되는 메시지	의미	조치 방법
“거래소 요청 한도에 도달했습니다. 자동으로 재시도합니다.”	요청이 너무 많아 잠시 제한되었습니다.	아무것도 하지 않아도 됩니다 — Freya가 알아서 재시도합니다.
“거래소 연결 시간이 초과되었습니다. 다시 시도해 주세요.”	요청이 제시간에 완료되지 않았습니다.	잠시 기다리세요. 보통 해결됩니다.
“네트워크 연결 오류입니다. 다시 시도해 주세요.”	거래소에 도달하는 과정에서 네트워크 수준의 오류가 발생했습니다.	잠시 후 다시 시도하세요.
“서버 시간 동기화 오류입니다. 일반적으로 자동으로 해결됩니다.”	거래소와의 시계/타임스탬프 편차입니다.	보통 자동으로 복구됩니다. 조치가 필요 없습니다.
“거래소 서버가 사용 중입니다. 잠시 후 다시 시도해 주세요.”	거래소가 사용 중/사용 불가 응답을 반환했습니다.	기다렸다가 다시 시도하세요. 사용자의 잘못이 아닙니다.

#그래도 해결되지 않나요?

“예기치 않은 거래소 오류가 발생했습니다. 포지션을 수동으로 확인해 주세요.” 또는 “내부 시스템 오류입니다. 다시 시도하거나 지원팀에 문의해 주세요.”가 표시되면 — 거래소에서 포지션을 확인하고, 문제가 지속되면 봇과 거래 세부 정보와 함께 [email protected]으로 문의하세요. 청산에 관해서는 청산 이해하기를 참조하세요.

#자주 묻는 질문

#봇에 오류가 표시되었습니다 — 플랫폼의 잘못인가요?

메시지에 따라 다릅니다. 잔액, 주문 크기, API 키, 레버리지/증거금 오류는 보통 직접 해결하는 설정 문제입니다. 취소 전용 모드, 요청 한도, 시간 초과, 상장 폐지된 거래쌍, “서버 사용 중”은 거래소 측 문제이며 사용자의 잘못이 아닙니다 — Freya가 일시적인 문제는 자동으로 재시도합니다.

#“포지션을 수동으로 확인해 주세요”는 무슨 의미인가요?

진입은 체결되었지만 Freya가 청산 보호를 발주하거나 업데이트할 수 없었다는 의미입니다. 따라서 포지션이 손절이나 익절 없이 운영되고 있을 수 있습니다. 거래소를 열어 포지션을 확인하고 즉시 직접 청산 레벨을 설정한 다음 — 봇을 확인하세요.

#“잔액 부족”이 떴는데 자금이 있습니다 — 왜 그런가요?

자금이 사용 가능한 상태가 아닐 수 있습니다(이미 다른 주문/포지션에 묶여 있음). 또는 잘못된 서브계정에 있거나, 수수료를 포함했을 때 주문에 필요한 금액에 미치지 못할 수 있습니다. 잔액을 확보하거나 봇의 주문 금액을 낮추세요. 봇이 일시정지되거나 중지된 이유는?를 참조하세요.

#거래쌍이 상장 폐지되었다고 나옵니다 — 이제 어떻게 하나요?

거래소가 해당 거래쌍을 제거했거나 이름을 변경했으므로 어떤 봇도 더 이상 거래할 수 없습니다. 봇을 현재 상장된 거래쌍으로 변경하세요. 이는 거래소의 변경 사항이며 Freya의 문제가 아닙니다.

#오류가 “요청 한도 / 시간 초과 / 서버 사용 중”이라고 합니다 — 뭔가 해야 하나요?

아니요. 이는 일시적인 거래소 측 상황이며 Freya가 자동으로 재시도합니다. 거래소가 복구된 후에도 봇이 오랫동안 멈춰 있다면 상태를 확인하고 필요한 경우 지원팀에 문의하세요.

#API 키나 청산 오류에 대한 자세한 도움말은 어디서 얻을 수 있나요?

API 키 / IP / 권한 오류는 거래소를 연결할 수 없나요?를 참조하세요. 종료되지 않는 포지션이나 남아 있는 주문은 거래가 종료되지 않아요를 참조하세요. 봇이 중지된 이유는 봇이 일시정지되거나 중지된 이유는?를 참조하세요.