DB증권 API · 신청부터 토큰 발급까지 방법

사용 신청 순서

포털은 Open API가 당사 계좌를 보유한 개인·법인 고객에게 제공된다고 설명합니다. 따라서 계좌가 먼저 있어야 하며 개설은 비대면 계좌개설 글에 정리했습니다. 제휴법인은 별도 문의와 승인이 필요하다고 표기되고, 일반법인의 홈페이지 신청은 2026년 8월 이후 열 예정이라는 문구가 있었습니다.

1. DB증권 홈페이지에서 공동인증서로 로그인합니다.
2. 온라인지점 메뉴의 OpenAPI 신청 화면으로 들어갑니다.
3. 신청 가능 상태의 계좌를 고릅니다. 최대 3계좌까지 신청할 수 있습니다.
4. 이용약관을 확인하고 동의한 뒤 사용 신청을 합니다.
5. 신청 화면에서 계좌별 앱키(APP_KEY)와 시크릿(APP_SECRET)을 확인합니다.

모의투자용 키는 따로 발급되며 키의 유효기간은 개인 신청일부터 1년, 법인 3개월입니다. 원문은 이용절차 안내와 플랫폼 소개입니다.

접근토큰과 파이썬 호출 흐름

접근토큰은 POST 방식으로 발급합니다. 요청 경로는 oauth2/token이고 본문에는 grant_type을 client_credentials로 두고 앱키와 시크릿을 넣습니다. 헤더의 content-type은 application/json입니다. 파이썬에서는 requests 라이브러리의 post로 이 요청을 보내고, 응답 JSON의 access_token 값을 꺼내 이후 호출에 쓰는 흐름입니다. 기본 주소와 8443 포트는 이용절차 안내에 표기되어 있어 이 글에서는 풀어 쓰지 않습니다.

• 이용절차 안내는 접근토큰 유효기간을 24시간이라고, 플랫폼 소개는 신청일시로부터 익일 07시까지라고 적어 표기가 다릅니다. 어느 쪽이 맞는지는 미확인입니다.
• 샘플코드 저장소 설명은 유효기간 안에 발급하면 같은 토큰이 나오고, 재발급하려면 기존 토큰을 폐기해야 한다고 적습니다.
• 키와 시크릿은 코드에 직접 쓰지 말고 환경변수나 별도 설정 파일로 분리하는 방식이 일반적입니다.

지원 기능과 제한

포털 첫 화면은 API 분류를 국내주식주문, 국내선물옵션주문, 해외주식주문, 국내주식시세, 국내선물옵션시세, 해외주식시세로 보여 줍니다. 샘플코드 저장소는 해외선물옵션, 장내채권, 실시간 웹소켓까지 다룬다고 소개합니다.

이 제한은 저장소 안내이며 포털 약관의 숫자와 다를 수 있어 약관이 기준입니다. 해외주식 주문 API는 해외주식 거래신청 후 이용할 수 있다는 안내가 있습니다.

자동매매 전에 알아 둘 점

• 샘플코드는 참고용이며 오작동, 매매 손실, 데이터 오류로 인한 손해에 책임을 지지 않는다고 저장소가 밝힙니다.
• 주문이 실제로 나갈 수 있으므로 모의투자 환경에서 먼저 시험하라는 문구가 있습니다.
• 앱키와 시크릿 유출에 각별히 유의하라는 경고가 이용절차에 있습니다.
• 제휴법인이 시세를 앱·웹에 보여 줄 때는 거래소 시세 이용계약을 따로 맺어야 한다고 표기됩니다.

2026-09-08 보도된 Open API 이벤트(신규·휴면 고객 대상 수수료 우대)는 신청이 10월 30일까지로 알려졌습니다. 상세 조건은 미확인이며 수수료 글의 이벤트 설명과 같습니다.