// Home advantage
Home advantage
Results plan and upMCP: home_advantage
Home win, draw and away win rates and home and away goals a match, by country and season.
GEThttps://api.handballapi.com/v1/stats/home-advantage
Try itruns against the live API with your key
keyGet a free key
Kept in this browser and filled in on every docs page. A key made in your account appears here by itself.
Parameters6
| name | type | what it does | |
|---|---|---|---|
competition | string | optional | Competition id (cp_...) |
season | string | optional | Season, such as 2025/26 (the latest with results) |
country | string | optional | Country code dksesihrcztrgrbrdeskrseschihfhistory |
per_page | integer | optional | Rows per page, 1 to 200 (100) |
page | integer | optional | Page number, from 1. Wins over cursor |
cursor | string | optional | The next_cursor from the previous answer |
Returns9 fields
| field | type | what it holds |
|---|---|---|
country | string | |
season | string | |
matches | integer | Matches with a line for the player. |
home_win_rate | number | Home wins divided by matches, 0 to 1. |
draw_rate | number | Draws divided by matches. |
away_win_rate | number | Away wins divided by matches. |
home_goals_per_match | number | |
away_goals_per_match | number | |
home_goal_edge | number |
Example answerGET /v1/stats/home-advantage?season=2025%2F26&per_page=3
2003 of 9 rows
{
"data": [
{
"country": "cz",
"season": "2025/26",
"matches": 505,
"home_win_rate": 0.554,
"draw_rate": 0.053,
"away_win_rate": 0.392,
"home_goals_per_match": 29.13,
"away_goals_per_match": 27.46,
"home_goal_edge": 1.68
},
{
"country": "es",
"season": "2025/26",
"matches": 3023,
"home_win_rate": 0.544,
"draw_rate": 0.076,
"away_win_rate": 0.38,
"home_goals_per_match": 27.98,
"away_goals_per_match": 26.7,
"home_goal_edge": 1.28
},
{
"country": "gr",
"season": "2025/26",
"matches": 874,
"home_win_rate": 0.534,
"draw_rate": 0.045,
"away_win_rate": 0.421,
"home_goals_per_match": 26.03,
"away_goals_per_match": 24.72,
"home_goal_edge": 1.31
}
],
"meta": {
"count": 3,
"next_cursor": "cDI",
"page": 1,
"per_page": 3,
"total": 9,
"total_pages": 3,
"next_page": 2,
"prev_page": null,
"basis": "country and season, 20 matches or more",
"compiled_at": "2026-10-31T03:40:01Z",
"took_ms": 17
}
}