준비 및 설치하기¶
이 페이지에서 배울 내용
Python 환경 설정 방법
PyQQQ CLI 및 SDK 설치
API Key 발급 및 저장
첫 번째 코드 실행 (Quick Start)
Python 설치¶
PyQQQ SDK는 Python 3.11 이상을 필요로 합니다.
conda를 사용하는 경우 아래 명령으로 Python 버전을 변경합니다.
conda install python=3.11.7
Tip
아직 conda가 없다면 Miniconda 무료 버전을 설치하세요.
VSCode를 설치합니다.
Python 확장(ms-python.python)을 설치합니다.
Ctrl+Shift+P→Python: Select Interpreter에서 3.11 이상 인터프리터를 선택합니다.
Tip
VSCode 터미널(`Ctrl+``)을 열면 선택한 Python 환경이 자동으로 활성화됩니다.
CLI 설치¶
CLI 도구는 전략 배포와 관리에 사용됩니다.
pip install pyqqq-cli
정상 설치 확인:
qqq --help
Usage: qqq [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Commands:
delete 배포된 전략 삭제
deploy 전략 배포
list 배포된 전략 목록 조회
logs 배포된 전략의 로그 조회
API Key 저장¶
PyQQQ 서비스를 사용하려면 API Key가 필요합니다.
API Key 발급 방법:
API Key 저장:
API Key를 $HOME/.qred 파일에 저장합니다.
echo "your-api-key-here" > ~/.qred
"your-api-key-here" | Out-File -FilePath "$HOME\.qred" -Encoding utf8
저장 후 아래 명령으로 정상 동작을 확인합니다.
qqq list
# No strategies deployed
SDK 설치¶
pip install pyqqq
빠른 시작¶
SDK 설치가 완료되었습니다. 아래 예제로 첫 번째 데이터 조회를 실행해보세요.
시가총액 조회
import datetime as dtm
import pyqqq
from pyqqq.data.domestic import get_market_cap_by_codes
# API Key 설정 (환경변수 또는 ~/.qred 파일로 설정한 경우 생략 가능)
# pyqqq.set_api_key("your-api-key")
# 삼성전자 시가총액 조회
marcap = get_market_cap_by_codes(["005930"], dtm.date(2024, 12, 30))
print(marcap)
market type value shares
code
005930 KOSPI EQUITY 317592431660000 5969782550
OHLCV 가격 데이터 조회
import datetime as dtm
from pyqqq.data.daily import get_ohlcv_by_codes_for_period
# 삼성전자 일별 OHLCV
ohlcv = get_ohlcv_by_codes_for_period(["005930"], dtm.date(2025, 1, 6), dtm.date(2025, 1, 10))
print(ohlcv["005930"])
open high low close volume value
date
2025-01-10 56100 56500 55200 55300 16059223 893461579301
2025-01-09 57600 57700 56100 56100 24490592 1390326401200
2025-01-08 54800 57500 54700 57300 26593553 1508091102443
2025-01-07 56800 57300 55400 55400 17030235 957161571300
2025-01-06 54400 56200 54300 55900 19034284 1058888590642