봇이 일시 정지되거나 멈춘 이유는 무엇인가요?

#봇이 일시 정지되거나 멈춘 이유는 무엇인가요?

봇이 기대한 대로 움직이지 않는다면, 원인은 거의 항상 해결 가능한 몇 가지 중 하나입니다 — 대개 자금이나 API 권한처럼 거래소 쪽 문제입니다. 이 가이드에서는 가장 흔한 원인부터 순서대로 하나씩 살펴봅니다.

거래를 열지 않는 봇과는 다른 이야기입니다. 봇이 정상적으로 가동 중인데 아직 포지션에 진입하지 않았다면, 그건 대개 진입 조건 문제입니다 — 봇이 왜 거래하지 않나요?를 참고하세요. 이 글은 일시 정지되거나, 멈추거나, 오류가 난 봇에 관한 것입니다.

---

#봇 상태 한눈에 보기

• 활성 — 가동 중이며 진입 조건을 찾아 시장을 관찰하고 있습니다. 아직 열린 포지션은 없습니다.
• 트리거 중 — 진입 조건이 충족되어 봇이 포지션을 여는 중입니다.
• 실행 중 — 포지션이 열려 있고 봇이 거래를 관리하는 중입니다(안전 주문, 익절, 청산).
• 일시 정지 — 사용자가 일시 정지한 상태입니다. 재개하기 전까지 새 포지션을 열지 않습니다.
• 일시 정지 대기 — 포지션이 열려 있는 상태에서 일시 정지한 경우입니다. 해당 포지션을 안전하게 마무리한 뒤 일시 정지 상태가 됩니다.
• 오류 — 봇이 실행을 시도했지만 거래소나 검증 과정에서 거부된 상태입니다. 봇은 멈추고 문제를 표시합니다.
• 종료 중 / 종료됨 — 봇이 거래를 마무리하는 중이며, 완료되면 해당 거래가 내역에 저장됩니다.

(활성과 실행 중의 차이를 포함한 전체 상태 설명은 봇이 왜 거래하지 않나요?를 참고하세요.)

봇이 스스로 복구할 수 없는 문제를 만나면 오류 상태로 전환되고, "봇 실패" 알림을 받게 됩니다(알림을 설정해 두었다면). 덕분에 문제를 빠르게 해결할 수 있습니다.

#가장 흔한 원인: 잔액 또는 증거금 부족

봇이 주문을 넣지 못하는 가장 빈번한 이유는 거래소 계정의 잔액 부족(현물) 또는 증거금 부족(선물)입니다. 봇이 주문 — 기본 주문, 평균화 주문, 또는 익절 주문 — 을 넣으려 했지만 자금이 없어 거래소가 거절한 것입니다.

해결: 거래소 계정에 봇의 전체 계획을 감당할 만큼 충분한 여유 잔액/증거금이 있는지 확인하세요 — 그리드에 포함된 모든 평균화 주문까지 포함해서입니다. (그래서 그리드 전체에 자금을 대는 것이 중요합니다. 진입 주문과 그리드를 참고하세요.)

#API 키 문제

Freya가 더 이상 사용자를 대신해 실행할 수 없게 되면 봇은 멈춥니다. 흔한 API 키 원인은 다음과 같습니다.

• 유효하지 않거나, 폐기되었거나, 재발급된 키 — 거래소에서 키를 삭제했거나 교체했다면 Freya가 보관 중인 키는 더 이상 작동하지 않습니다.
• 잘못된 권한 — 키에는 읽기와 거래 권한이 필요합니다(출금 권한은 절대 안 됩니다). 읽기 전용 키로는 주문을 넣을 수 없습니다.
• IP 화이트리스트 차단 — 키를 특정 IP로 제한했다면 Freya의 서버 IP가 허용되어 있어야 합니다(거래소를 연결할 때 표시됩니다).

해결: 읽기·거래 권한을 가진 새 키로 다시 연결하세요. 거래소 연결 방법과 API 키 관리하기를 참고하세요.

#주문 금액이 너무 작음

모든 거래소에는 최소 주문 금액(최소 명목 가치)이 있습니다. 주문 금액 — 또는 개별 그리드 주문 — 이 그 아래로 떨어지면 거래소가 주문을 거절합니다.

해결: 각 주문이 거래소의 최소 기준을 넘도록 거래 금액(또는 주문당 물량)을 늘리세요.

#선물 전용: 레버리지와 포지션 모드

선물에서는 두 가지 설정이 주문을 막을 수 있습니다.

• 레버리지가 너무 높음 — 설정한 레버리지가 해당 거래쌍에 대해 거래소가 허용하는 범위를 초과한 경우입니다. 허용되는 수준으로 낮추세요.
• 포지션 모드 불일치 — 거래소 계정의 포지션 모드(헤지 vs 원웨이)가 봇이 기대하는 모드와 다른 경우입니다. 거래소의 포지션 모드를 봇의 거래 방식에 맞추세요.

#일시적인 거래소 문제

일부 오류는 사용자 잘못이 아니며 대개 저절로 해소됩니다.

• 요청 한도 — 짧은 시간에 너무 많은 요청이 발생한 경우입니다.
• 타임아웃 / 네트워크 오류 — 거래소와의 일시적인 연결 문제입니다.
• 타임스탬프 오류 — 시스템과 거래소 간 시각 동기화 문제입니다.
• 거래소 과부하 / 점검 — 거래소 자체가 과부하 상태이거나 다운된 경우입니다.

해결: 이런 문제는 보통 스스로 해결됩니다. 이 중 하나로 봇에 오류가 났다면, 거래소가 정상적으로 응답하기 시작한 뒤 대개 봇을 재개할 수 있습니다.

#무엇을 해야 하나: 간단 체크리스트

1. 거래소 잔액/증거금 확인 — 1순위 원인입니다. 부족하면 충전하세요.
2. API 키 확인 — 여전히 유효한지, 읽기·거래 권한이 있는지, Freya의 IP가 허용되어 있는지 확인하세요.
3. 주문 금액 확인 — 거래소 최소 기준을 넘는지 확인하세요.
4. 선물이라면, 레버리지가 허용 범위 내인지, 포지션 모드가 일치하는지 확인하세요.
5. 일시적인 오류였다면, 거래소가 복구될 때까지 기다렸다가 봇을 재개하세요.
6. 그래도 해결되지 않나요? [email protected]으로 문의하세요.

#자주 묻는 질문

#봇이 왜 일시 정지되거나 멈췄나요?

대부분 거래소가 주문을 거절했기 때문입니다 — 보통 잔액이나 증거금 부족, API 키 문제, 또는 거래소 최소 금액에 못 미치는 주문이 원인입니다. 선물에서는 레버리지나 포지션 모드 설정도 주문을 막을 수 있습니다. 일시적인 거래소 문제(요청 한도, 타임아웃)로 봇이 멈출 수도 있지만, 이런 문제는 대개 저절로 해소됩니다.

#봇이 오류 상태라는 건 무슨 뜻인가요?

봇이 실행을 시도했지만 무언가가 그 동작을 거부해서, 무작정 계속하는 대신 멈추고 문제를 표시했다는 뜻입니다. 알림을 켜 두었다면 "봇 실패" 알림을 받게 됩니다. 근본 원인 — 대개 잔액이나 API 키 — 을 해결하면 다시 가동할 수 있습니다.

#봇에 잔액 부족이라고 나옵니다 — 어떻게 해야 하나요?

거래소 계정에 자금을 추가해서, 평균화 주문 그리드를 포함한 봇의 주문을 감당할 만큼 여유 잔액(현물) 또는 증거금(선물)을 확보하세요. 거래소에 자금이 없어서 봇이 주문을 넣지 못한 것입니다.

#API 키가 문제일 수도 있나요?

네 — 흔한 원인입니다. 키를 삭제했거나, 재발급했거나, 읽기 전용으로 설정했다면, 또는 IP 제한이 걸려 있는데 Freya의 서버 IP가 허용되어 있지 않다면 봇은 거래할 수 없습니다. 읽기와 거래 권한(출금 권한은 절대 안 됩니다)을 가진 새 키로 다시 연결하세요.

#선물 봇이 주문을 넣지 않습니다 — 레버리지나 포지션 모드 문제일까요?

네. 레버리지가 해당 거래쌍에 대해 거래소가 허용하는 것보다 높거나, 계정의 포지션 모드(헤지 vs 원웨이)가 봇의 거래 방식과 맞지 않으면 주문이 거절됩니다. 레버리지를 허용되는 수준으로 낮추고 거래소의 포지션 모드를 맞추세요.

#봇에 문제가 생기면 알림을 받나요?

네 — 알림을 설정해 두었다면, 봇이 오류 상태에 들어갈 때 Freya가 "봇 실패" 알림을 보내므로 빠르게 대응할 수 있습니다. 알림 설정 방법을 참고하세요.

#봇이 가동 중인데 거래를 하나도 열지 않았습니다 — 같은 문제인가요?

아닙니다. 가동 중인 봇이 아직 포지션에 진입하지 않았다면 대개 진입 조건이 아직 충족되지 않은 것뿐입니다 — 이 내용은 봇이 왜 거래하지 않나요?에서 다룹니다. 이 글은 일시 정지되거나, 멈추거나, 오류가 난 봇에 관한 것입니다.