Kauriq backtest-sanity – Công cụ kiểm tra backtest mã nguồn mở, miễn phí (Python)

backtest-sanity là công cụ Python mã nguồn mở (MIT) của Kauriq by Ninhle: ba kiểm tra trung thực cho một backtest – chi phí thật, kết quả out-of-sample và lỗi lookahead. Chỉ cần một file CSV các lệnh đã đóng hoặc hàm tín hiệu của bạn.

  • Miễn phí, giấy phép MIT
  • Python 3.10+, chỉ cần pandas & numpy
  • Chạy trên máy của bạn, kết quả có thể xuất JSON

Phần mềm, không phải khuyến nghị đầu tư.

Thanh toán an toàn được đảm bảo

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.

3 kiểm tra của backtest-sanity: chi phí, out-of-sample, lookahead
Ba kiểm tra cốt lõi của backtest-sanity

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í

Ví dụ backtest-sanity trên dữ liệu mẫu: 87% lợi thế gộp bị chi phí lấy mất
Kết quả trên dữ liệu mẫu giả lập đi kèm kho mã (examples/trades.csv)

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ả.
Lưu ý: backtest-sanity là phần mềm, không phải khuyến nghị đầu tư. Kết quả backtest không dự báo kết quả trong tương lai.

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.

Xem mã nguồn trên GitHub →Hướng dẫn cài đặt

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.

Hãy là người đầu tiên nhận xét “Kauriq backtest-sanity – Công cụ kiểm tra backtest mã nguồn mở, miễn phí (Python)”

Email của bạn sẽ không được hiển thị công khai. Các trường bắt buộc được đánh dấu *

Giỏ hàng
Lên đầu trang