




입력 항목: App Key,Secret Key,종목코드,주문수량,주문단가
· 본 예시 코드는 사용자 개발 환경에 따라 모듈 설치 및 코드 수정이 필요할 수 있으며,
당사가 코드 실행 및 실행 결과를 보장하지 않습니다.
· 개발 환경에서 코드 실행 및 변수값 입력 시 즉시 서버에 주문이 전송되므로
코드 실행 시 유의하여 주시기 바랍니다.
import requests
import json
# 접근토큰 발급
def fn_au10001(data):
# 1. 요청할 API URL
host = 'https://api.kiwoom.com' # 실전투자
endpoint = '/oauth2/token'
url = host + endpoint
# 2. header 데이터
headers = {
'Content-Type': 'application/json;charset=UTF-8', # 컨텐츠타입
}
# 3. http POST 요청
response = requests.post(url, headers=headers, json=data)
token = response.json().get('token')
return token
# 주식 매수주문
def fn_kt10000(token, data, cont_yn='N', next_key=''):
# 1. 요청할 API URL
host = 'https://api.kiwoom.com' # 실전투자
endpoint = '/api/dostk/ordr'
url = host + endpoint
# 2. header 데이터
headers = {
'Content-Type': 'application/json;charset=UTF-8', # 컨텐츠타입
'authorization': f'Bearer {token}', # 접근토큰
'cont-yn': cont_yn, # 연속조회여부
'next-key': next_key, # 연속조회키
'api-id': 'kt10000', # TR명
}
# 3. http POST 요청
response = requests.post(url, headers=headers, json=data)
# 4. 응답 상태 코드와 데이터 출력
print(json.dumps(response.json(), indent=4, ensure_ascii=False)) # JSON 응답을 파싱하여 출력
# 실행 구간
if __name__ == '__main__':
# 1. 사용자 입력
appkey = input("APPKEY를 입력하세요: ").strip()
secretkey = input("SECRETKEY를 입력하세요: ").strip()
stk_cd = input("종목코드 (예: 005930): ").strip()
ord_qty = input("주문수량 (예: 1): ").strip()
ord_uv = input("주문단가 (지정가주문): ").strip()
# 2. 토큰 발급 요청
token_params = {
'grant_type': 'client_credentials',
'appkey': appkey,
'secretkey': secretkey,
}
MY_ACCESS_TOKEN = fn_au10001(data=token_params)
# 3. 주문 요청 파라미터
order_params = {
'dmst_stex_tp': 'SOR', # 거래소 구분
'stk_cd': stk_cd,
'ord_qty': ord_qty,
'ord_uv': ord_uv,
'trde_tp': '0', # 0: 보통(지정가) 주문
'cond_uv': '',
}
# 4. 주식 주문 실행
fn_kt10000(token=MY_ACCESS_TOKEN, data=order_params)

* 홈페이지 신청 경로 안내 (모바일에서는 신청 불가)
. 홈페이지 > 트레이딩 채널 > 키움 REST API
. 홈페이지 > 고객서비스 > 다운로드 > Open API > 키움 REST API


신규 오픈 기념 REST API 거래 이벤트
기간: 2025.08.21(목) ~ 2025.10.31(금)
대상
키움 계좌로 REST API 최초 거래 고객
* 25.08.21 이후 키움 계좌로 REST API 최초 거래 발생 고객
거래 대상 : 국내주식(코스피,코스닥,ETF,ETN)
* 코넥스, ELW 제외
REST API 신청 방법(모바일에서는 신청 불가)
키움 REST API 홈페이지 접속
* openapi.kiwoom.com
1.API 사용 신청(로그인 필수)
2.IP 등록 및 계좌 App Key 발급
EVENT 1.
REST API로 거래하면,
최대 2만원 현금 혜택을 드려요!
1원 이상 거래하면 - 현금 1만원 지급(전원)
100만원 이상 거래하면 - 현금 1만원 추가 지급(전원)
- 당사 사정에 따라 조기 종료될 수 있습니다. (단, 기 달성 고객 제외)
- 현금 지급은 이벤트 종료일 이후 2주일 이내에 고객님의 당사
- 보유한 입금 가능한 위탁 계좌로 지급됩니다. (폐쇄 계좌 지급 불가)
키움 REST API 소개
다양한 OS와 프로그래밍 언어를 지원하여,
누구나 쉽게 별도 설치없이 웹 기반으로 본인 만의
트레이딩 시스템을 구축할 수 있습니다.
01. 멀티 OS : 윈도우, 맥, 리눅스 등 다양한 운영체제 이용 가능
02. AI 코딩 어시스턴트 : 생성형 AI와 RAG를 활용하여 API 작성 지원
03. 미설치형 : OCX 방식에서 벗어나 설치하지 않고 이용 가능
04. 다양한 개발 언어 : 파이썬 & 자바 등 다양한 언어 이용 가능
REST API, 이런 분들께 추천해요!
* 나만의 조건부 자동 매매를 구현하고 싶은 분!
* 주기적인 리밸런싱 전략을 자동화하고 싶은 분!
* 여러 계좌/종목을 동시에 관리/모니터링하고 싶은 분!
키움 REST API
매수주문 따라해보기
모바일에서는 REST API 코드 뷰어를 제공하지 않습니다.
아래 경로를 통해 PC 이벤트 페이지에서 확인해주세요.
홈페이지(PC) > 진행중 이벤트 > REST API 거래 이벤트
이벤트참여안내
본 이벤트는 ‘이벤트 신청하기’를 통하여 개인(신용)정보 선택 동의서에 따라 선택/서비스 안내 등에 동의하신 고객에 한하여 참여 됩니다. (이벤트 신청 필수)
본 이벤트는 임직원 및 법인고객은 제외됩니다.
본 이벤트의 혜택을 받으시려면, 키움 API 사용 신청이 필요합니다.
본 이벤트는 금융당국의 지도 및 당사 사정에 따라 변경되거나 중단될 수 있습니다.(단, 기 조건 충족 고객 제외)
본 이벤트는 이벤트 시행일(25.08.21) 이후 키움 계좌로 REST API 거래가 최초 발생한 고객을 대상으로 합니다.
본 이벤트의 REST API 거래금액은 이벤트 기간 내 체결한 국내주식(코스피, 코스닥, ETF, ETN)을 대상으로 합니다. (코넥스, ELW 거래금액 제외)
본 이벤트는 키움증권 REST API를 통해 국내주식을 1원 이상 거래한 고객
에게 현금 1만원, 100만원 이상 거래한 고객에게 현금 1만원을 추가 지급
합니다. (100만원 이상 거래 시 최대 2만원 지급)
본 이벤트의 현금 지급은 이벤트 종료일 이후 2주일 이내에 고객님의 당사 보유한 입금 가능한 일반 위탁 계좌로 지급되며, 중개형 ISA, 연금저축, 캐치전용계좌, 키워드림론 계좌 등은 지급 불가합니다. (현금 지급 전 계좌 폐쇄 시 지급 불가)
[당사 홈페이지 > 이벤트 > 당첨자 발표]에서 당첨자 명단을확인할 수 있습
니다. (이벤트 종료일 이후 2~3주 이내 게시 예정)
당사에서 기타소득 신고 납부 후에는 당사의 귀책사유가 아닌 경우 정정 및 취소가 불가합니다.
원활한 경품 지급 및 금융사기 예방을 위하여 고객정보는 반드시 최신 정보로 관리하시기 바랍니다.
본 이벤트는 금융당국의 지도 및 당사 사정에 따라 변경되거나 중단될 수 있습니다. (단, 기 조건 충족 고객 제외)
허수성거래, 가정통정성 거래 등 불공정거래(공정거래질서 저해행위 포함)로 판단되는 경우 당첨 자격이 박탈됩니다.
본 이벤트의 동일인 한도는 20,000원이며, 동일 고객에게 지급되는 총 혜택
은 동일인 한도를 초과할 수 없습니다.
당사에서 기타소득 신고 납부 후에는 당사의 귀책사유가 아닌 경우 정정 및 취소가 불가합니다.
본 이벤트와 관련한 문의사항은 키움금융센터(T.1544-9000), 나이트데스크(T.1544-8400), 영업부에서 안내 받으실 수 있습니다.
거래유의사항
본 이벤트는 단순 서비스 안내이며, 투자권유 및 추천이 아닙니다.
투자자는 금융투자상품<주식,집합투자증권, ETN>에 대하여 키움증권으로
부터 충분한 설명을 받을 권리가 있으며, 투자전 상품설명서 등을 반드시 읽어
보시기 바랍니다.
이 금융상품<주식, 집합투자증권, ETN>은 예금자보호법에 따라 보호되지 않습니다.
금융투자상품<주식, 집합투자증권, ETN>은 <자산가격 변동>, <신용등급 하락>, <괴리율> 등에 따라 투자원금의 손실(0~100%)이 발생할 수 있으며, 그 손실은 투자자에게 귀속됩니다.
국내주식 거래 시 수수료는 0.015%(KRX), 0.0145%(NXT)이며, 기타 자세한 사항은 홈페이지 등을 참고하시기 바랍니다. NXT(넥스트레이드)는 자본시장법상 다자간매매체결회사로 대체거래소(ATS: Alternative Trading System)입니다.
ETN은 발행사의 신용위험(부도 또는 파산 등)에 따른 원금손실이 발생할 수 있습니다. (투자적격등급은 AAA/AA·A·BBB 각 +, 0, - 순으로 구분)
레버리지 상품은 투자원금 손실이 크게 발생할 수 있으며, 레버리지 펀드(2배, 인버스, 인버스 2배 등)의 기간 수익률은 추종하는 기초자산(지수)의 일간 수익률과 차이가 발생할 수 있습니다.
키움증권 준법감시인 심사필 제25-01754호(25.08.21 ~ 25.10.31)