준비 및 설치하기¶
이 페이지에서 배울 내용
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 pyqqq
# API Key 설정 (환경변수 또는 ~/.qred 파일로 설정한 경우 생략 가능)
# pyqqq.set_api_key("your-api-key")
# 삼성전자 시가총액 조회
marcap = pyqqq.get_marcap("005930")
print(marcap)
market type value shares
code
005930 KOSPI EQUITY 317592431660000 5969782550
OHLCV 가격 데이터 조회
import pyqqq
# 삼성전자 일별 OHLCV (2024년)
ohlcv = pyqqq.get_ohlcv("005930", "2024-01-01", "2024-12-31")
print(ohlcv.tail())
open high low close volume
date
2024-12-24 53700 54200 53400 54100 12345678
2024-12-26 53900 54300 53600 53800 11234567
...