연구용 전략 코드를 그대로 실거래에 연결하는 단일 엔진
파이썬으로 작성한 전략 로직을 백테스트와 실거래 환경에서 동일하게 실행할 수 있습니다. 별도 구현 없이 같은 코드가 시뮬레이션과 라이브 시스템에서 모두 동작하므로, 배포 단계에서 생기는 불일치를 줄일 수 있습니다. 이 저장소는 다자산, 다거래소 트레이딩 시스템을 위한 오픈소스 엔진입니다.
v2 전환과 현재 상태
현재 프로젝트는 v2 릴리스 후보 단계에 있으며, 기존 v1과 API가 다릅니다. v2는 커뮤니티 테스트를 위해 PyPI에 2.0.0rcN 버전으로 공개되어 있고, 최종 2.0.0 출시 전까지는 --pre 플래그가 필요합니다. v1은 develop_v1 브랜치에서 보안 패치만 받으며, v2로의 마이그레이션 가이드가 별도로 제공됩니다. 이 기간 동안 API가 안정화되고 있지만, 릴리스 간에 깨지는 변경이 발생할 수 있으므로 주의가 필요합니다.
러스트 코어와 파이썬 제어면
엔진 코어는 러스트로 작성되어 결정적 이벤트 구동 아키텍처를 유지합니다. 파이썬은 전략 로직, 설정, 오케스트레이션을 위한 제어면으로 사용되며, PyO3 바인딩을 통해 러스트 런타임과 연결됩니다. 이 구조는 컴파일 언어의 성능과 안전성을 유지하면서 파이썬의 유연성을 살립니다. 임계 작업이 필요한 경우 전략 전체를 러스트로 작성할 수도 있습니다. 같은 전략 코드가 백테스트와 라이브 시스템에서 동일하게 실행되어 재구현 비용을 줄입니다.
지원 자산과 거래소 연결
자산 클래스에 구애받지 않고 REST API나 WebSocket 피드를 제공하는 모든 거래소를 모듈형 어댑터로 통합할 수 있습니다. 현재 크립토(CEX/DEX), 전통 시장(외환, 주식, 선물, 옵션), 베팅 거래소까지 지원 범위가 넓습니다. Binance, Bybit, Coinbase, Interactive Brokers 등 주요 거래소와 데이터 제공사가 이미 연결되어 있습니다. 각 통합은 원시 API를 통일된 인터페이스와 정규화된 도메인 모델로 변환하여 처리합니다.
정밀도 모드와 설치 요구 사항
가격, 수량, 금액 같은 핵심 값은 128비트(최대 16자리 소수)의 고정밀도 모드와 64비트(최대 9자리 소수)의 표준 정밀도 모드를 지원합니다. 공식 파이썬 휠은 기본적으로 고정밀도 모드로 제공되며, 순수 러스트 크레이트는 high-precision 기능 플래그를 명시적으로 활성화해야 합니다. 설치는 PyPI에서 사전 빌드된 휠을 받거나 소스에서 빌드하는 두 가지 방식이 있습니다. 러스트 도구체인은 사전 빌드 휠 설치 시 필요하지 않지만, 소스 빌드 시에는 최신 안정 버전의 러스트와 clang이 필요합니다. Linux 환경에서는 glibc 2.35 이상이 요구됩니다.
라이브 트레이딩 전 확인 사항
이 엔진은 단일 노드 백테스트와 라이브 트레이딩에 초점을 맞춘 오픈소스 프로젝트입니다. UI 대시보드, 분산 오케스트레이션, 내장 AI/ML 툴링은 범위에 포함되지 않습니다. 현재 v2는 릴리스 후보 단계이므로, 실제 자금을 다루는 라이브 트레이딩에는 권장되지 않습니다. 프로덕션 사용 시에는 master 브랜치의 최신 릴리스 버전을 사용하고, 개발용 휠이나 릴리스 후보는 테스트 목적으로만 활용해야 합니다. 또한 라이브 실행은 시뮬레이션이 재현하지 못하는 거래소, 전송, 타이밍, 조정 등의 변수가 있으므로 백테스트 결과와 다를 수 있음을 인지해야 합니다.
