API 키를 서버에 저장하고 사용하기#

PyQQQ에서 제공하는 증권사 API 관리 기능을 활용하면 암호화된 API 정보를 손쉽게 사용할 수 있습니다.

증권사 API 등록하기#

증권사 API 관리 페이지에서 우측에 있는 API 등록 버튼을 누릅니다.

../_images/api_kms.png

팝업이 보이면 API 이름과 증권사를 선택하여 API 정보를 기입합니다. API 이름은 추후 파이썬 코드에서 사용되므로 짧지만 명료한 이름이 좋습니다. 한번 등록된 API 정보는 수정할 수 없으며 삭제 후 등록을 해주셔야 합니다.

사용 예시#

환경변수 설정#

## 이전에 등록한 API 이름을 ACCOUNT_NICK의 값으로 설정합니다.
ACCOUNT_NICK=한투ISA

사용하기#

from pyqqq.brokerage.helper import PyQQQAutoConnectionSingleton

# 싱글톤 인스턴스 생성
conn = PyQQQAutoConnectionSingleton()

# 계좌 정보 조회
account_info = conn.broker_simple.get_account()

# 모의투자 사용 시
if conn.paper_broker_simple:
    paper_account_info = conn.paper_broker_simple.get_account()

주요 속성#

  • auth: 인증 객체

  • broker_code: 브로커 코드 (“kis” 또는 “ebest”)

  • broker: 일반 거래용 브로커 객체

  • broker_simple: 간편 거래용 브로커 객체

  • paper_auth: 모의투자 인증 객체 (설정된 경우)

  • paper_broker_simple: 모의투자 간편 브로커 객체 (설정된 경우)

주의사항#

  1. 환경변수가 설정되지 않은 경우 NoConnection 인스턴스가 반환됩니다.

  2. 싱글톤 패턴이 적용되어 있어 여러 번 인스턴스화해도 동일한 객체가 반환됩니다.

  3. 모의투자 기능은 각 브로커별로 별도의 환경변수 설정이 필요합니다.

On this page
Show Source