봇이 무언가를 수행할 수 없을 때 짧은 메시지를 보여주지만, 그에 대해 무엇을 해야 할지가 항상 분명하지는 않습니다. 이 문서는 빠른 조회용입니다. 본 메시지를 찾아 그 의미를 이해하고, 직접 해결해야 할 문제인지 아니면 거래소가 스스로 해결하는 문제인지 파악하세요. 더 깊이 알아보려면 각 그룹에서 전용 문제 해결 가이드로 연결됩니다.
핵심 요약
- 대부분의 오류는 몇 가지 범주로 나뉩니다: 잔액/증거금, API 키, 레버리지/증거금 모드, 주문 한도, 상장 폐지된 거래쌍, 청산 주문 발주, 그리고 일시적인 거래소 문제입니다.
- 많은 메시지는 거래소 측 문제이며 사용자의 잘못이 아닙니다(취소 전용 모드, 요청 한도, 시간 초과) — Freya가 이를 자동으로 재시도합니다.
- 직접 해결해야 하는 것은 보통 잔액, 주문 크기, API 권한, 또는 레버리지/증거금 설정입니다.
- 메시지에 “포지션을 수동으로 확인해 주세요”라고 표시되면 포지션이 보호되지 않고 있을 수 있습니다 — 거래소에서 즉시 익절/손절을 설정하세요.
- 지속되거나 알 수 없는 오류가 발생하면 → 봇과 거래 세부 정보와 함께 [email protected]으로 문의하세요.
잔액 및 증거금
| 표시되는 메시지 | 의미 | 조치 방법 |
|---|---|---|
| “잔액이 부족합니다. 계정 자금을 확인해 주세요.” | 이 주문을 위한 거래소의 사용 가능 자금이 부족합니다. | 거래소에 자금을 추가하거나 봇의 주문 금액을 낮추세요. |
| “증거금이 부족합니다. 포지션 크기를 줄이거나 증거금을 추가해 주세요.” | 선물: 이 레버리지에서 포지션에 필요한 증거금이 부족합니다. | 증거금을 추가하거나, 포지션 크기를 낮추거나, 레버리지를 조정하세요. |
| “주문 금액이 너무 작습니다. 봇 거래 금액을 늘려 주세요.” | 거래쌍의 최소 주문 크기 미만입니다. | 봇 금액을 거래쌍의 최소값 이상으로 늘리세요. |
➡️ 심층 가이드: 봇이 일시정지되거나 중지된 이유는? 및 봇에 필요한 자본은 얼마인가.
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 / 권한 오류는 거래소를 연결할 수 없나요?를 참조하세요. 종료되지 않는 포지션이나 남아 있는 주문은 거래가 종료되지 않아요를 참조하세요. 봇이 중지된 이유는 봇이 일시정지되거나 중지된 이유는?를 참조하세요.