Freya Finance에서 거래소 API 키를 관리하는 방법

#Freya Finance에서 거래소 API 키를 관리하는 방법

API 키는 Freya가 회원님을 대신해 거래소에서 주문을 넣을 수 있게 해주는 열쇠입니다. 거래소를 한 번 연결하고 나면 모든 키가 한곳에 모여 있어, 키를 확인하고 각 키에 정확히 어떤 권한이 있는지 살펴보고, 키를 더 추가하거나 더 이상 쓰지 않는 키를 삭제할 수 있습니다. 이 가이드는 그 관리 방법을 다룹니다.

거래소를 처음 연결하시는 경우에는 거래소를 연결하는 방법부터 시작하세요 — 이 글은 이미 추가한 키를 관리하는 방법에 관한 내용입니다.

---

#단계 빠르게 훑어보기

1. 키 목록 열기 — 설정 → API 키로 이동하면 연결된 모든 거래소가 라벨, 추가된 날짜, 상태와 함께 표시됩니다.
2. 각 키의 권한 확인 — 읽기와 거래(선물을 거래한다면 선물까지)가 표시되는지, 그리고 출금 액세스는 없는지 확인하세요.
3. 필요할 때 키 추가 — API 키 추가를 사용해 다른 거래소나 추가 키를 연결하세요. 첫 연결과 동일한 흐름입니다.
4. 더 이상 쓰지 않는 키 삭제 — 삭제를 선택하고 확인합니다. 그 키를 아직 사용하는 봇이 있으면 Freya가 삭제를 거부하고 몇 개인지 알려줍니다. 먼저 중지하거나 일시정지하세요.

#API 키는 어디에서 찾나요

설정 → API 키로 이동하세요. 내 API 키 — 계정에 연결된 모든 거래소 연결 목록이 표시됩니다. 각 항목에 대해 Freya는 다음을 보여줍니다.

• 거래소 (Binance, OKX, Bybit).
• 키의 라벨 — 여러 개를 구분할 수 있습니다.
• 추가된 날짜.
• 상태 (활성).

아직 아무것도 연결하지 않았다면 대신 첫 번째 API 키 추가 안내가 표시됩니다.

#키 권한 이해하기

각 키는 생성될 때 부여된 권한을 표시하므로, 그 키가 무엇을 할 수 있는지 의심할 여지가 없습니다.

• 읽기 — Freya가 잔액과 포지션을 볼 수 있게 합니다(모든 기능에 필요).
• 거래 — Freya가 주문을 넣고 관리할 수 있게 합니다(봇이 거래할 때 사용하는 권한입니다).
• 선물 — 키에 선물 거래 액세스도 활성화되어 있을 때 표시됩니다.

이 투명성이 중요합니다. Freya 키는 읽기와 거래 전용입니다. 출금 권한을 갖지 않으며 가져서도 안 됩니다. 따라서 회원님의 자금이 Freya를 통해 거래소를 빠져나가는 일은 없습니다. 전체적인 그림은 Freya Finance에서 내 자금은 안전한가요?를 참조하세요.

#키 추가하기

같은 화면에서 API 키 추가를 사용해 여러 거래소(또는 여러 개의 키)를 연결할 수 있습니다. 설정 과정은 첫 연결과 동일한 흐름입니다 — OKX 패스프레이즈를 포함한 단계별 안내는 거래소를 연결하는 방법을 참조하세요.

#키 삭제하기

연결을 제거하려면 해당 키에서 삭제를 선택하고 확인하세요. 알아두어야 할 몇 가지가 있습니다.

• 되돌릴 수 없습니다. 다시 연결하려면 키를 처음부터 다시 추가해야 합니다.
• Freya가 삭제 전에 확인합니다. 그 키로 실행 중인 봇이 있거나 거래를 기다리며 대기 중인 봇이 있으면 삭제가 거부되고 관련 봇 수를 알려줍니다. 대시보드에서 중지하거나 일시정지한 뒤 다시 시도하세요 — 거래 도중 키를 잃은 봇은 이미 연 포지션을 더 이상 관리할 수 없습니다.
• 알림을 받습니다. 키가 삭제되면 알림이 전송됩니다 — 액세스 변경 사항을 항상 알 수 있도록 하는 보안 장치입니다.

#키는 안전하게 보관됩니다

Freya는 API 자격 증명을 암호화하여 보관합니다 — API 키 화면에도 안전하게 보관됨으로 표시됩니다. 출금 권한이 없는 키와 결합되면, 최악의 경우에도 그 누구도 Freya를 통해 회원님의 거래소 계정에서 자금을 옮길 수 없다는 뜻입니다.

#자주 묻는 질문

#거래소 API 키는 어디에서 관리하나요?

설정 → API 키에서 관리합니다. 이 화면에는 연결된 모든 키가 거래소, 라벨, 추가된 날짜, 상태와 함께 나열되며, 새 키를 추가하거나 기존 키를 삭제하는 곳도 바로 여기입니다.

#읽기, 거래, 선물 라벨은 무슨 의미인가요?

각 키에 허용된 작업을 보여줍니다. 읽기는 Freya가 잔액과 포지션을 볼 수 있게 하고, 거래는 주문을 넣고 관리할 수 있게 하며(봇이 사용하는 권한), 선물은 키에 선물 거래 액세스도 있을 때 나타납니다. Freya 키는 출금 권한을 필요로 하지 않습니다.

#다른 거래소나 키를 추가하려면 어떻게 하나요?

같은 화면에서 API 키 추가를 사용하세요. 첫 번째 키와 동일한 연결 흐름으로 진행됩니다 — OKX의 추가 패스프레이즈를 포함한 전체 과정은 거래소를 연결하는 방법 가이드를 참조하세요.

#API 키를 삭제하면 어떻게 되나요?

Freya가 아직 의존하는 것이 있는지 먼저 확인합니다. 그 키로 실행 중이거나 시그널을 기다리는 봇이 있으면 삭제가 거부되고 관련 봇 수가 표시됩니다 — 중지하거나 일시정지한 뒤 삭제하세요. 키에 의존하는 것이 없어지면 연결이 제거되며 되돌릴 수 없습니다. 키가 제거되었음을 확인하는 알림도 받게 됩니다.

#내 API 키는 안전하게 보관되나요?

네. 자격 증명은 암호화되어 보관되며, 연결하는 키에는 거래 액세스만 있고 출금 권한은 없습니다. 이 조합은 Freya를 통해 회원님의 거래소에서 자금이 출금될 수 없다는 뜻입니다.

#Freya가 내 API 키로 자금을 출금할 수 있나요?

아니요. 키는 읽기와 거래 액세스만으로 생성되며 출금 액세스는 포함되지 않습니다. 설령 무언가 잘못되더라도 Freya 키로는 그 누구도 거래소에서 자금을 옮길 수 없습니다.

#API 키의 권한을 수정하거나, 교체하거나, 비활성화하려면 어떻게 하나요?

연결된 키를 그 자리에서 편집하는 기능은 없습니다. 권한 변경, 키 교체나 갱신은 Freya에서 삭제하고 새 키를 추가하는 방식입니다 — 거래소에서 새 키를 만든 뒤 다시 연결하세요. Freya는 사용 중인 키를 제거하지 않으므로 먼저 이전 키를 쓰는 봇을 중지하거나 일시정지하세요. 새 키를 연결한 뒤 그 봇들을 새 키로 지정하고 다시 시작하면 됩니다. 키를 삭제하지 않고 사용만 멈추려면, 키를 지우는 대신 그 키에 의존하는 봇을 일시정지하세요.