코인원 API 파이썬 자동매매 가이드
코인원 파이썬 자동매매는 ① 코인원 계정(KYC 인증) → ② Open API 메뉴에서 키 발급 → ③ Access Key·Secret Key를 공통모듈에 입력 → ④ 테스트 파일로 조회 확인 순서입니다. 코인원은 파이썬에서 쉽게 쓸 수 있는 공개 래퍼 라이브러리가 없어서 게만아가 공통모듈을 직접 구현했고, 한 계정 안에서 포트폴리오별로 API 키를 발급해 자산을 분리할 수도 있습니다.
게만아 코인원 공통모듈 대표 포스팅
코인원 API 연동과 공통모듈(패키지 54번)의 설정·사용 방법은 게만아 블로그의 대표 포스팅에서 설명합니다. 실제로 연결할 때는 이 포스팅을 먼저 읽어 주세요.
코인원 파이썬 자동매매 시작 포스팅 보기 →한눈에 보기
| 방식 | REST API. 공식 문서는 docs.coinone.co.kr입니다. 업비트의 pyupbit나 빗썸의 pybithumb 같은 편한 래퍼가 코인원에는 마땅치 않아 공통모듈을 직접 만들었습니다. |
|---|---|
| 키 발급 | 코인원 페이지 맨 아래의 Open API 메뉴 → [통합 API 관리] → 개인용 API에서 [새로운 키 발급] → 이름 입력 → 권한 선택 → 허용 IP 등록 → 약관 동의 → [API 생성]. |
| 권한 | 게만아는 잔고조회, 주문조회, 주문관리 정도를 선택합니다. |
| 허용 IP | 필수. 코인원 Open API 이용약관 개정으로 키 발급 시 접근 IP 등록이 필수가 됐습니다. IPv4 공인 IP를 키마다 최대 5개까지 등록하며, 신규 키는 IP가 하나 이상 있어야 발급됩니다. 기존 키도 유예기간 안에 IP를 등록하지 않으면 사용할 수 없어 새로 발급해야 합니다. 유동 IP는 IP가 바뀌면 호출이 차단될 수 있어 고정 IP가 권장됩니다. 게만아 포스팅(2024년 7월)의 발급 절차에는 IP 단계가 없었습니다. |
| Secret Key | Access Key와 Secret Key 두 개가 나오며, 확인 버튼을 누른 뒤에는 알 방법이 없으므로 먼저 복사해 둡니다. |
| 포트폴리오 | 코인원은 오래전부터 포트폴리오 기능으로 한 계정 안에서 자산을 나누고, 포트폴리오별 API 키를 발급해 서로 다른 전략을 분리 운용할 수 있었습니다. 이 포트폴리오는 Open API로만 매매할 수 있습니다. |
| 계정 조건 | 게시 시점(2024년 7월)에는 카카오뱅크 계좌와 KYC 인증이 필요했습니다. 현재 조건은 코인원 공지를 확인하세요. |
| 종목 표기 | BTC처럼 코인 이름만 씁니다. 업비트·빗썸은 KRW-BTC 형식입니다. |
| 인증 방식 | 모든 비공개 요청에 X-COINONE-PAYLOAD와 X-COINONE-SIGNATURE 두 헤더가 필요합니다. 요청 본문(액세스 토큰과 UUID nonce 포함)을 Base64로 인코딩한 값이 PAYLOAD이고, 이를 시크릿 키로 서명(HMAC-SHA512)한 값이 SIGNATURE입니다. 공통모듈이 이를 처리합니다. |
| 수수료 | API 매매에 수수료 할인 혜택이 있었던 시기가 있습니다. 혜택은 시점에 따라 달라지므로 현재 조건은 코인원 공지를 확인하세요. |
| 게만아 연결 | 패키지 54번 · 공통모듈 myCoinone.py · 사용 예시 Coinone_Test.py. 업비트용 myUpbit.py와 같은 구조로 만들어 업비트 전략을 옮겨 쓰기 쉽습니다. |
파이썬 자동매매 연동 순서
- 코인원 계정을 준비하고 KYC 인증을 마칩니다(가입 조건은 코인원 공지 확인).
- 코인원 페이지 맨 아래의 Open API 메뉴로 들어가 [통합 API 관리]를 누르고, 개인용 API에서 [새로운 키 발급]을 누릅니다.
- 키 이름을 정하고 잔고조회·주문조회·주문관리 권한을 선택합니다.
- 허용 IP에 내 PC의 IP와 자동매매 서버의 IP를 등록하고, 약관에 동의한 뒤 [API 생성]을 누릅니다.
- Access Key와 Secret Key를 복사해 안전하게 보관합니다(확인 후에는 다시 볼 수 없습니다).
myCoinone.py상단의 액세스 토큰·시크릿 키 변수에 입력하고 저장합니다. 필요한 라이브러리(httplib2)가 없다면pip3 install httplib2로 설치합니다.Coinone_Test.py로 티커·잔고·현재가·캔들을 조회부터 확인합니다. 주문 예시는 주석을 풀어 가장 작은 금액으로 확인하세요.
게만아 공통모듈로 쓰면
코인원 공통모듈 myCoinone.py는 게만아 업비트 공통모듈(myUpbit.py)과 같은 구조로 만들어, 잔고·보유 코인 조회, 현재가, 캔들 조회, 시장가·지정가 주문, 미체결 주문 조회·취소를 같은 방식으로 호출합니다. 그래서 업비트용 전략을 코인원으로 옮겨 쓰기 쉽고, 같은 전략을 업비트와 코인원에서 나란히 운용하는 세컨 계좌도 만들 수 있습니다.
업비트와 가장 크게 다른 점은 종목 표기(KRW-BTC ↔ BTC)와 API 키를 넣는 위치입니다.
이 거래소에서 쓸 수 있는 패키지 콘텐츠
전략마다 시장·대상·실행 주기는 전략·시스템 카탈로그에서 확인할 수 있습니다.
실전에서 주의할 점
- 허용 IP를 등록하세요. 등록하지 않은 환경에서는 호출이 거절됩니다. 유동 IP는 IP가 바뀌면 호출이 차단될 수 있으니 고정 IP 서버를 권장하며, 서버를 옮기면 허용 IP를 다시 확인하세요.
- Secret Key는 확인 버튼을 누르기 전에 복사하세요. 이후에는 다시 확인할 수 없습니다.
- 종목 표기가 거래소마다 다릅니다. 코인원은
BTC, 업비트·빗썸은KRW-BTC입니다. 다른 거래소 전략을 옮길 때는 표기를 확인하세요. - 필요한 권한만 선택하세요. 자동매매에는 잔고조회·주문조회·주문관리면 충분하며, 출금 권한은 주지 않는 것이 안전합니다.
- 모듈 설치 오류에 대비하세요. 공통모듈이 쓰는 라이브러리(
httplib2등)가 서버에 설치돼 있지 않으면 봇이 오류로 멈춥니다. 서버에도 같은 라이브러리를 설치하세요. - 게시 시점(2024년 7월)과 현재의 가입 조건·수수료 정책은 다를 수 있습니다. 코인원 공지를 확인하세요.
- 응답이 불안정할 때의 처리는 API 불안정 대응 가이드를 참고하세요.
자주 묻는 질문
코인원 API 키는 어디에서 발급받나요?
코인원 페이지 맨 아래의 Open API 메뉴에서 [통합 API 관리]를 누르고, 개인용 API의 [새로운 키 발급]을 눌러 이름과 권한(잔고조회·주문조회·주문관리)을 선택한 뒤 [API 생성]을 누르면 Access Key와 Secret Key가 나옵니다. Secret Key는 확인 후 다시 알 수 없으니 먼저 복사해 두세요.
코인원 API는 IP를 등록해야 하나요?
네, 필요합니다. 코인원 Open API 이용약관 개정으로 키 발급 시 접근 IP 등록이 필수가 됐고, IPv4 공인 IP를 키마다 최대 5개까지 등록합니다. 신규 키는 IP가 하나 이상 있어야 발급되고, 기존 키도 유예기간 뒤에는 IP를 등록하지 않으면 사용할 수 없습니다. 게만아 포스팅(2024년 7월)에는 IP 단계가 없으니 예전 글만 보고 IP 없이 발급하려 하지 마세요.
코인원 API 권한은 무엇을 선택해야 하나요?
게만아는 잔고조회, 주문조회, 주문관리 정도를 선택합니다. 출금 같은 불필요한 권한은 주지 않는 것이 안전합니다.
코인원에도 포트폴리오별 API 키가 있나요?
네. 코인원은 포트폴리오 기능으로 한 계정 안에서 자산을 나누고 포트폴리오별로 API 키를 발급받아 서로 다른 전략을 분리해 운용할 수 있습니다. 이 포트폴리오는 Open API로만 매매할 수 있습니다.
코인원에는 pyupbit 같은 파이썬 모듈이 없나요?
업비트의 pyupbit나 빗썸의 pybithumb처럼 편하게 쓸 수 있는 래퍼가 코인원에는 마땅치 않아, 게만아는 코인원 공통모듈(myCoinone.py)을 직접 만들었습니다.
업비트 전략을 코인원에서 돌릴 수 있나요?
가능합니다. 코인원 공통모듈이 업비트 공통모듈과 같은 구조라서 옮기기 쉽습니다. 다만 종목 표기(KRW-BTC ↔ BTC)를 맞춰야 하고, 거래소마다 거래 환경이 달라 옮긴 뒤 백테스트와 소액 검증이 필요합니다.
근거와 확인 시점
이 페이지는 게만아의 코인원 파이썬 자동매매 시작 포스팅(패키지 54번, 2024-07-10 게시)과 업비트 포켓 포스팅(2026-09-01)의 코인원 포트폴리오 설명, 코인원 공식 API 문서를 정리한 것입니다. 이후 바뀐 발급 화면·권한·가입 조건은 반영되지 않았을 수 있습니다. 허용 IP 등록은 게시 이후 추가된 요건으로, 코인원 공식 문서와 약관 개정 공지로 확인해 반영했습니다. 거래소의 API 사양과 정책, 가입·발급 조건은 바뀔 수 있으므로 키 발급과 실제 주문 전에 공식 문서의 최신 내용을 확인하세요.
공식 자료: 코인원 API 문서 · Open API 이용약관 개정 안내
함께 보기
업비트 API 가이드 · 빗썸 API 가이드 · 바이낸스 API 가이드 · 코인 자동매매 구조 · 전략·시스템 카탈로그 · API가 불안정할 때 대응 가이드 · API가 처음이라면 용어 풀이
API 보안
발급받은 API 키·Secret·접근토큰은 비밀번호와 같은 민감한 정보입니다. 다른 사람에게 보이거나 공개적으로 노출되지 않게 주의하고, 노출됐다면 폐기·재발급하는 것이 안전합니다. 자동매매에 필요하지 않은 권한(특히 출금)은 주지 않는 것이 좋습니다.
문서 업데이트: 2026-10-16 · 교육·기술 정보 제공 목적이며 투자 권유가 아닙니다. 가상자산은 가격 변동성이 크고 원금 손실이 발생할 수 있습니다.