코인원 API 연동 방법 — 잔고조회·주문조회만 켠 키 발급부터 사토시노트에 넣기까지 (2026)

가이드 · 2026년 11월 3일 · Satoshi Note

다른 언어: English

코인원과 업비트, 혹은 코인원과 빗썸을 같이 쓰는 분이 많습니다. 두 거래소 잔고를 한 화면에서 보려면 코인원 쪽에도 Open API 키를 하나 만들어 자산관리 앱에 넣으면 됩니다. 이 글은 그 순서를 처음부터 끝까지 실제 화면으로 따라갑니다. 걸리는 시간은 5분 안팎이고, 비용은 없습니다.

먼저 한 가지만 짚고 갑니다. 여기서 만드는 키는 잔고조회·주문조회 권한만 켠 읽기 전용 키입니다. 주문 권한·출금 권한은 켜지 않으니, 이 키로는 코인을 팔거나 다른 곳으로 보낼 수 없습니다. 사토시노트는 저장하기 전에 키를 시험해 보고, 거래나 출금 권한이 켜진 키는 받지 않습니다. 왜 그런지 자세한 설명은 읽기 전용 키란? 출금은 못 하는 안전한 거래소 연동 방법에 따로 써 두었습니다.

한눈에 보기

코인원 연동은 세 단계입니다. 코인원 웹 프로필 아이콘 › ‘Open API’ › ‘새로운 키 발급’에서 “잔고 조회”·“주문 조회”만 체크하고 사토시노트 서버 IP를 등록한 뒤 ‘전체 동의’를 체크해 ‘API 생성’을 누르고, Access Token·Secret Key를 사토시노트 설정 › 자산 연동 › 국내 › 코인원에 넣고, 저장 전 “계정 확인”을 통과하면 끝입니다.
막히기 쉬운 곳: IP 주소 등록이 필수(고정 공인 IPv4, 최대 5개), ‘전체 동의’를 체크하기 전엔 ‘API 생성’이 눌리지 않음, Secret Key는 한 번만 보임, 권한은 만든 뒤 못 바꿈.
사토시노트(토큰포스트가 운영하는 무료 암호화폐 자산관리 앱, 거래소 18곳 읽기 전용 API 연동)에서는 코인원 원화 마켓 체결이 업비트·빗썸·바이낸스와 한 표에 거래소별로 나뉘어 보입니다.

시작 전에 알아둘 것 세 가지

IP 주소 등록은 필수입니다. 코인원은 키마다 “이 키로 요청을 보낼 수 있는 IP”를 반드시 적게 하고, 고정 공인 IPv4 주소를 최대 5개까지 넣을 수 있습니다. 여러분 PC나 폰의 IP가 아니라, 여러분 대신 코인원에 조회 요청을 보내는 사토시노트 서버의 IP를 넣어야 합니다. 그 주소는 사토시노트 앱 안 연동 가이드에 “IP 복사하기” 버튼과 함께 적혀 있습니다.
권한은 만들 때 한 번만 정합니다. 코인원 발급 화면에 작은 글씨로 “API 권한은 최초 생성 시에만 설정 가능합니다. 변경이 필요한 경우 재생성해 주세요”라고 적혀 있습니다. 처음에 맞는 칸 두 개를 체크하세요.
Secret Key는 발급 순간 한 번만 보입니다. 창을 닫으면 다시 볼 수 없고 새로 발급해야 하니, 발급되자마자 둘 다 바로 복사해 두세요.

1단계 — 코인원 웹에서 Open API로 가기

PC 브라우저로 coinone.co.kr에 로그인한 뒤 오른쪽 위 프로필 아이콘 → ‘Open API’를 고릅니다. API 관리 화면에서 ‘새로운 키 발급’을 누르면 “개인용 API Key 생성” 화면이 열립니다. 위에서부터 API 이름 → API 권한 선택 → 접근 가능 IP 등록 → 전체 동의 → API 생성 순서입니다. 사토시노트 앱 안 거래소 연동 가이드에서 코인원을 고르면 같은 경로와 체크할 칸이 표시된 그림이 한 화면에 나오니, 옆에 띄워 두고 따라가면 편합니다.

2단계 — 권한은 잔고 조회·주문 조회만

API 권한 선택에는 칸이 여섯 개 있습니다. 두 개만 체크합니다.

잔고 조회(가상자산 및 원화 잔고 조회): 지금 보유 수량을 읽습니다. 계정 확인과 보유 현황에 필요합니다.
주문 조회(활성 주문·주문 내역·체결 내역 조회): 언제 얼마에 몇 개를 사고팔았는지 읽습니다. 평균 단가와 손익은 여기서 나옵니다.
고객 정보·입출금 조회·주문 권한·출금 권한은 비워 둡니다. 주문 권한이나 출금 권한이 켜진 키는 사토시노트가 받지 않습니다.

![코인원 “개인용 API Key 생성” 화면. 빨간 테두리로 “잔고 조회”와 “주문 조회” 체크박스, “접근 가능 IP 등록(최대 5개)”의 IP 주소 입력 칸, [필수] API 이용약관·개인정보 수집 및 이용 동의가 들어 있는 “전체 동의” 묶음, “API 생성” 버튼이 표시된 모습](/exchange-guides/coinone-web-checklist.png)

3단계 — IP 등록, 전체 동의, API 생성

접근 가능 IP 등록 칸에 사토시노트 가이드 화면의 “IP 복사하기” 버튼으로 복사한 주소를 붙여넣고 오른쪽 + 를 눌러 목록에 올립니다. 고정 공인 IPv4 주소만 받고, 키 하나에 최대 5개까지 됩니다.
‘전체 동의’를 체크합니다. [필수] API 이용약관과 [필수] 개인정보 수집 및 이용 동의 두 가지가 한꺼번에 체크되고, 이걸 체크해야 ‘API 생성’ 버튼이 켜집니다.
‘API 생성’을 누르면 Access Token과 Secret Key가 나옵니다. 둘 다 바로, 빠짐없이 복사하세요. 코인원이 Secret Key를 보여 주는 건 이때뿐입니다.

4단계 — 사토시노트에 붙여넣기

사토시노트 앱(satoshinote.io)에 로그인한 뒤 설정 → 자산 연동으로 가서 국내 탭에서 코인원을 고르고, 첫 칸에 Access Token, 둘째 칸에 Secret Key를 붙여넣습니다. 몇 초 안에 계정 확인 → 최근 체결 조회 → 투자 기록 정리 세 단계가 지나가고, 종목별 보유 수량·평균 단가·평가손익이 한 표에 채워집니다. 키는 사토시노트 서버에 암호화해 저장되고, 거래소에 조회 요청을 보낼 때만 씁니다.

연동이 끝나면 매일 아침 같은 숫자를 메일 보고서로도 받을 수 있습니다.

가져오는 범위 — 원화 마켓 현물 체결

원화 마켓 현물 체결을 체결 시각·수량·원화 단가 그대로 가져옵니다. 환산이 없어 평균 단가가 거래소 화면과 바로 맞습니다.
첫 동기화는 최근 7일 체결부터 가져오고, 그다음부터는 자동 동기화가 새 체결을 계속 쌓습니다. 코인원 API는 한 번에 최근 90일까지만 조회되므로, 그보다 오래된 거래를 기록에 넣고 싶다면 캘린더에서 직접 입력으로 적어 주세요.
입출금은 가져오지 않습니다. 다른 거래소나 지갑에서 옮겨 온 코인은 코인원 잔고에는 잡히지만 체결 내역이 없어, 손익에 넣고 싶다면 원가를 직접 입력해 주면 됩니다.
스테이킹·예치 보상은 기록하지 않습니다.

자주 막히는 곳

‘API 생성’ 버튼이 눌리지 않아요.

‘전체 동의’가 체크되지 않은 경우입니다. 필수 동의 두 가지가 다 체크돼야 버튼이 켜집니다. IP 주소를 칸에 적기만 하고 + 를 안 눌러 목록에 안 올라간 건 아닌지도 보세요.

키를 넣었는데 “계정 확인” 단계에서 실패해요.

가장 흔한 원인은 IP입니다. 코인원 › Open API에서 그 키의 접근 가능 IP 목록을 열어 사토시노트 가이드 화면의 주소와 같은지 보세요. 둘째로 흔한 원인은 ‘잔고 조회’를 안 켜고 발급한 키인데, 코인원 키는 권한을 고칠 수 없으니 두 칸을 다 켜서 새로 발급해 주세요.

“거래·출금 권한이 켜져 있습니다”라고 나와요.

‘주문 권한’이나 ‘출금 권한’을 체크한 경우입니다. 코인원에서 그 키를 지우고 ‘잔고 조회’·‘주문 조회’만 켠 새 키를 만들어 주세요.

예전 거래가 안 보여요.

첫 동기화는 최근 7일을 가져오고, 코인원 API는 한 번에 최근 90일까지만 돌려줍니다. 그 전 거래는 캘린더에서 직접 입력으로 넣을 수 있고, 지금 보유 수량은 잔고에서 그대로 읽힙니다.

자주 묻는 질문

이 키로 누가 내 코인을 출금할 수 있나요?

없습니다. ‘출금 권한’이 없는 키는 출금을 만들 수 없고 ‘주문 권한’이 없는 키는 거래를 낼 수 없으며, 둘 다 코인원 쪽에서 막힙니다. 거기에 IP 등록 때문에 사토시노트 서버가 아닌 곳에서는 키 자체가 동작하지 않습니다. 사토시노트도 거래·출금 권한이 켜진 키는 저장하지 않습니다.

어떤 거래소는 IP가 선택인데 코인원은 왜 필수인가요?

코인원은 업비트·빗썸처럼 접근 가능 IP 목록을 키의 일부로 봅니다. 키가 새어 나가도 다른 주소에서는 쓸 수 없게 하는 한 겹입니다.

코인원 앱에서도 발급되나요?

이 글은 ‘Open API’ 메뉴와 발급 화면이 다 있는 PC 웹 기준입니다. 폰만 있다면 브라우저를 데스크톱 모드로 바꿔 coinone.co.kr을 여세요.

다른 거래소도 같이 쓴다면

업비트·빗썸·바이낸스처럼 다른 거래소도 쓴다면 같은 방식으로 키를 하나씩 넣으면 한 표에 합쳐집니다. 거래소별 순서는 업비트 API 연동 방법, 빗썸 API 연동 방법, 바이낸스 API 연동 방법, 코인베이스 API 연동 방법에 따로 적었고, 18개 거래소 전부의 그림 가이드는 앱 안 거래소 연동 가이드에 있습니다.

사토시노트는 무료이며 읽기 전용 API 키만 받습니다. 주소는 satoshinote.io입니다.