Sport-betting-data

About

A scrapper for sport betting data from different brokers.
The first stage focuses on the data on Hong Kong Jockey Club (HKJC) website, including Mark Six, Horse Racing and Football betting.
Please refer to the Development Plan for the current progress.

Prerequisites

Please make sure the following tool(s) / application(s) are properly setup and ready to use:

• Node.js (https://nodejs.org/)

Setup

1. Download repository

git clone https://github.com/rkwyu/sport-betting-data

2. Install dependencies

cd ./sport-betting-data
npm install

Configuration

Output directory can be configured in config.ini

[DIRECTORY]
output=output

Usage (CLI)

Usage: npm start [-- options]  
Options:  
  -hkjc_hr        Get HKJC Horse Racing Odds  
  -hkjc_ms        Get HKJC Marksix Result

Example 1: Download HKJC's mark six data

npm start -hkjc_ms

Example 2: Download HKJC's horse racing data

npm start -hkjc_hr

Output Directory Structure

.
├── {output directory}
│   └── {broker}
│      └── {type}
│         └── ...

Example

.
├── output
│   └── hkjc
│      └── football
│      └── marksix
│         ├── 1993.json
│         ├── 1994.json
│         └── ...
│      └── racing
│         ├── 2024-04-28_ST
│         │   ├── 01
│         │   │   ├── dbl
│         │   │   ├── ...
│         │   │   └── winprog
│         │   ├── 02
│         │   ├── ...
│         │   ├── importantnotices
│         │   ├── jkc
│         │   ├── scratched
│         │   ├── tnc
│         │   ├── winodds
│         │   ├── winplaodds
│         │   └── winplaoddspre
│         └── ...

Date-based data will be grouped into a directory using date-identifier (e.g. 2024-04-28_ST) as the directory name
Match-based / Race-based data will be further grouped into a directory using match-identifier / race-identifier (e.g. 01, 02, ...) as the directory name

Development Plan

• Hong Kong Jockey Club (HKJC) (https://www.hkjc.com/)
  • Mark Six
    • Results (since 1993)
  • Horse Racing
    • Jockey Challenge Scheduled Rides List
    • Jockey Challenge Results
    • Jockey Challenge Statistics
    • Total Pool Investments (in a race)
    • Pool Investments (in a race)
    • Race Cards
    • Race Changes
    • Race Entries
    • Race Odds
      • Pre-sell WIN and PLACE odds
      • Pre-sell QUINELLA odds
      • Pre-sell QUINELLA PLACE odds
      • Pre-sell DOUBLE odds
      • WIN odds
      • WIN and PLACE odds
      • QUINELLA odds
      • QUINELLA PLACE odds
      • FORECAST odds
      • TIERCE odds (Top 20, Banker Top 10) and Investment
      • TRIO odds (Top 20, Banker Top 10, all)
      • FIRST FOUR odds (Top 20, Banker Top 10, all)
      • QUARTET odds (Top 20, Banker Top 10)
      • DOUBLE odds
      • JOCKEY CHALLENGE odds
      • TRAINER CHALLENGE odds
      • Progressive WIN odds
    • Race Results
    • Scratched Horses
    • Trainer Challenge Entries List
    • Trainer Challenge Odds Chart
    • Trainer Challenge Results
    • Trainer Challenge Statistics
  • Football
  • Important Notices

License

This project is licensed under the MIT License