MatchApiV4

class riotwatcher._apis.MatchApiV4(base_api)

This class wraps the Match-v4 endpoint calls provided by the Riot API.

See https://developer.riotgames.com/api-methods/#match-v4 for more detailed information

by_id(region, match_id)

Get match by match ID

Parameters:
  • region (string) – The region to execute this request on
  • match_id (long) – The match ID.
Returns:

MatchDto
matchlist_by_account(region, encrypted_account_id, queue=None, begin_time=None, end_time=None, begin_index=None, end_index=None, season=None, champion=None)

Get matchlist for ranked games played on given account ID and platform ID and filtered using given filter parameters, if any

A number of optional parameters are provided for filtering. It is up to the caller to ensure that the combination of filter parameters provided is valid for the requested account, otherwise, no matches may be returned.

Note that if either beginIndex or endIndex are specified, then both must be specified and endIndex must be greater than beginIndex.

If endTime is specified, but not beginTime, then beginTime is effectively the start of the account’s match history.

If beginTime is specified, but not endTime, then endTime is effectively the current time.

Note that endTime should be greater than beginTime if both are specified, although there is no maximum limit on their range.

Parameters:
  • region (string) – The region to execute this request on
  • encrypted_account_id (string) – The account ID.
  • queue (Set[int]) – Set of queue IDs for which to filtering matchlist.
  • begin_time (long) – The begin time to use for filtering matchlist specified as epoch milliseconds.
  • end_time (long) – The end time to use for filtering matchlist specified as epoch milliseconds.
  • begin_index (int) – The begin index to use for filtering matchlist.
  • end_index (int) – The end index to use for filtering matchlist.
  • season (Set[int]) – Set of season IDs for which to filtering matchlist.
  • champion (Set[int]) – Set of champion IDs for which to filtering matchlist.
Returns:

MatchlistDto
timeline_by_match(region, match_id)

Get match timeline by match ID.

Not all matches have timeline data.

Parameters:
  • region (string) – The region to execute this request on
  • match_id (long) – The match ID.
Returns:

MatchTimelineDto