> For the complete documentation index, see [llms.txt](https://docs.mojo.trade/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mojo.trade/ko/closed-beta-guide/binance.md).

# Binance 계정 연결

에이전트가 자신의 Binance 계정에서 거래하도록 할 수 있습니다. 자금은 Mojo로 이동하지 않습니다. 자금은 Binance에 그대로 남고, Mojo는 그곳에서 주문을 넣을 권한만 받으며 출금 권한은 없습니다.

연결에는 약 10분이 걸리며, 대부분은 Binance 웹사이트에서 진행합니다. 순서대로 따라 하세요. 그중 두 단계는 되돌릴 수 없는 실수를 하기 쉽습니다.

***

### 시작하기 전에

다음이 필요합니다:

* 한 **Binance** binance.com의 계정과 신원 인증 및 2단계 인증 완료가 필요합니다. Binance는 API 키를 만들기 전에 이 두 가지를 요구합니다.
* **Portfolio Margin Mode** 가 그 계정에서 켜져 있어야 합니다. 이것이 1단계입니다. Mojo는 Classic 모드인 계정에는 연결할 수 없습니다.

> ⚠️ **API 키를 만들기 전에 Portfolio Margin Mode를 켜세요.** 이 기능을 켜면 Binance는 계정에 이미 있는 모든 API 키에서 선물 권한을 영구적으로 제거하며, 복구할 수 없습니다. 이전에 만든 키는 Mojo에서 작동하지 않으므로 새 키를 만들어야 합니다.

Mojo에서 시작하는 위치:

* **Settings** → **Exchange accounts**, 그런 다음 **Connect** 옆의 Binance
* 해당 **Add now** 배너가 있는 **Assets** 페이지나 **Add Binance account** 보유 자산 위의 버튼을 누르세요.
* 연결하기 전에 에이전트에게 Binance에서 무언가를 하라고 요청하면, 채팅에 **Connect Binance to continue** 카드가 표시됩니다.

이 모든 항목은 같은 연결 화면을 엽니다. 여기에 이 가이드의 요약과 Mojo의 IP 주소가 포함되어 있으니, Binance 설정을 진행하는 동안 이 화면을 열어 두세요.

***

### 1단계 — Portfolio Margin Mode로 전환

Binance에서 **Futures** 거래 페이지를 열고 **Switch** 옆의 **Account** (또는 **Settings** → **Account Mode**). 선택한 다음 **Portfolio Margin Mode**약관을 검토하고 확인하세요.

Binance는 계정이 깨끗한 상태일 때만 전환을 허용합니다:

* 사용자의 **Cross Margin** 계정이 활성화되어 있으며 대출, 미체결 주문, 미체결 포지션 또는 마이너스 잔고가 없습니다.
* 사용자의 **USDⓈ-M Futures** 계정에 미체결 주문, 미체결 포지션 또는 마이너스 잔고가 없고, 또한 **사용하지** 않습니다 **Isolated Margin** 또는 **Multi-Assets Mode**.
* 사용자의 **COIN-M Futures** 계정에 미체결 주문, 미체결 포지션 또는 마이너스 잔고가 없고, Isolated Margin을 사용하지 않습니다.

Multi-Assets Mode는 많은 분이 놓치는 항목입니다. Portfolio Margin처럼 들리지만 실제로는 전환을 막는 별도의 선물 설정이므로, 먼저 꺼야 합니다.

다음 **Switch** 옵션이 보이지 않으면 아직 계정이 대상이 아닙니다. 적격 여부는 Binance가 결정하며 Mojo가 우회할 방법은 없습니다. Binance는 계정 모드 전환도 24시간에 10회로 제한하므로, 앞뒤로 자주 전환하지 마세요.

Binance 가이드: [Binance에서 Portfolio Margin Mode를 활성화하는 방법](https://www.binance.com/en/support/faq/how-to-activate-the-portfolio-margin-mode-on-binance-7ee6b3f65d5a421491c0a5588223fd14)

***

### 2단계 — API 키 만들기

Binance에서 프로필 메뉴 → **Account** → **API Management**을 연 다음 **Create API**.

* 를 선택하세요. **System-generated** 를 키 유형으로 선택하세요. Self-generated 키는 지원되지 않습니다.
* 예를 들어 `Mojo`로 키에 레이블을 지정하고 2단계 인증을 완료하세요.

Binance 가이드: [Binance에서 API 키를 만드는 방법](https://www.binance.com/en/support/faq/360002502072) · 키: [API Management](https://www.binance.com/en/my/settings/api-management)

***

### 3단계 — Mojo의 IP를 신뢰할 수 있는 IP로 추가

권한을 건드리기 **전에** 이 작업을 하세요. Binance에서는 IP 제한이 없는 키는 읽기 전용이며, 거래 옵션은 켜지지 않습니다.

1. Mojo의 연결 화면에서 가이드 아래에 표시된 IP 주소를 복사하세요. 둘 이상이 나열되면 복사 버튼은 모두 복사합니다.
2. Binance의 **API Management**API Management
3. IP access 아래에서 **Restrict access to trusted IPs only (Recommended)**를 선택하고 주소를 붙여넣은 다음 확인하세요.
4. 저장한 다음 Binance가 요청하면 2단계 인증을 완료하세요.

설정이 실제로 *trusted IPs only*로 저장되었는지 확인하세요. 키가 여전히 제한되지 않은 상태이면 다음 단계가 작동하지 않고 Mojo의 검사가 실패합니다.

추가 이점으로, Binance는 IP 제한이 있는 키의 만료를 설정하지 않으므로, 한 번만 설정하면 됩니다.

***

### 4단계 — 권한을 설정하고 저장한 다음 Mojo에 키를 입력

키를 계속 편집한 상태에서 다음을 켜세요:

* **Enable Reading** — 보통은 이미 켜져 있음
* **Enable Portfolio Margin Trading** — 에이전트가 선물에 사용하는 항목
* **Enable Spot & Margin Trading** — 에이전트가 현물에 사용하는 항목입니다. Binance에서는 Enable Spot & Margin & Stock Trading으로 표시될 수 있으며, 어느 쪽이든 하나의 체크박스이고 분리할 수 없습니다. Mojo는 사용자가 승인한 주문만 넣습니다.
* **Permits Universal Transfer** — 에이전트가 마진이 필요할 때처럼, Mojo가 사용자의 Binance 계정 안의 지갑들(Spot Wallet, Funding, Portfolio Margin) 사이에서 자금을 이동할 수 있게 합니다.

다음 항목은 **끄세요**:

* **Enable Withdrawals** — Mojo는 출금 권한이 있는 키를 받지 않습니다
* **Enable Internal Transfer** — 이것도 거부됩니다

Enable Futures 옵션은 찾을 수 없습니다. Portfolio Margin Mode에서는 존재하지 않습니다. 필요한 것은 Enable Portfolio Margin Trading입니다.

키를 저장하세요. 그런 다음 **API Key** 와 **Secret Key** 를 Mojo의 연결 화면에 복사해 넣고 **Connect exchange**.

> 🔒 **Binance는 Secret을 한 번만 보여줍니다.** 그 페이지를 떠나기 전에 복사하세요. 잃어버리면 Binance에서 키를 삭제하고 새 키를 만드세요.

Mojo는 Binance와 함께 키를 검사합니다. 작동하는지, 계정이 Portfolio Margin Mode인지, 그리고 권한과 IP 제한이 위와 같이 설정되어 있는지를 확인합니다. 이 과정은 몇 초 걸립니다. 통과하면 **Binance account added**가 표시되고, Binance가 **Assets** 페이지에 나타납니다.

통과하지 못하면 Mojo가 **수정 방법**아래에 수정할 내용을 알려줍니다. 대부분의 수정은 Binance에서 체크박스 하나만 바꾸면 됩니다. 그런 다음 **Back** (입력 내용은 유지됩니다), 수정한 뒤 다시 연결하세요. 아래의 문제 해결을 보세요. [문제 해결](#troubleshooting) 아래를 보세요.

***

### 연결이 허용하는 것과 허용하지 않는 것

연결이 완료되면 에이전트는 다음을 할 수 있습니다:

* Spot Wallet에서 현물 매수 및 매도
* Binance의 지정가 이익실현 및 손절 주문을 사용해 USDⓈ-M 및 COIN-M 무기한 포지션을 열고, 관리하고, 종료
* 플랜에 필요할 때 Spot Wallet, Funding 지갑, Portfolio Margin 계정 사이에서 자금을 이동

하지만 출금하거나, 다른 계정이나 거래소로 자금을 보내거나, 승인하지 않은 작업을 할 수는 없고, Mojo에도 그 권한이 없습니다. 모든 플랜은 여전히 사용자가 확인하는 카드로 진행됩니다.

연결 후에는 Mojo가 최근 Binance 거래 내역도 읽어 에이전트가 실제 거래 방식에 맞게 시작할 수 있습니다. 아래 자주 묻는 질문을 보세요.

***

### 연결 관리

연결은 **Settings** → **Exchange accounts** 아래에 있습니다(웹에서는 Settings 대화상자의 탭입니다).

**문제가 생기면**, Mojo가 Assets 페이지에 알림을 표시합니다. 예를 들어 키가 작동을 멈췄거나, 권한이 빠졌거나, Mojo의 IP 주소가 바뀌었다는 내용입니다. 탭하면 연결 화면이 다시 열립니다:

* Binance에서 수정하셨나요? 그냥 **Check again을 탭하세요.**.
* 새 키가 필요하신가요? 새 키와 Secret을 붙여넣고 연결하세요. 새 키는 같은 Binance 계정에 속해야 하며, 에이전트는 중단 없이 계속 동작합니다.

키가 작동하지 않는 동안에는 Binance를 사용하는 에이전트가 자동으로 일시 중지되며, 검사가 통과하면 다시 재개됩니다.

**연결을 해제하려면**To disconnect **Disconnect** (앱) 또는 **Unlink** (웹)에서 계정 옆의 항목을 사용하세요. Mojo는 Binance를 사용하는 에이전트를 중지하고 키를 잊어버립니다. 하지만 Binance에서 **사용하지** 주문을 취소하거나 포지션을 종료하지는 않습니다. 거래소에 이미 있는 내용은 여전히 사용자가 그곳에서 관리해야 합니다. 연결 해제는 최종적이며, 나중에 다시 연결해도 중지된 에이전트는 다시 시작되지 않습니다.

연결 해제 후에는 Binance의 [API Management](https://www.binance.com/en/my/settings/api-management) 페이지에서 키를 삭제하세요. Mojo는 대신 삭제할 수 없습니다.

***

### 문제 해결

연결 시도가 실패하면 Mojo가 다음 중 하나를 표시합니다. 모든 수정은 Binance에서 진행한 뒤 **Check again을 탭하세요.** Mojo에서

| Mojo가 말하는 내용                                    | 무슨 일이 일어나고 있는지                                            | 조치 방법                                                                             |
| ----------------------------------------------- | --------------------------------------------------------- | --------------------------------------------------------------------------------- |
| *API 키와 Secret 전체를 복사하세요…*                      | 어딘가 잘렸거나, 중간에 공백이 들어갔습니다.                                 | 둘 다 다시 붙여넣고 완료하세요.                                                                |
| *키나 Secret 중 하나가 잘못 복사되었거나, IP 목록이 없습니다…*       | 키나 Secret이 잘못되었거나, 키의 IP 제한에 Mojo의 주소가 포함되어 있지 않습니다(3단계). | 신뢰할 수 있는 IP를 먼저 확인하세요. 가장 흔한 원인입니다. 그런 다음 키를 다시 붙여넣으세요. Secret을 잃어버렸다면 새 키를 만드세요. |
| *Portfolio Margin 계정만 연결할 수 있습니다…*              | 계정이 Classic 모드입니다.                                        | 1단계를 수행한 다음 다시 확인하세요. 전환하기 전에 키를 만들었다면 새 키를 만드세요.                                 |
| *키에 "…"가 활성화되어 있지 않습니다…*                        | 필수 권한이 없습니다.                                              | Binance에서 체크한 뒤 저장하고 다시 확인하세요. 새 키는 필요 없습니다.                                      |
| *키에 "…"가 활성화되어 있습니다. 자금 보호를 위해 이 키는 허용하지 않습니다…* | 키에 출금 또는 내부 이체가 켜져 있습니다.                                  | Mojo는 이 키를 받지 않습니다. 해당 항목을 끈 새 키를 만드세요(2\~4단계).                                   |
| *Binance 계정 하나는 Mojo 계정 하나에만 연결할 수 있습니다…*       | 그 Binance 계정은 이미 다른 Mojo 계정에 연결되어 있습니다.                   | 먼저 거기서 연결을 해제하세요.                                                                 |
| *같은 Binance 계정의 키로만 교체할 수 있습니다…*                | 키를 교체하는 동안 다른 Binance 계정의 키를 붙여넣었습니다.                     | 계정을 바꾸려면 먼저 연결을 해제한 다음 다른 계정을 연결하세요.                                              |
| *Binance가 바쁘거나 점검 중입니다…* / *저희 쪽에 문제가 생겼습니다…*   | 일시적인 문제입니다. 키에는 아무 문제가 없습니다.                              | 1\~2분 후 다시 시도하세요.                                                                 |

***

### 자주 묻는 질문

#### Portfolio Margin Mode를 어떻게 켜며, Mojo에 왜 필요한가요?

위 1단계를 따르거나 Binance의 가이드를 보세요: [Binance에서 Portfolio Margin Mode를 활성화하는 방법](https://www.binance.com/en/support/faq/how-to-activate-the-portfolio-margin-mode-on-binance-7ee6b3f65d5a421491c0a5588223fd14). 전환 버튼은 Futures 페이지의 **Account**옆에 있습니다. Binance에서 전환을 허용하기 전에 Cross Margin 및 선물 계정에서 대출, 미체결 주문, 미체결 포지션, 마이너스 잔고가 없어야 하며, Isolated Margin과 Multi-Assets Mode는 꺼져 있어야 합니다. 다음 **Switch** 옵션이 보이지 않으면 아직 계정이 대상이 아닙니다. 그건 Binance가 결정합니다.

Mojo가 이것을 필요로 하는 이유는 에이전트가 Binance의 Portfolio Margin 인터페이스를 통해 선물 주문을 넣기 때문입니다. Classic 모드 계정의 키는 연결할 수 없고, 나중에 모드를 바꾸면 기존 키도 작동하지 않습니다(아래 경고를 보세요. *시작하기 전에*).

#### API 키는 어떻게 만들까요?

위 2단계를 따르거나 Binance의 가이드를 보세요: [Binance에서 API 키를 만드는 방법](https://www.binance.com/en/support/faq/360002502072). Binance는 키를 만들기 전에 신원 인증, 2단계 인증, 그리고 최소 한 번의 입금을 요구합니다.  **System-generated**를 선택하고 Secret을 안전하게 보관하세요. Binance는 한 번만 보여줍니다. 키 관리는 [API Management](https://www.binance.com/en/my/settings/api-management).

#### Binance의 TradFi perpetuals — 주식, ETF, 원자재를 에이전트가 거래할 수 있나요?

네, Binance 계정이 그에 맞게 설정되어 있다면 가능합니다. Binance의 **TradFi Perps** 는 주식, ETF, 금, 원유 같은 전통 자산의 무기한 선물입니다. Binance는 대상 지역에서만 이를 제공하며, 첫 거래 전에 별도의 TradFi Perps 계약에 동의하라고 요구합니다. Binance에서 직접 처리하세요. **Futures** 페이지를 열고 **TradFi** 탭을 선택한 다음 Binance의 안내를 따르세요. Mojo는 대신 동의할 수 없습니다.

이 작업이 끝나기 전에 에이전트에게 TradFi 거래를 요청하면, Binance는 주문을 거부하고 Mojo는 계정이 아직 TradFi 무기한 상품용으로 설정되지 않았다고 알려줍니다.

Binance 페이지: [전통 자산 무기한 선물](https://www.binance.com/en/support/faq/detail/fe7dcdf24f1943d98b368f5f9f744398) · [Binance Futures가 TradFi 무기한 계약을 출시](https://www.binance.com/en/support/announcement/detail/ecf7318c0d434c339e80878588e700d0)

#### Mojo가 Binance에서 내 자금을 출금하거나 밖으로 옮길 수 있나요?

아니요. Mojo는 출금 권한이 있는 키를 받지 않으며, 승인한 플랜의 일부로 자신의 Binance 계정 안의 지갑들(Spot Wallet, Funding, Portfolio Margin) 사이에서만 자금을 이동할 수 있습니다. 자금은 절대 계정을 벗어나지 않습니다. 키는 암호화되어 저장되며 주문 서명에만 사용됩니다. AI는 키를 보지 못합니다.

#### 왜 키에 "Enable Spot & Margin Trading"이 필요하죠? Mojo가 마진 거래를 하거나 주식을 거래하나요?

Binance가 현물, 마진, 그리고 일부 계정에서는 주식 토큰 거래를 하나의 권한에 묶어 두기 때문입니다. 이것은 분리할 수 없고, 현물 거래에도 필요합니다. Mojo는 사용자가 승인한 플랜의 주문만 넣습니다. 권한을 사용할 수 있다고 해서 에이전트가 실제로 그 권한을 쓴다는 뜻은 아닙니다.

#### 왜 키를 Mojo의 IP로 제한해야 하나요? Mojo의 주소가 바뀌면 어떻게 되나요?

그건 Binance 규칙입니다. IP 제한이 없는 키는 읽기 외에는 권한이 없어서 거래를 켤 수 없습니다. 제한된 키는 Binance에서 만료되지도 않습니다. Mojo의 주소가 바뀌면 새 주소를 추가하라는 알림이 Assets 페이지에 표시됩니다. 탭해서 Binance에 주소를 추가한 다음 **Check again을 탭하세요.**.

#### Binance 계정 두 개를 연결할 수 있나요?

Mojo 계정당 Binance 계정은 하나이며, 각 Binance 계정은 Mojo 계정 하나에만 연결할 수 있습니다. 계정을 바꾸려면 먼저 현재 계정의 연결을 해제하세요.

#### Mojo는 내 Binance 계정에서 무엇을 읽나요?

잔고, 포지션, 미체결 주문, 거래 내역입니다. Assets 페이지, 에이전트, 그리고 에이전트가 실제 거래 방식을 바탕으로 시작하는 데 도움이 되는 짧은 개인화 프로필을 만들기 위해 사용합니다. 연결 후 Mojo는 지난 3개월간의 Binance 거래와 이체 내역을 읽고, 이후 새 내역도 계속 반영합니다. Mojo는 Binance 로그인 정보를 읽을 수 없으며, API Secret을 평문으로 보지 않습니다. 개인화 프로필은 언제든지 거부할 수 있습니다.  [개인정보 처리방침의 3.2절](https://www.mojo.trade/privacy-policy-en/).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.mojo.trade/ko/closed-beta-guide/binance.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.