Bybit를 Freya에 연결하기

Bybit는 Freya가 연결 설정을 대신해 줄 수 있는 유일한 거래소입니다. Freya는 등록된 Bybit 브로커이며, 이는 Bybit가 자신의 쪽에서 API 키를 생성하고 올바른 권한을 붙여 Freya에 직접 전달한다는 뜻입니다 — 사용자는 키를 볼 일도, 시크릿을 복사할 일도, IP 주소를 화이트리스트에 등록할 일도 없습니다.

이 방법을 빠른 연결이라고 부릅니다. Bybit에서 직접 키를 만드는 기존 방법도 여전히 존재하고 여전히 잘 작동합니다. 이 가이드는 두 방법 모두와 함께, 키를 교체해야 할 때나 연결이 실패했을 때 어떻게 해야 하는지도 다룹니다.

시작하기 전에

먼저 확인해 둘 것이 두 가지 있습니다.

연결할 계정에 자금을 넣어 두세요. 잔액이 비어 있으면 봇은 포지션을 열 수 없지만, Freya는 거래할 자금이 전혀 없는 키라도 아무 문제 없이 연결해 버립니다. 선물 봇을 운영할 계획이라면 봇이 사용할 계정에 자금이 있는지 확인하세요.

브라우저를 사용하세요. 두 방법 모두 데스크톱과 모바일 브라우저에서 작동합니다. API 키를 직접 만드는 작업은 Bybit 쪽에서는 브라우저 전용입니다 — Bybit 모바일 앱에는 API 키 화면이 없습니다.

빠른 연결

우리가 권장하는 방법입니다. Bybit에 이미 로그인되어 있다면 15초 정도면 끝납니다.

1. Freya에서 설정 → API 키를 열고 API 키 추가를 선택합니다.
2. 거래소로 Bybit를 선택합니다. 빠른 연결 탭이 이미 선택되어 있습니다.
3. Bybit로 연결을 선택합니다. Bybit 탭이 열립니다.
4. Bybit에 로그인합니다. 아직 계정이 없다면 그 자리에서 만들고 돌아오면 됩니다 — 연결은 기다려 줍니다.
5. 검토하고 승인합니다. Bybit는 Freya가 요청하는 내용을 정확히 보여줍니다. 무언가가 부여되는 단계는 승인뿐입니다.
6. 탭이 저절로 닫히고 키가 Freya에 나타나며, 바로 사용할 수 있습니다.

한 번의 승인으로 현물과 선물 모두가 처리됩니다. 시장마다 반복할 필요가 없습니다.

그 이면에서 일어나는 일

승인하면 Bybit는 Freya의 브로커 등록에 연결된 API 키를 생성해 Freya의 서버로 곧장 전송합니다. 이렇게 도착하기 때문에 키는 사용자의 브라우저, 클립보드, 스크린샷을 거치지 않습니다 — API 키가 가장 자주 유출되는 경로가 바로 그곳입니다.

Bybit는 또한 그 키를 Freya의 서버에 직접 바인딩합니다. 그 덕분에 얻는 두 가지 이점:

• IP 화이트리스트가 필요 없습니다. Bybit 설정에 복사하거나 붙여넣을 것이 아무것도 없습니다.
• 키가 만료되지 않습니다. 직접 만든 키는 만료될 수 있지만, 브로커에 바인딩된 키는 그렇지 않습니다.

마음이 바뀌었다면

Bybit 화면에서 거부하는 것은 전적으로 안전합니다. Bybit에 아무것도 생성되지 않고 Freya에서도 아무것도 바뀌지 않습니다 — 승인이 완료되지 않았다는 표시만 보게 되며, 언제든 원할 때 다시 시도할 수 있습니다.

결정하지 않은 채 Bybit 탭을 닫아도 효과는 같습니다.

Bybit 키 교체하기

새 키가 필요할 때가 있습니다 — Bybit에서 기존 키를 폐기했거나, 다른 Bybit 계정으로 옮기거나, 지원팀이 재연결을 요청한 경우입니다.

빠른 연결이라면 그냥 다시 연결하면 됩니다. 설정 → API 키 → API 키 추가를 열고 Bybit를 선택한 뒤, 이전처럼 Bybit로 연결을 선택하세요. Bybit는 계정당·플랫폼당 하나의 키를 발급하므로, 재연결은 두 번째 사본을 쌓는 대신 이미 있는 키를 갱신합니다. 기존 봇들은 갱신된 자격 증명으로 계속 돌아갑니다.

이는 같은 Bybit 계정에 해당합니다. Freya는 기존 연결 위에 다른 Bybit 계정을 연결하지 않습니다. 계정을 바꾸려면 그 연결을 사용하는 봇을 중지하고, Freya에서 Bybit Spot과 Bybit Futures 키를 삭제한 뒤, 새 계정으로 연결하고 봇에 새 키를 선택하세요.

Bybit 쪽에서 키를 먼저 삭제했더라도, 재연결이 해결책입니다 — 승인하면 Bybit가 새 키를 발급합니다.

⚠️ 봇이 실행 중일 때는 Freya 키를 삭제하지 마세요 — 봇을 멈출 생각이 아니라면요. 유효한 자격 증명이 없는 실행 중인 봇은 이미 열어 둔 포지션을 관리할 수 없습니다. 먼저 봇을 중지하거나 종료한 뒤 다시 연결하세요.

수동 연결

키를 직접 만들고 싶거나 Bybit 서브 계정을 연결하는 경우 이 방법을 사용하세요.

Bybit에서 키 생성하기

1. 브라우저에서 Bybit에 로그인해 계정의 API 메뉴를 엽니다.
2. System-generated API Key(시스템 생성 API 키)를 생성합니다.
3. 사용 유형으로 API Transaction을 선택합니다 — 읽기 전용이 아닙니다.
4. Contract Trade와 Spot Trade 권한을 부여하고, 읽기 액세스도 함께 부여합니다.
5. 출금 권한은 절대 부여하지 마세요. Freya는 필요로 하지 않으며 사용할 수도 없습니다.
6. 키를 IP로 제한하고 Freya의 주소를 입력하세요. 주소는 모달에 표시되며 복사할 수 있습니다.

⚠️ Bybit는 시크릿 키를 딱 한 번만 보여줍니다. 그 화면을 닫기 전에 복사하세요. 잃어버리면 키를 복구할 수 없습니다 — 새로 만드는 수밖에 없습니다.

Freya에 키 추가하기

1. Freya에서 설정 → API 키 → API 키 추가를 열고 Bybit를 선택합니다.
2. 수동 연결 탭으로 전환합니다.
3. API 키와 시크릿을 붙여넣고, 나중에 알아볼 수 있는 이름을 지정합니다.
4. API 키 추가를 선택합니다. Freya가 연결과 권한을 즉시 검증합니다.

검증에 실패하면 Freya는 막연한 오류 대신 정확히 어느 부분이 실패했는지 알려줍니다. 각 메시지와 해결책은 거래소 API 키 연결 오류 해결하기를 참조하세요.

자주 묻는 질문

어떤 방법을 써야 하나요?

특별한 이유가 없다면 빠른 연결입니다. 단계가 더 적고, 오타로 잘못될 일이 없으며, IP 화이트리스트가 완전히 사라집니다. 수동 연결은 키를 직접 만들고 통제하고 싶은 사람과 서브 계정을 위해 존재합니다.

빠른 연결은 수동 키보다 Freya에 더 많은 액세스를 주나요?

아니요. 두 방법 모두 동일한 범위의 거래 키를 만듭니다: 읽기와 거래뿐, 출금은 절대 아닙니다. 차이는 누가 설정하느냐이지, 키가 무엇을 할 수 있느냐가 아닙니다.

IP 주소를 화이트리스트에 등록해야 하나요?

수동 연결일 때만 그렇습니다. 빠른 연결에서는 Bybit가 키를 Freya의 서버에 자동으로 바인딩하며, 그 키가 만료되지 않는 것도 같은 이유입니다.

Bybit 현물과 선물을 따로 연결할 수 있나요?

빠른 연결이라면 그럴 필요가 없습니다 — 한 번의 승인으로 둘 다 설정됩니다. 수동 연결이라면 시장을 분리해 관리하고 싶을 때 별도의 키를 추가할 수 있습니다.

두 번 연결하면 어떻게 되나요?

아무것도 망가지지 않고 아무것도 중복되지 않습니다. Bybit는 계정당·플랫폼당 하나의 키를 발급하므로, 두 번째 연결은 기존 키를 갱신합니다.

Bybit 서브 계정에 빠른 연결을 쓸 수 있나요?

서브 계정에는 수동 연결을 사용하세요. 빠른 연결은 메인 Bybit 계정을 위한 것입니다.

Freya에 들어간 키는 안전한가요?

도착하는 순간 암호화되며 다시는 표시되지 않습니다 — 사용자에게도, 지원팀에게도요. Freya에서 삭제하면 저장된 자격 증명이 제거되고, Bybit에서 폐기하면 반대쪽에서 액세스가 차단됩니다. 전체 그림은 Freya Finance에서 내 자금은 안전한가요?를 참조하세요.

연결 직후에 Freya가 키가 유효하지 않다고 합니다. 왜죠?

가장 흔한 원인은 거래 권한 없이 생성된 키이거나, Freya의 것이 아닌 IP로 제한된 키입니다. 빠른 연결에서는 둘 다 일어날 수 없으므로, 그 방법으로 다시 연결하는 것이 대개 가장 빠른 해결책입니다.

관련 읽을거리

• Bybit 빠른 연결: 원클릭 설정 완벽 설명
• Freya Finance에 거래소를 연결하는 방법 — Binance와 OKX까지 아우르는 종합 가이드
• 거래소 API 키 연결 오류 해결하기
• 거래소 API 보안 및 리스크 완화