tradinglabpremium/sports-prediction-market-scanner

⚽ Soccer Edge Market Scanner — Bộ quét tìm edge cược bóng đá kiểu TypeScript

Một CLI/library TypeScript hoàn chỉnh: từ kéo feed, so sánh odds, backtest walk-forward đến cache Redis — tất cả đặt trong kiến trúc module rõ ràng, sẵn sàng mở rộng.

Soccer Edge Market Scanner (SEMS) của tradinglabpremium là một công cụ quét thị trường dự đoán thể thao tập trung vào bóng đá. Dự án cung cấp cả giao diện dòng lệnh (CLI) và API thư viện để: kéo dữ liệu giải đấu từ nhiều nguồn (feed), định giá edge bằng cách so sánh xác suất ngụ ý với odds của nhà cái (pricing), chạy backtest danh mục với chia tách walk-forward theo thời gian (TemporalCv), và lưu cache tín hiệu vào Redis (vault). Kiến trúc tách biệt rõ ràng: core schema, feeds, pricing, portfolio, storage — thuận tiện cho việc tùy biến hoặc tích hợp vào pipeline riêng.

✨ Điểm nổi bật

• Feeds đa dạng: SampleLeagueFeed (trong bộ nhớ, dùng thử/kiểm thử) và GithubSoccerFeed (CSV từ GitHub, có cache)
• MarketEdgePricer: định giá edge bằng cách so sánh xác suất ngụ ý trung bình với odds đăng tải, hỗ trợ ngưỡng edge tùy chỉnh
• Backtest walk-forward: backtestRunner kết hợp TemporalCv chia tách theo thời gian, tránh look-ahead bias
• Vault cache Redis: lớp cache sems: với fallback bộ nhớ khi Redis không khả dụng
• CLI vocabulary riêng: feed / book / vault thay vì tên gọi chung, dễ nhớ và nhất quán
• Type mapping rõ ràng: bảng đối chiếu với tên gọi toolbox phổ biến (DummySoccerDataLoader, OddsComparisonBettor, TimeSeriesSplit...)
• Library API công khai: import trực tiếp SampleLeagueFeed, MarketEdgePricer, backtest, TemporalCv từ src/index.ts
• Test & type-check sẵn: Vitest, npm run typecheck, npm run build

💡 Vì sao đáng chú ý

SEMS không chỉ là script đơn lẻ mà là một khung kerja (framework) nhỏ gọn, có kiến trúc lớp (class-oriented) và đặt tên miền (domain naming) riêng biệt — giúp người dùng hiểu luồng dữ liệu feed → book → vault mà không bị nhầm lẫn với thuật ngữ chung. Việc tách TemporalCv cho chia tách theo thời gian là điểm quan trọng cho backtest thể thao (tránh rò rỉ dữ liệu tương lai). Cache Redis có namespace sems: và fallback bộ nhớ khiến triển khai production đơn giản hơn. CLI book signals phát tín hiệu value-bet cho trận sắp tới, book replay chạy backtest đầy đủ — phù hợp cả nghiên cứu và vận hành thực tế.

#SportsBetting #PredictionMarket #TypeScript #OpenSource #TiniX