PyQQQ SDK
PyQQQ SDK(pyqqq) 는 PyQQQ 플랫폼에서 퀀트 전략을 개발하기 위한 Python SDK입니다.
국내 주식·선물옵션 시장 데이터 조회와 증권사(한국투자증권, LS증권) 연동 기능을 제공하며, 데이터 분석부터 자동 매매 전략 운영까지 하나의 SDK로 처리할 수 있습니다.
주요 기능
- 시장 데이터 조회 — 국내/미국 주식의 일봉·분봉·틱, 지수, 파생상품 데이터 (
pyqqq.data) - 증권사 연동 — 한국투자증권(KIS), LS증권(eBest) OAuth 인증, 시세 조회, 주문/체결 (
pyqqq.brokerage) - 실시간 추적 — WebSocket 기반 주문·포지션 이벤트 트래커 (
TradingTracker) - 백테스팅 — 과거 데이터 기반 전략 검증 프레임워크 (
pyqqq.backtest)
설치
pip install pyqqq
Python 3.9 이상을 지원합니다. (3.11 이상 권장)
API Key 설정
시장 데이터 조회에는 PyQQQ API Key가 필요합니다. pyqqq.net 회원가입 후 프로필 페이지에서 발급받을 수 있습니다.
발급받은 키는 다음 중 한 가지 방법으로 설정합니다.
# 방법 1: ~/.qred 파일에 저장
echo "your-api-key" > ~/.qred
# 방법 2: 환경변수로 설정
export PYQQQ_API_KEY="your-api-key"
빠른 시작
일봉(OHLCV) 데이터 조회
import datetime as dtm
from pyqqq.data.daily import get_ohlcv_by_codes_for_period
codes = ["005930", "000660"] # 삼성전자, SK하이닉스
ohlcv = get_ohlcv_by_codes_for_period(codes, dtm.date(2025, 1, 6), dtm.date(2025, 1, 10))
for code, df in ohlcv.items():
print(f"code: {code}")
print(df)
증권사 API로 시세 조회 (한국투자증권)
from pyqqq.brokerage.kis.oauth import KISAuth
from pyqqq.brokerage.kis.simple import KISSimpleDomesticStock
auth = KISAuth(app_key="...", app_secret="...")
stock = KISSimpleDomesticStock(auth, account_no="...", account_product_code="01")
price = stock.get_price("005930") # 삼성전자 현재가
print(price)
더 많은 예제는 튜토리얼 문서에서 확인할 수 있습니다.
문서
전체 문서는 docs.pyqqq.net 에서 제공됩니다.
라이선스
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pyqqq-0.12.244.tar.gz.
File metadata
- Download URL: pyqqq-0.12.244.tar.gz
- Upload date:
- Size: 225.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/1.8.3 CPython/3.11.7 Linux/6.12.85+
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d3539b8581f36b2ec70a504954acce127b16ae9e91a8dd86053ffa541e50463d
|
|
| MD5 |
90b31f951382c17df201545a574a8616
|
|
| BLAKE2b-256 |
30d1ce4a94104633b1d866bb96051dc96c442d38b4fbfa86033971183e228ccc
|
File details
Details for the file pyqqq-0.12.244-py3-none-any.whl.
File metadata
- Download URL: pyqqq-0.12.244-py3-none-any.whl
- Upload date:
- Size: 259.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/1.8.3 CPython/3.11.7 Linux/6.12.85+
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
97f0dd79b276c788b2696a1d330894743cc1cadab238e5fc4cc1e52ea9c32c0c
|
|
| MD5 |
677cf84e0b5b477318bdf8a8b9ed4562
|
|
| BLAKE2b-256 |
63f6597d565fff6bf9f710db6141e64e67cd0e147e068dbb3cfa5f9b445217b5
|
