Wall of Sport API

Base path: https://www.wallofsport.com/api

Security

basic

user:
api key
pass:
api secret

Paths

Get leagues

GET /league

Tags: Leagues

Returns a list of leagues filtered by optional queryparameters.

populate

A comma-separated list of associations (example: sport) topopulate

queryobject
where

Waterline query language terms in JSON.

querystring (json)

application/json

200 OK

An array of leagues

Get league by id

GET /league/{id}

Tags: Leagues

Returns a league

id

League id

pathinteger(int32)
populate

A comma-separated list of associations (example: sport) to populate

queryobject

application/json

200 OK

A league object

Get matches for league

GET /league/{id}/matches

Tags: Leagues, Matches

Get matches filtered by given league id

id

League id (example: 1 = English Premier League)

pathinteger(int32)
where

Waterline query language terms in JSON.

querystring (json)
populate

A comma-separated list of associations (example: home_team,away_team) to populate

queryobject

application/json

200 OK

An array of matches

Get sport for league

GET /league/{id}/sport

Tags: Leagues, Sports

Returns the sport for a given league

id

League id

pathinteger(int32)

application/json

200 OK

A sport object

Get teams for league

GET /league/{id}/teams

Tags: Leagues, Teams

Get teams filtered by given league id

id

League id

pathinteger(int32)
where

Waterline query language terms in JSON.

querystring (json)
populate

A comma-separated list of associations (example: sport) to populate

queryobject

application/json

200 OK

An array of teams

Get matches

GET /match

Tags: Matches

Returns a list of matches filtered by optional query parameters.

where

Waterline query language terms in JSON.

querystring (json)
populate

A comma-separated list of associations (example: 'league,home_team,away_team') to populate

queryobject

application/json

200 OK

An array of matches

Get match by id

GET /match/{id}

Tags: Matches

Returns a match

id

Match id

pathinteger(int32)
populate

A comma-separated list of associations (example: 'league,home_team,away_team') to populate

queryobject

application/json

200 OK

A match object

Get away team for match

GET /match/{id}/away_team

Tags: Matches, Teams

Returns the away team for a given match

id

Match id

pathinteger(int32)
populate

A comma-separated list of associations (example: 'sport') to populate

queryobject

application/json

200 OK

A team object

Get home team for match

GET /match/{id}/home_team

Tags: Matches, Teams

Returns the home team for a given match

id

Match id

pathinteger(int32)
populate

A comma-separated list of associations (example: 'sport') to populate

queryobject

application/json

200 OK

A team object

Get lineups for match

GET /match/{id}/lineup

Tags: Matches, Players

Returns player lineups for a given match

id

Match id

pathinteger(int32)
populate

A comma-separated list of associations (example: player) to populate

queryobject

application/json

200 OK

An array of players

Get commentary for match

GET /match/{id}/commentary

Tags: Matches, Live data

Returns the live commentary for a given match

id

Match id

pathinteger(int32)
populate

A comma-separated list of associations to populate

queryobject

application/json

200 OK

An array of commentary

Get substitutions for match

GET /match/{id}/substitutions

Tags: Matches, Live data

Returns substitutions for a given match

id

Match id

pathinteger(int32)
populate

A comma-separated list of associations (example: player_off,player_on) to populate

queryobject

application/json

200 OK

An array of substitutions

Get odds for match

GET /match/{id}/three_way_result_odds

Tags: Matches, Odds

Returns the betting odds (1 x 2) for a given match

id

Match id

pathinteger(int32)
populate

A comma-separated list of associations (example: 'bookmaker') to populate

queryobject

application/json

200 OK

An array of odds

Get predictions for match

GET /match//three_way_result_predictions

Tags: Matches, Predictions

Returns predictions (1 x 2) for a given match

id

Match id

pathinteger (int32)
populate

A comma-separated list of associations (example: 'algorithm') to populate

queryobject

application/json

200 OK

An array of predictions

Get teams

GET /team

Tags: Teams

Returns a list of teams filtered by optional query parameters.

where

Waterline query language terms in JSON.

querystring (json)
populate

A comma-separated list of associations (example: 'sport') to populate

queryobject

application/json

200 OK

An array of teams

Get team by id

GET /team/{id}

Tags: Teams

Returns a team

id

Team id

pathinteger(int32)
populate

A comma-separated list of associations (example: 'sport') to populate

queryobject

application/json

200 OK

A team object

Get players for team

GET /team/{id}/players

Tags: Teams, Players

Get players filtered by given team id

id

Team id

pathinteger(int32)
where

Waterline query language terms in JSON.

querystring (json)
populate

A comma-separated list of associations (example: 'sport') to populate

queryobject

application/json

200 OK

An array of players

Schema definitions

Commentary: object

id: integer (int32)

Commentary id

important: boolean

Indicates an important match event (kickoff, goal, halftime, ...)

is_goal: boolean

Indicates a goal

minute: string

Game minute

match: integer (int32)

Match id

created_at: string (date-time)

Creation timestamp

modified_at: string (date-time)

Modification timestamp

League: object

id: integer (int32)

League id

sport: integer (int32)

Sport id

name: string

Unique slugified name of league

display_en: string

Name of league (en)

display_zh: string

Name of league (zh)

created_at: string (date-time)

Creation timestamp

modified_at: string (date-time)

Modification timestamp

Match: object

id: integer (int32)

Match id

league: integer (int32)

League id

date: string (date-time)

Event date

home_team_score: integer (int32)

Home team score

home_team_ht_score: integer (int32)

Home team halftime score

home_team: integer (int32)

Home team id

away_team_score: integer (int32)

Away team score

away_team_ht_score: integer (int32)

Away team halftime score

away_team: integer (int32)

Away team id

location: integer (int32)

Location/venue id

status: string

Match status

stage: integer (int32)

Tournament/season stage

created_at: string (date-time)

Creation timestamp

modified_at: string (date-time)

Modification timestamp

Player: object

id: integer (int32)

Team id

name: string

Unique slugified name of team

display_en: string

Name of team (en)

display_zh: string

Name of team (zh)

Sport: object

id: integer (int32)

Sport id

name: string

Unique slugified name of sport

display_en: string

Name of league (en)

display_zh: string

Name of league (zh)

Substitution: object

id: integer (int32)

Substitution id

match: integer (int32)

Match id

team: integer (int32)

Team id

player_off: integer (int32)

Id of player being substituted

player_on: integer (int32)

Id of player entering the field

minute: string

Game minute

created_at: string (date-time)

Creation timestamp

modified_at: string (date-time)

Modification timestamp

Team: object

id: integer (int32)

Team id

name: string

Unique slugified name of team

display_en: string

Name of team (en)

display_zh: string

Name of team (zh)

ThreeWayResultOdd: object

id: integer (int32)

Odds id

home_team_value: number

Home team value (1)

draw_value: number

Draw value (x)

away_team_value: number

Away team value (2)

bookmaker: integer (int32)

Bookmaker id

match: integer (int32)

Match id

created_at: string (date-time)

Creation timestamp

modified_at: string (date-time)

Modification timestamp

ThreeWayResultPrediction:object

id:integer (int32)

Odds id

match:integer (int32)

Match id

algorithm:integer (int32)

Algorithm id

home_team_percentage:number (float)

Predicted likelihood of home team win

away_team_percentage:number (float)

Predicted likelihood of away team win

draw_percentage:object

Predicted likelihood of draw

created_at:string (date-time)

Creation timestamp

modified_at:string (date-time)

Modification timestamp