KuCoin 포트폴리오 관리: 잔고, 선물, 매수 평균가, 내역

CentraFIN은 읽기 권한인 General 권한만 있는 API 키로 KuCoin 계정을 읽어요. 클래식 계정인지 통합 계정(Unified Trading Account)인지는 CentraFIN이 알아서 알아봐요. KuCoin 계정 전체, 선물 포지션, 미체결 주문, 매수 평균가, 이체를 다른 플랫폼과 나란히 볼 수 있어요.

CentraFIN이 읽는 내용

잔고: 클래식 계정은 펀딩, 트레이딩, 교차·격리 마진(빌린 금액 제외), 선물 계정을, 통합 계정은 통합 계정과 펀딩 계정을 읽어요. 여기에 Earn 자산을 더해, 대시보드가 열려 있는 동안 1분마다 모두 유로로 평가해요.
선물: 열린 포지션을 미실현 손익, 그리고 포지션을 받치는 증거금과 함께 보여 줘요.
미체결 주문: 통합 계정은 현물, 마진, 선물 주문을 조건부 주문까지 포함해서, 클래식 계정은 선물 주문, 스톱 주문, 현물 주문을 보여 줘요.
매수 평균가와 양도차익: 현물 거래를 읽고, 통합 계정이면 마진 거래도 읽어요. KuCoin은 최근 거래(클래식 계정은 1주, 통합 계정은 최대 3개월)만 주기 때문에, CentraFIN은 연결하자마자 그 기간을 읽고 그 뒤로는 새 거래를 하나하나 보관해요.
이체: 2019년 2월부터 블록체인이나 KuCoin 계정 사이의 코인 입금과 출금을 읽고, 한 계정에서 다른 계정으로 간 이체는 내 다른 계정과 맞춰 봐요.
내역: 최근 3개월치 선물 체결부터 읽고 그 뒤로는 새 체결을 계속 읽어요. 계정 원장도 읽어요.

KuCoin에서 키 만들기

KuCoin에서 계정 메뉴를 열고 API 관리(API Management), API 만들기 순서로 누르세요.
이름을 붙이고 패스프레이즈를 정하세요. 키를 추가할 때 필요하니 적어 두세요.
권한은 General 하나만 남기세요. 거래, 마진, 선물, Earn, 이체, 출금은 모두 빼세요.
키를 저희 릴레이 주소 130.110.240.91로 제한하세요.
보안 인증을 마치고 API 키와 시크릿 키를 복사하세요.

CentraFIN에 추가하기

대시보드에서 커넥터를 열고 커넥터 추가, KuCoin 순서로 고르세요.
이름을 붙이고 API 키, 시크릿 키, 패스프레이즈를 붙여 넣으세요.
CentraFIN은 키를 보관하기 전에 KuCoin에 키 권한을 확인하고, 클래식 계정인지 통합 계정인지 알아봐요. 잔고는 1분 안에 표시되고, 내역은 이어지는 몇 분 동안 차례로 불러와요.

보안

General 말고 다른 권한이 있는 키는 거부돼요. 읽기 권한만 통과해요.
키, 시크릿 키, 패스프레이즈는 도착하자마자 암호화되고(AES-256-GCM), 다시는 표시되지 않아요. 키의 끝부분만 보여요.
요청은 모두 저희 릴레이의 주소 하나에서 나가요. KuCoin이 속도를 줄여 달라고 하면 CentraFIN은 멈추고 기다렸다가 다시 시작해요.

다른 계정과 함께

KuCoin 선물은 Binance, Bybit, OKX의 포지션과 함께, 현물은 Coinbase 잔고와 함께 표시돼요. KuCoin에서 내 다른 계정으로 출금하면 유출이 아니라 내부 이체로 표시돼요. 다른 플랫폼은 모든 연동에서 볼 수 있어요.

자세히 알아보기: 읽기 전용 API 키

자주 묻는 질문

CentraFIN이 내 KuCoin 계정에서 거래하거나 출금할 수 있나요?

아니요. 키에는 읽기 권한인 General 권한만 있고, CentraFIN은 키를 보관하기 전에 다른 권한이 없는지 KuCoin에 확인해요.

제 계정은 통합 계정이에요. 그래도 되나요?

네. CentraFIN은 같은 키로 클래식 계정과 통합 계정을 알아보고, 각 계정의 API가 주는 내용을 읽어요.

마진과 Earn 자산도 계산되나요?

네. 빌린 금액을 뺀 마진 계정과 Earn 자산을 다른 자산과 함께 총자산에 포함해요.

KuCoin 포트폴리오 관리는 무료인가요?

네. 모든 연동이 무료 요금제에 포함돼요.