Kauriq by Ninhle · Mã nguồn mở · MIT
Phần lớn chiến lược trông rất đẹp trong backtest lại thất bại ở một trong ba điểm: chưa tính đủ chi phí, chỉ tốt trên đoạn dữ liệu đã dùng để tinh chỉnh, hoặc vô tình “nhìn trước” dữ liệu tương lai. backtest-sanity là công cụ Python miễn phí của Kauriq giúp bạn kiểm tra cả ba điều đó chỉ trong một phút, với một file CSV các lệnh đã đóng hoặc chính hàm tín hiệu của bạn.

backtest-sanity kiểm tra những gì?
- Chi phí thật: trừ phí giao dịch, trượt giá và chi phí nắm giữ vị thế trên từng lệnh, rồi cho bạn biết chi phí lấy đi bao nhiêu phần lợi thế gộp và mức phí hòa vốn là bao nhiêu.
- Out-of-sample: so sánh kết quả trước và sau một mốc hold-out mà bạn chọn trước khi nhìn số liệu, để biết lợi thế có còn tồn tại trên dữ liệu chưa dùng hay không.
- Lookahead: tính tín hiệu trên toàn bộ lịch sử, rồi tính lại trên lịch sử bị cắt ngắn. Nếu giá trị thay đổi khi có thêm dữ liệu về sau, tín hiệu đã dùng thông tin từ tương lai (cửa sổ căn giữa, shift âm, chuẩn hóa trên toàn mẫu…).
Ví dụ: đẹp trên giấy, hết lợi thế khi tính đủ chi phí

Kho mã kèm sẵn một chiến lược giả lập “trông ổn”: lợi nhuận gộp trung bình +0,170% mỗi lệnh, tỉ lệ thắng 61,7%. Khi thêm phí 5 bps, trượt giá 2 bps mỗi chiều và chi phí nắm giữ, 87% lợi thế gộp biến mất và tỉ lệ thắng còn 50,8%. Tách dữ liệu từ mốc hold-out, phần out-of-sample cho kết quả âm. Đây chính là loại chiến lược bạn muốn phát hiện trước khi đặt niềm tin vào nó.
Cài đặt và chạy trong 1 phút
pip install git+https://github.com/kauriq/backtest-sanity backtest-sanity costs trades.csv --fee-bps 5 --slippage-bps 2 backtest-sanity split trades.csv --fee-bps 5 --slippage-bps 2 --holdout-from 2025-06-01
Yêu cầu Python 3.10 trở lên, chỉ phụ thuộc pandas và numpy. Thêm --json để nhận kết quả dạng máy đọc được. Kiểm tra lookahead dùng trực tiếp trong Python với hàm check_lookahead(signal_fn, bars).
Dữ liệu đầu vào
| Cột | Ý nghĩa |
|---|---|
entry_time, exit_time |
Thời điểm vào/ra lệnh (UTC) |
side |
long / short (hoặc buy / sell, 1 / -1) |
entry_price, exit_price |
Giá khớp trung bình |
symbol |
Tùy chọn, dùng để ghép chi phí nắm giữ theo mã |
Dành cho ai?
- Lập trình viên Python và người làm phân tích định lượng đang tự viết, tự kiểm thử chiến lược.
- Sinh viên, người học data science / tài chính muốn hiểu vì sao backtest thường “đẹp hơn thực tế”.
- Nhóm nghiên cứu cần một bước kiểm tra nhanh, minh bạch, dễ đưa vào quy trình CI.
Công cụ này không làm gì
- Không tìm chiến lược, không đưa tín hiệu, không gợi ý nên giao dịch gì.
- Vượt qua cả ba kiểm tra là điều kiện cần, chưa phải điều kiện đủ: không có nghĩa chiến lược sẽ sinh lời.
- Kiểm tra out-of-sample chỉ trung thực khi bạn chọn mốc hold-out trước khi xem kết quả.
Miễn phí, mã nguồn mở theo giấy phép MIT. Xem mã, cài đặt và góp ý trực tiếp trên GitHub.
Câu hỏi thường gặp
backtest-sanity có miễn phí không?
Có. Công cụ phát hành theo giấy phép MIT, bạn được dùng, sửa và tích hợp vào dự án của mình, kể cả mục đích thương mại.
backtest-sanity kiểm tra backtest những gì?
Công cụ kiểm tra ba điều: chi phí thật (phí, trượt giá, chi phí nắm giữ), kết quả out-of-sample sau mốc hold-out, và lỗi lookahead khi tín hiệu dùng thông tin từ tương lai.
Tôi cần chuẩn bị gì để dùng?
Bạn cần Python 3.10 trở lên và một file CSV các lệnh đã đóng, hoặc hàm tín hiệu nếu muốn kiểm tra lookahead. Công cụ chỉ phụ thuộc pandas và numpy.
Công cụ có đưa ra tín hiệu hay chiến lược giao dịch không?
Không. Công cụ chỉ kiểm tra backtest bạn đã có, không tạo chiến lược, không dự báo và không khuyến nghị đầu tư.
Tôi báo lỗi hoặc góp ý ở đâu?
Bạn có thể mở issue trên kho GitHub hoặc gửi email tới hi@ninhle.com.






Đánh giá
Chưa có đánh giá nào.