Disclaimer
Last updated: 2026-05-14. The source of truth is the DISCLAIMER.md in the repository. If this page and that file ever disagree, the repository wins.
English
This project is for research and educational purposes only. Nothing here is investment advice, a recommendation to buy or sell any security, derivative, or cryptocurrency, an offer to manage assets, or a solicitation of any kind.
The maintainer is not a licensed investment adviser or broker-dealer in any jurisdiction. The maintainer holds no client funds and operates no pooled investment vehicle. All trading shown on this site or in the repository is paper trading executed against broker simulators (KIS mock API, IBKR paper port 7497, historical crypto exchange data).
Past performance — including paper-trade performance — does not indicate future results. The preceding 38-day crypto PoC produced a −15.1% paper PnL with a 37.7% win rate across 191 trades. This was published intentionally to demonstrate honest reporting, not to demonstrate skill.
The maintainer makes no representation or warranty as to the accuracy, completeness, timeliness, or fitness of any data, code, or documentation in this repository. Use at your own risk. By using this code or following any guidance herein, you agree that the maintainer is not liable for any loss, direct or indirect, that may result.
All trading carries a substantial risk of loss. Options trading involves additional risks (theta decay, gamma risk, assignment, pin risk) and is not suitable for all investors. Derivatives can result in losses that exceed the original investment. Cryptocurrencies are highly volatile, may be unregulated in your jurisdiction, and can lose all value.
한국어 (자본시장법 정합)
본 프로젝트는 연구·교육 목적이며 투자 권유가 아닙니다. 이 사이트 또는 저장소에서 제공하는 어떠한 정보·코드·결과도 특정 금융투자상품에 대한 매수/매도 권유, 자문, 일임 또는 신탁 권유로 해석될 수 없습니다.
관리자는 자본시장과 금융투자업에 관한 법률에 따른 투자자문업자 또는 투자일임업자, 신탁업자가 아닙니다. 어떠한 고객 자금도 수탁하지 않으며, 어떠한 풀(pool) 형태의 집합투자기구도 운영하지 않습니다. 본 저장소에서 공개되는 모든 거래는 페이퍼(모의) 거래이며, 한국투자증권 모의 OpenAPI(openapivts.koreainvestment.com), 인터랙티브 브로커즈(IBKR) 페이퍼 계정 포트 7497, 그리고 암호화폐 거래소 과거 데이터에 대해 시뮬레이션된 결과입니다.
과거 성과(페이퍼 성과 포함)는 미래 성과를 보장하지 않습니다. 38일 크립토 PoC는 191건의 모의 거래에 대해 승률 37.7%, 누적 −15.1%의 페이퍼 손익을 기록했고, 이 사실은 의도적으로 공개되었습니다. 이는 "실력"의 증명이 아니라 "정직한 보고"의 증명입니다.
관리자는 본 저장소의 자료·코드·문서의 정확성, 완전성, 적시성, 특정 목적 적합성에 대해 어떠한 보증도 하지 않습니다. 이용에 따른 모든 책임은 이용자 본인에게 있으며, 직간접 손해에 대해 관리자는 일체 책임지지 않습니다.
모든 투자에는 원본 손실 위험이 있습니다. 옵션·파생상품 거래는 시간가치 소멸, 감마·핀 리스크, 행사 배정 등 추가적인 위험을 수반하며 모든 투자자에게 적합하지 않을 수 있습니다. 가상자산은 변동성이 매우 크고 관할 법역에 따라 비규제 자산일 수 있으며 가치가 0이 될 수도 있습니다.
Live trading is technically blocked
The repository's CI workflow contains a hard guard that fails the build if any of the following ever appear in source:
openapi.koreainvestment.com(KIS production endpoint):7496(IBKR live trading port)TRADING_MODE=liveoutside of an explicit, signed opt-in path (which does not exist)
The default .env.example ships with TRADING_MODE=paper, IBKR_PORT=7497, and KIS_BASE_URL=https://openapivts.koreainvestment.com:29443 (mock).
Contact
Bugs, ethics concerns, or vulnerability reports → GitHub Security Advisories. Career inquiries → heoyesol.kr.