증권사 연동 전에 — 토스·키움에 서버 IP 등록하기

증권사 API 키는 비밀번호와 같습니다. 키가 새어 나가면 남이 내 계좌로 주문을 낼 수 있습니다. 그래서 토스증권과 키움증권은 키와 함께 미리 등록한 IP 주소를 확인하고, 목록에 없는 주소에서 온 호출은 막습니다. 키가 유출되더라도 등록한 주소 밖에서는 쓸 수 없게 하는 장치입니다.

이 서비스에서 실계좌 잔고를 읽고, 주문을 내고, 위임한 자동매매를 돌리는 것은 사용자의 PC가 아니라 서버입니다. 브라우저를 닫아도 위임이 계속 도는 이유가 그것입니다. 따라서 증권사에 등록해야 하는 주소도 사용자의 집이나 회사 주소가 아니라 서버의 주소입니다.

등록할 IP

49.247.204.161

이 글이 다루는 증권사

토스증권 · 키움증권

그 주소에서 나가는 호출

잔고·주문 이력 동기화, 주문·취소, 위임 자동매매

증권사 화면의 '현재 나의 IP' 는 지금 그 화면을 보고 있는 PC의 주소입니다. 그 값을 등록하면 증권사 사이트에서는 정상으로 보이지만, 이 서비스에서는 연동이 실패합니다. 반드시 49.247.204.161 를 직접 입력하십시오.

토스증권 Open API는 키를 발급받은 클라이언트마다 허용 IP 목록을 둡니다. 목록에 없는 주소에서 토큰을 받으려 하면 첫 단계에서 거절됩니다. 토스증권 공식 API 명세의 안내 경로는 토스증권 WTS(웹) 설정 → Open API → 허용 IP 관리 입니다.

1. 컴퓨터 브라우저에서 토스증권 웹(WTS)에 로그인합니다.
2. 설정에서 Open API 메뉴로 들어가 API 키(클라이언트 ID와 클라이언트 시크릿)를 발급받습니다. 시크릿은 다시 볼 수 없는 경우가 많으니 바로 안전한 곳에 적어 둡니다.
3. 같은 메뉴의 허용 IP 관리 에서 IP 추가를 누르고 49.247.204.161 를 입력해 저장합니다.
4. 목록에 방금 넣은 주소가 보이는지 확인합니다. 오타가 한 자리라도 있으면 다른 주소로 취급됩니다.
5. 이 서비스의 설정 → 증권사 연동 → 토스증권 → 연동하기 에서 App Key 칸에 클라이언트 ID를, App Secret 칸에 클라이언트 시크릿을 넣고 계좌 종류를 실계좌로 골라 저장합니다.

IP를 빠뜨렸을 때

토큰 발급이 HTTP 403 으로 거절되고 응답에 "IP address not allowed"(access_denied)가 옵니다. 키 값이 틀린 것이 아니므로 키를 다시 발급받을 필요는 없습니다. 허용 IP 목록에 서버 주소만 더하면 됩니다.

키 값이 틀렸을 때

이때는 403 이 아니라 401(invalid_client)이 옵니다. 복사할 때 앞뒤에 공백이 붙었거나 ID와 시크릿을 바꿔 넣은 경우가 대부분입니다.

같은 키를 다른 프로그램과 함께 쓸 때

토스증권은 클라이언트 하나에 유효한 접근 토큰을 하나만 둡니다. 새로 받으면 이전 토큰이 즉시 무효가 됩니다. 이 서비스에 넣은 키를 다른 자동매매 프로그램에서도 쓰면 두 쪽이 번갈아 서로의 토큰을 끊습니다. 이 서비스용 키는 따로 발급받으십시오.

키움 REST API는 IP 등록이 App Key 발급보다 먼저 오는 필수 단계입니다. 키움 포털의 서비스 이용 안내에 따르면 절차는 서비스 신청 → 약관 동의 → IP 등록 → 계좌 등록 → 키 다운로드 순서입니다. App Key는 계좌 하나에 묶여 발급되므로, 주문 요청에 계좌번호를 따로 싣지 않고 그 키에 등록된 계좌로 주문이 나갑니다.

1. 키움 REST API 포털(openapi.kiwoom.com)에 로그인합니다. 키움증권 계좌가 있어야 합니다.
2. 오른쪽 위 API 사용신청 을 눌러 이용약관과 개인정보 수집에 동의합니다.
3. 계좌 App Key 관리 탭으로 갑니다. 실전투자와 모의투자가 별도 탭이므로 반드시 실전투자 쪽에서 진행합니다.
4. IP 등록 및 현황 의 IP 주소등록 칸에 49.247.204.161 를 입력하고 추가 를 누릅니다. 아래 표에 주소가 나타나는지 확인합니다.
5. 자동매매에 쓸 계좌를 등록합니다. 계좌 비밀번호와 휴대폰 문자 인증을 거칩니다.
6. App Key와 Secret Key 파일을 내려받습니다. 다운로드는 한 번만 가능하고 그 뒤에는 비활성화되므로, 잃어버리면 갱신으로 다시 발급받아야 합니다.
7. 이 서비스의 설정 → 증권사 연동 → 키움증권 → 연동하기 에서 App Key와 Secret Key를 넣고, 계좌번호를 적고, 계좌 종류를 실계좌로 골라 저장합니다. 계좌번호는 잔고 기록을 구분하는 데만 쓰입니다.

등록 가능한 IP

최대 10개 — 쓰지 않는 주소는 지웁니다

실전 / 모의 키

따로 관리 · 이 서비스에는 실전 키를 넣습니다

키 파일 다운로드

1회만 가능

접근 토큰 유효기간

24시간 (서비스가 알아서 다시 받습니다)

이미 키를 발급받았는데 서버 주소를 넣지 않았다면 키를 새로 받을 필요는 없습니다. 같은 계좌 App Key 관리 → IP 등록 및 현황 에서 주소를 추가하면 됩니다. PC에서 쓰려고 집 주소를 넣어 두었다면 그 주소는 그대로 두고 서버 주소를 하나 더 넣으면 됩니다.

8010 — Token을 발급받은 IP와 서비스를 요청한 IP가 동일하지 않습니다

서버 주소가 등록되지 않았거나, 토큰을 받은 곳과 호출한 곳의 주소가 다를 때 납니다. 등록 목록에 서버 주소가 있는지 먼저 확인합니다.

8001 · 8002 — App Key와 Secret Key 검증에 실패했습니다

키 값이 틀렸습니다. 내려받은 파일에서 다시 복사하되 앞뒤 공백을 확인합니다.

8030 · 8031 — 투자구분(실전/모의)이 달라서 사용할 수 없습니다

모의투자 탭에서 받은 키를 넣었거나, 실전 키에 모의 계좌를 고른 경우입니다. 실전투자 탭의 키를 넣고 계좌 종류를 실계좌로 둡니다.

1. 설정에서 저장하면 증권사 이름 옆이 연동됨 으로 바뀝니다. 이것은 키를 저장했다는 뜻이지 증권사가 받아 줬다는 뜻은 아닙니다.
2. 계좌 관리 에서 그 증권사 계좌를 골라 동기화를 누릅니다. 보유 잔고와 예수금이 증권사 앱과 같게 나오면 연동이 끝난 것입니다.
3. 동기화가 실패하면 화면에 나온 오류 문구를 위의 표와 맞춰 봅니다. IP 문제는 증권사 쪽 설정만 고치면 되고, 이 서비스에서 키를 다시 넣을 필요는 없습니다.

주문을 시험하려고 실계좌에서 바로 큰 주문을 내지 마십시오. 연동 확인은 잔고 동기화로 충분합니다. 주문은 확인 문구를 직접 입력해야 나가며, 자동매매는 모의 계좌에서 먼저 돌려 보는 것이 순서입니다.

• 서버를 옮기면 주소가 바뀝니다. 그때는 공지와 함께 이 글과 설정 화면의 주소가 바뀌고, 증권사에도 새 주소를 넣어야 합니다. 옛 주소 49.247.204.161 는 그 뒤에 지우면 됩니다.
• IP 등록은 보안 장치입니다. 키가 새어 나가도 등록한 주소 밖에서는 쓰지 못하게 하는 것이므로, 쓰지 않는 주소를 목록에 쌓아 두지 마십시오.
• 키는 이 서비스에 암호화되어 저장됩니다. 화면에는 다시 표시되지 않고, 바꾸려면 키 교체로 새 값을 넣습니다. 연동을 끊고 싶으면 설정에서 해제하고 증권사 포털에서도 키를 폐기하십시오.
• 메뉴 이름과 위치는 증권사가 화면을 고치면 바뀔 수 있습니다. 이 글은 2026년 10월 기준 토스증권 API 명세와 키움 포털 안내를 따릅니다.