코인 자동매매 만들기 전에 보는 업비트 Open API, 시세 1초 10회와 최소 주문 5,000원의 뜻

2026-10-17

코인 자동매매를 만들 때 가장 먼저 막히는 곳은 어디일까요? 답은 거래소 규칙입니다. 매매 전략보다 거래소가 정해 둔 규칙에서 먼저 멈추는 일이 많습니다.

프로그램은 거래소 Open API 로만 시세를 읽고 주문을 넣습니다. 키 발급 조건, 키를 쓸 주소, 1초 요청 수, 주문 가격 단위는 코드보다 먼저 정해져 있습니다.

이 글은 국내 거래소 업비트의 개발자 문서에 적힌 숫자만으로 이 네 가지 개념을 풀었습니다. 전략이나 수익 이야기는 다루지 않습니다.

1.API 키: 무엇을 해도 되는지 정하는 열쇠

API 키는 프로그램이 내 계정 이름으로 거래소에 요청을 보낼 때 쓰는 열쇠입니다. Access key 와 Secret key 한 쌍으로 나옵니다.

업비트 문서는 고객 확인과 2채널 인증(2FA)을 마친 뒤에 키를 받을 수 있고, 발급은 PC 웹에서만 된다고 적었습니다(업비트 API Key 발급 가이드). 메인포켓에서는 키를 10개까지, 서브포켓에서는 5개까지 만들 수 있습니다.

발급할 때 자산조회, 주문하기, 출금하기 같은 권한을 골라 붙입니다. 출금하기 권한이 들어간 키에는 출금 안심차단이 자동으로 걸려, 그 키로는 출금 API 를 부를 수 없다고 문서에 나옵니다.

Secret key 는 처음 발급하는 화면에서만 보입니다. 잃어버리면 다시 볼 방법이 없어 키를 지우고 새로 받아야 합니다.

요청마다 이 키로 JWT 토큰을 만들어 붙이며, 문서는 HS512 서명과 매번 새 nonce 를 권합니다(업비트 인증 문서).

2.허용 IP: 키를 쓸 수 있는 주소

키에는 요청을 보낼 컴퓨터의 IP 를 등록합니다. 키 하나에 10개까지이고, 공인 IPv4 만 받으며 사설 IP 는 안 됩니다.

!업비트는 유동 IP 환경에서의 이용을 권장하지 않는다고 적었다. 집 인터넷처럼 공인 IP 가 바뀌는 곳에서는 바뀔 때마다 다시 등록해야 한다.

24시간 돌릴 생각이라면 고정 IP 가 있는 곳을 먼저 정하는 편이 덜 번거롭습니다.

3.요청 수 제한: 1초에 몇 번까지 보낼 수 있나

요청 수 제한(rate limit)은 정해진 시간 안에 받아 주는 요청 수의 상한입니다. 업비트는 요청을 그룹으로 나눠 그룹마다 상한을 둡니다.

업비트 요청 수 제한 문서의 숫자는 이렇습니다.

• 시세 조회: 종목·캔들·체결·현재가·호가 그룹마다 초당 10회, IP 단위
• 일반 요청: default 그룹, 자산·주문 조회와 취소 등 초당 30회
• 새 주문: order 그룹 초당 12회
• 주문 테스트: order-test 그룹 초당 8회
• 전체 취소: order-cancel-all 그룹 2초에 1회
• 웹소켓: 연결 초당 5회, 메시지 초당 5회와 분당 100회

시세는 IP 단위로 세고, 주문 쪽은 포켓 단위로 셉니다. 같은 집에서 프로그램 두 개를 돌리면 시세 한도를 둘이 나눠 쓰는 셈입니다.

간단히 계산해 보면, 종목 20개(가정)의 현재가를 하나씩 따로 1초마다 물으면 1초에 20번이라 시세 한도 10회를 넘습니다. 만들기 전에 1초에 요청을 몇 번 보내는 구조인지부터 세어 보는 것이 좋습니다.

한도를 넘으면 429 Too Many Requests 가 돌아옵니다. 문서는 다음 1초가 시작될 때까지 기다렸다 다시 보내라고 안내합니다.

429 를 되풀이하면 418 이 오고, 같은 IP 나 포켓, 연결이 잠시 막힙니다. 응답에 적힌 차단 시간 뒤에 다시 보내야 하고, 위반이 이어지면 막히는 시간이 점점 길어진다고 적혀 있습니다.

남은 횟수는 응답 머리의 Remaining-Req 에서 읽습니다. 여기서 sec 가 지금 남은 횟수이고, 0 이면 그 그룹에는 잠시 보내지 않습니다. 같은 줄의 min 은 더 이상 쓰지 않는 값이라 보지 말라고 되어 있습니다.

주문 직전 단계는 주문 테스트로 미리 볼 수 있습니다. 문서는 이 요청이 실제 주문을 만들지 않고 주문 요청 형식과 주문 가능 여부만 검증한다고 적었습니다(주문 테스트).

4.주문 단위: 호가 단위와 최소 주문 금액

호가 단위는 주문 가격을 정할 수 있는 가장 작은 칸입니다. 값대가 높을수록 칸이 커집니다.

원화 마켓 문서 표에서 100만 원 이상은 1,000원, 10만~50만 원은 100원, 1천~5천 원은 1원 단위입니다(원화 마켓 주문 단위).

최소 주문 가능 금액은 5,000원입니다. 같은 문서에는 2025년 7월 31일부로 호가 정책이 바뀌었다는 안내도 있습니다.

표를 코드에 그대로 박아 두면 정책이 바뀔 때 주문이 막힐 수 있습니다. 주문 가능 정보 조회를 부르면 종목마다 매수·매도 수수료율과 최소 주문 금액이 돌아옵니다(주문 가능 정보 조회).

5.만들기 전에 많이 묻는 것

봇 종류별 수수료는 코인 자동매매 봇 비교에, 해외 거래소의 키 권한 문답은 바이낸스 자동매매 프로그램에 정리했습니다.

히든픽은 픽 주인이 공개하지 않는 배팅 규칙을 서버에 두고, 추천 코드로 받은 사람의 PC에서 그대로 돌려 주는 윈도우 프로그램입니다. 지금은 스테이크(stake.com)의 에볼루션 라이브 바카라에서 돌아갑니다. 프로그램이 하는 일과 하지 않는 일은 바카라 자동 배팅 프로그램 안내에 있습니다. 국가대표 픽스터를 대모집 중이며, 국가대표가 되면 12,000달러 상당의 혜택(1년 이용권)을 드립니다(지원: hiddenpick.my/pickster).

← 읽을거리