🪙 Binance 설정

API로 암호화폐 계좌 연결 — 스팟 및 지갑 실시간 동기화

이 챕터에서

1 🪙 왜 Binance를 연동합니까? 2 사전 요건 3 Binance에서 API 키 생성하기 4 권한을 올바르게 설정하기 5 IP 화이트리스트(강력 권장) 6 sTraderZ.com에 연결 7 무엇이 동기화되는가? 8 보안 모범 사례 9 동기화가 안 됨 — 어떻게 합니까? 10 암호화폐 대안 비교 11 동기화에서 첫 암호화폐 거래까지

1. 🪙 왜 Binance를 연동합니까?

Binance는 거래량 기준으로 세계 최대의 cryptocurrency 거래소입니다. 750개 이상의 토큰, 광범위한 derivatives (futures, 옵션) 및 강력한 staking 옵션을 제공합니다. 독일 사용자에게는 BaFin 라이센스가 있는 Binance.com이 표준 플랫폼입니다.

주요 특징

Spot 거래: 750개 이상의 cryptocurrency 쌍, BTC, ETH 및 알트코인 포함
Futures: 최대 125× 레버리지의 USDⓈ-M 및 COIN-M futures
Earn 상품: Staking, Savings, Launchpool로 passive income 생성
낮은 수수료: 기본 0.1% spot, BNB 보유 시 25% 할인

독일 사용자 - 중요한 정보

Binance.com은 BaFin 라이센스를 보유하고 있으며 독일에서 합법적으로 사용할 수 있습니다. 그러나:

세금: Crypto 이익은 1년 미만 보유 시 소득세 대상 (Vorabpauschale 없음)
1년 보유 기간: 1년 이상 보유한 코인은 면세
증명 부담: 모든 거래는 세무서를 위해 문서화되어야 합니다 (sTraderZ.com이 도움을 줍니다)

⚠️ 본 섹션은 독일 세법 기준입니다. 한국 세법(소득세법)에 대해서는 별도 자문이 필요합니다.

2. 사전 요건

기존 Binance 계정과 완료된 KYC 인증 ("Verified" 이상). 인증 없이는 API 기능이 잠겨 있습니다.
2단계 인증 (2FA) — Google Authenticator, Yubikey 또는 Binance/Authy 중 하나. API 생성에 필수.
고정 IP 주소 또는 VPS (권장) — IP whitelisting을 사용하려는 경우 (강력히 권장, 3단계 참조).
10 분 — 설정은 빠르지만 신중히 진행해야 합니다.

단계별 안내

Binance에서 API 키 생성하기

1. Binance에 로그인하십시오 → 오른쪽 상단의 프로필 아이콘 클릭 → API Management.

2. 새 API 키 생성 → 「Create API」 클릭 → 유형 「System generated」 선택(Self-Generated가 아님, 이는 고급 사용 사례용).

3. 레이블 설정: 예: 「sTraderZ Read-Only」.

4. 2FA 확인: Google Authenticator + 이메일 코드를 통해 확인.

5. API Key + Secret이 표시됩니다 — Secret은 한 번만 보입니다. 안전하게 저장하십시오(비밀번호 관리자).

권한을 올바르게 설정하기

Binance 계좌를 안전하게 설정하려면 다음 단계를 따르세요:

2FA 활성화: Google Authenticator를 사용하여 2단계 인증을 즉시 활성화합니다. SMS-2FA는 SIM 스왑 공격에 취약하므로 피하세요.
출금 화이트리스트: 알려진 지갑 주소만 화이트리스트에 추가합니다.
API 키 제한: 거래 권한만 부여하고 출금 권한은 절대 부여하지 마세요.
강력한 비밀번호: 다른 곳에서 사용한 적이 없는 고유한 비밀번호를 사용합니다.
안티-피싱 코드: 모든 합법적인 Binance 이메일에 표시되는 개인 안티-피싱 코드를 설정합니다.

IP 화이트리스트(강력 권장)

정적 IP가 있다면(라우터 구성을 통해 집에서 또는 VPS에서):

• 「신뢰할 수 있는 IP에만 접근 제한」 선택
• sTraderZ.com의 IP 주소 입력:
185.xxx.xxx.xxx(정확한 IP는 계좌 구성에서 확인)
• 저장

정적 IP가 없다면: 「Unrestricted」로 두십시오, 그러나 그러면 Read-Only 권한이 유일한 보호 계층입니다. 어쨌든 거래가 불가능하므로 이것은 허용됩니다 — 그러나 정적 IP가 더 깨끗한 해결책입니다.

sTraderZ.com에 연결

🏦 계정 생성

계정 → + 새 계정 → Broker 선택: "Binance" → 저장.

🔑 API 자격 증명 입력

계정 개요 → Binance 계정 클릭 → 탭 설정 → 비밀번호 관리자에서 API Key와 Secret 붙여넣기 → 저장.

🔄 동기화 시작

"지금 동기화" 클릭. 초기 동기화는 최근 12 개월을 불러오며, 거래량에 따라 30 초에서 2 분 소요됩니다.

✓

⏰ 자동 동기화 활성화됨

이제부터 동기화는 백그라운드에서 정기적으로 실행됩니다. 새로운 거래, 지갑 이동, 전환이 자동으로 캡처됩니다.

7. 무엇이 동기화되는가?

데이터 유형	상태	비고
Spot 거래	✅	전체 — Buy/Sell, 모든 페어(BTC/USDT, ETH/EUR, …)
지갑 잔고	✅	Spot 지갑 실시간 잔고를 EUR로 환산
전환(Conversion)	✅	Convert API(예: BTC → USDT 직접 전환)는 거래로 기록됩니다
Earn / Staking 보상	✅	Flexible & Locked Earn은 과세 소득으로 표시됩니다
입금 / 출금	✅	입출금은 cash flow에서 추적됩니다
Futures / Margin	⚠️	Beta — 별도 권한 필요, 계정 설정에서 활성화 가능
P2P 거래	❌	API에서 P2P를 제공하지 않음 — CSV로 수동 가져오기 가능
NFT	❌	(아직) 지원되지 않음

✨

보안 모범 사례

99%의 crypto API 재앙으로부터 보호하는 세 가지 규칙:

1. "Enable Withdrawals"를 절대 활성화하지 마세요. 어떤 서비스가 요청하더라도 거절해 주세요. 출금은 어쨌든 Binance 측에서 별도의 화이트리스트가 필요하지만, 키가 손상되고 출금을 활성화했다면 게임 오버입니다.

2. API Secret을 비밀번호처럼 다루세요 — 비밀번호 관리자(Bitwarden, 1Password, KeePass)를 사용하고, 어디에도 평문으로 저장하지 말고, 이메일/Slack/Telegram을 통해 공유하지 마세요.

3. 90일마다 교체하세요. Binance 키는 기술적으로 만료되지 않지만 규율 차원에서 교체해 주세요. 기존 키 삭제, 새 키 생성, sTraderZ.com에서 업데이트 — 3분 소요됩니다.

⚠️ 동기화가 안 됨 — 어떻게 합니까?

오류: "Invalid API-key, IP, or permissions for action"
가장 흔한 원인: IP whitelist를 활성화했지만 저희 IP를 추가하지 않았습니다. 해결: Binance → API Management → IP whitelist → 저희 IP 추가(계정 구성 참조).

오류: "Signature for this request is not valid"
API Secret을 잘못 입력했습니다. 복사·붙여넣기 시 종종 후행 공백이 함께 복사됩니다. 해결책: 비밀번호 관리자에서 secret을 다시 복사하여 붙여넣고 저장해 주세요.

오류: "Account has insufficient permissions"
"Enable Reading" 없이 API 키를 생성했습니다 — 다른 권한이 비활성화될 때 놓치기 쉽습니다. 해결책: Binance → 키 편집 → "Enable Reading" 활성화.

초기 동기화가 매우 오래 실행 중(> 5분):
10,000개 이상의 Trade가 있는 대형 계정의 경우 초기 동기화는 실제로 더 오래 걸립니다. 그냥 실행되도록 두세요 — 그 후 증분 동기화(10분마다)는 매우 빠릅니다.

10. 암호화폐 대안 비교

Binance에서 API를 생성하고 sTraderZ.com에 연결하는 단계별 가이드:

1단계: Binance API 키 생성

Binance.com에 로그인
프로필 → API Management로 이동
"Create API"를 클릭하고 System-generated API Key 선택
API 키에 라벨 지정 (예: "sTraderZ Import")
이메일 및 2FA로 확인

2단계: 권한 설정

✅ Enable Reading - 활성화 (필수)
❌ Enable Spot & Margin Trading - 비활성화 (필요 없음)
❌ Enable Withdrawals - 절대 활성화하지 마세요!
❌ Enable Futures - 비활성화 (sTraderZ는 spot 가져오기만 지원)

3단계: IP 제한 (강력히 권장)

"Restrict access to trusted IPs only"를 활성화하고 sTraderZ.com 서버 IP를 추가하세요. 보안에 매우 중요합니다.

4단계: API 키와 Secret 복사

⚠️ Secret Key는 단 한 번만 표시됩니다! 즉시 비밀번호 관리자에 안전하게 저장하세요.

5단계: sTraderZ.com에 연결

sTraderZ.com에 로그인
계정 → Brokers로 이동
"Add Binance" 클릭
API 키와 Secret 입력
"Test Connection" 클릭
성공 시 "Save"

💡 API 키는 90일마다 만료됩니다. Binance가 만료 7일 전에 이메일로 알립니다.

11. 동기화에서 첫 암호화폐 거래까지

계좌가 연결되었습니까? 축하합니다 — 동기화가 이제 백그라운드에서 실행 중입니다.

2.5장 첫 거래 — 아직 거래를 실행하지 않았다면: 여기에 단계별 가이드가 있습니다.
11장 거래 관리 — 태그, 노트, 전략으로 crypto 거래를 풍부하게 하는 방법.
6장 세금 — Crypto별 규칙(보유 기간, swap, 스테이킹 소득).