NHRL Statsbook

Welcome to the Statsbook service!

Each page listed here will give you information from the NHRL Stats Database.

Get Stat Summary - Simple

https://stats.nhrl.io/statsbook/get_stat_summary_simple.php?category_id=1

The above link will retrieve all-time stats and correct ranking for a weight class. In most cases, this is what you want.

• class_id=1 retrieves 3lb.
• class_id=2 retrieves 12lb.
• class_id=4 retrieves 30lb.

Get Dumpster Count

https://stats.nhrl.io/statsbook/get_dumpster_count.php?category_id=1

The above link will retrieve the number of first-place, second-place, and third-place finishes for every bot that has at least a third-place finish in that weight class.

• category_id=1 retrieves 3lb.
• category_id=2 retrieves 12lb.
• category_id=4 retrieves 30lb.

Get Event Participants

https://stats.nhrl.io/statsbook/get_event_participants.php?bot_name=foo_bar

The above link will retrieve all events that the given bot fought in, along with details like what round the bot reached, what place the bot finished in (if at least 4th), and its record in the event.

The bot name is case-insensitive. Replace any spaces in the bot name with underscores, and escape all necessary characters.

Get Event Winners

https://stats.nhrl.io/statsbook/get_event_winners.php?weight_class=3lb

The above link will retrieve the top 4 bots from each event in the given weight class.

Get Fastest KOs

https://stats.nhrl.io/statsbook/get_fastest_kos.php?class_id=1

The above link will retrieve the fastest tap-outs and KOs in each weight class.

Note: class_id will be renamed to category_id in the future!

• class_id=1 retrieves 3lb.
• class_id=2 retrieves 12lb.
• class_id=4 retrieves 30lb.

Get Fights

https://stats.nhrl.io/statsbook/get_fights.php?bot_name=foo_bar

The above link will retrieve all fights that the given bot fought in, along with details like whether the fight was a win or a loss, the result type (KO, JD, etc), and the length of the fight. The bot name is case-insensitive. Replace any spaces in the bot name with underscores, and escape all necessary characters.

Get Head-to-Head

https://stats.nhrl.io/statsbook/get_head_to_head.php?bot_name=foo_bar

The above link will retrieve all opponents this bot has fought, and its record against them.

The bot name is case-insensitive. Replace any spaces in the bot name with underscores, and escape all necessary characters.

Get Longest Winning Streak

https://stats.nhrl.io/statsbook/get_longest_winning_streak.php?category_id=1

The above link will retrieve the longest winning streaks in this weight class.

• class_id=1 retrieves 3lb.
• class_id=2 retrieves 12lb.
• class_id=4 retrieves 30lb.

Get Random Fight

https://stats.nhrl.io/statsbook/get_random_fight.php

The above link will retrieve a simple web page showing a random fight.

Get Rank

https://stats.nhrl.io/statsbook/get_rank.php?bot_name=foo_bar

The above link will retrieve the current rank of this bot.

The bot name is case-insensitive. Replace any spaces in the bot name with underscores, and escape all necessary characters.

Get Stat Summary

https://stats.nhrl.io/statsbook/get_stat_summary.php?category_id=1&season=2025

The above link will retrieve stats for a weight class for a given season.

• class_id=1 retrieves 3lb.
• class_id=2 retrieves 12lb.
• class_id=4 retrieves 30lb.

The season is the year you're looking for. Normally, this will be "2025", "2024", etc. There are 3 exceptions:

• season=All-time retrieves all-time stats.
• season=2018-19 retrieves stats for NHRL's first season, which spanned two years.
• season=Active retrieves stats for the previous season and the current season only. This is used for ranking calculation only, and won't have much external application.

Get Stats By Season

https://stats.nhrl.io/statsbook/get_stats_by_season.php?bot_name=foo_bar&season=2025

The above link will retrieve stats for a single bot for a given season.

The bot name is case-insensitive. Replace any spaces in the bot name with underscores, and escape all necessary characters.

The season is the year you're looking for. Normally, this will be "2025", "2024", etc. There are 3 exceptions:

• season=All-time retrieves all-time stats.
• season=2018-19 retrieves stats for NHRL's first season, which spanned two years.
• season=Active retrieves stats for the previous season and the current season only. This is used for ranking calculation only, and won't have much external application.

Get Streak Stats

https://stats.nhrl.io/statsbook/get_streak_stats.php?bot_name=foo_bar

The above link will retrieve information about the bot's current winning or losing streak.