Qubx - 정량 트레이딩 프레임워크

⠀⠀⡰⡖⠒⠒⢒⢦⠀⠀
⠀⢠⠃⠈⢆⣀⣎⣀⣱⡀  QUBX | Quantitative Backtesting Environment
⠀⢳⠒⠒⡞⠚⡄⠀⡰⠁         (c) 2026, by xLydian
...

Qubx는 효율적인 백테스팅 및 라이브 트레이딩을 위해 설계된 차세대 정량 트레이딩 프레임워크입니다. Python으로 구축되었으며, 트레이딩 전략 개발, 테스트 및 배포를 위한 강력한 환경을 제공합니다.

Qubx는 활발하게 개발 중입니다. 저희는 지속적으로 프레임워크를 개선하고 있으며, 곧 문서도 업데이트할 예정입니다. 여기에는 시뮬레이션 및 라이브 트레이딩 실행을 위한 포괄적인 엔드투엔드(end-to-end) 예제가 포함될 것입니다.

지원되는 데이터 유형 (Supported Data Types)

Qubx는 광범위한 시장 데이터를 지원합니다:

• OHLC (캔들스틱 데이터)
• L2 오더북 (Orderbook)
• 청산액 (Liquidations)
• 펀딩 비율 (Funding rates)
• 그리고 더 많은 것...

빠른 시작 (Quick Start)

1. 종속성 설치 (Install Dependencies)

just install

2. 전략 생성 (Create a Strategy)

# 간단한 전략 템플릿 생성 (기본값)
uv run qubx init

...

3. 전략 실행 (Run Your Strategy)

cd my_strategy

# 페이퍼 트레이딩 모드로 실행
...

사용 가능한 템플릿 (Available Templates)

# 사용 가능한 전략 템플릿 목록 보기
uv run qubx init --list-templates

...

전략 개발 워크플로우 (Strategy Development Workflow)

1. 초기화 (Initialize): uv run qubx init - 템플릿에서 전략 생성
2. 개발 (Develop): strategy.py를 수정하여 트레이딩 로직 구현
3. 테스트 (Test): uv run qubx run config.yml --paper - 페이퍼 모드로 실행
4. 디버그 (Debug): ./jpaper.sh - 인터랙티브 개발을 위해 Jupyter 사용
5. 배포 (Deploy): 준비가 되면 라이브 트레이딩을 위한 설정 구성

기능 (Features)

• 고성능 백테스팅 엔진 (High-performance backtesting engine)
• 라이브 트레이딩 지원 (Live trading support)
• 고급 데이터 분석 도구 (Advanced data analysis tools)
• 다중 거래소 통합 (Integration with multiple exchanges)
• 포괄적인 전략 개발 툴킷 (Comprehensive strategy development toolkit)
• 상세 성능 분석 기능 (Detailed performance analytics)

문서화 (Documentation)

자세한 문서는 Qubx Documentation을 방문하십시오.

전제 조건 (Prerequisites)

Qubx를 빌드하고 실행하려면 다음이 필요합니다:

• Python 3.11 이상
• Cython 컴파일을 위한 C/C++ 컴파일러
• 의존성 관리를 위한 uv

설치 (Installation)

pip 사용하기

pip install qubx

개발 환경 설정 (Development Setup)

1. 저장소 클론(Clone)하기
2. uv를 사용하여 의존성 설치:

uv sync --all-extras

예제 트레이딩 전략은 examples/ 디렉토리에서 찾을 수 있습니다.

CLI 사용법 (CLI Usage)

Qubx는 여러 유용한 명령어를 제공하는 커맨드라인 인터페이스(command-line interface)를 갖추고 있습니다:

qubx --help  # 사용 가능한 모든 명령어 표시

사용 가능한 명령어:

• qubx init - 템플릿을 사용하여 새로운 전략 생성
• qubx run - 주어진 설정으로 전략 실행 시작
• qubx simulate - 전략 시뮬레이션 실행
• qubx ls - 디렉토리 내 모든 전략 목록 표시
• qubx release - 전략을 zip 파일로 패키징
• qubx deploy - zip 파일에서 전략 배포
• qubx browse - 대화형 TUI를 사용하여 백테스트 결과 탐색

개발 (Development)

테스트 실행하기 (Running Tests)

테스트 스위트(test suite)를 실행합니다:

just test

추가 명령어 (Additional Commands)

• 코드 스타일 확인: just style-check
• 패키지 빌드: just build
• 상세 테스트 실행: just test-verbose

xLydian 소개 (About xLydian)

Qubx는 xLydian에서 개발했습니다.

• 웹사이트: xlydian.com
• X(구 Twitter): @xLydian_xyz
• 문의: [email protected]

기여 (Contributing)

기여를 환영합니다! 언제든지 풀 리퀘스트(Pull Request)를 제출해 주세요.

라이선스 (License)

본 프로젝트는 GNU General Public License v3.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하십시오.