IodidDOCUMENTATION

api/profile/matchups.mdx

/doc/api/profile/matchups

PUBLIC DOCUMENTATION

Matchups

Opponent matchups per champion — winrate vs opponents.

GET/api/lol/{shard}/profile/{puuid}/matchups

Profile matchups

Path params

Query params

Request
https://api.safjnest.com/api/lol/EUW1/profile/{puuid}/matchups?start=0&end=0&queue=ALL&minGames=5
curl "https://api.safjnest.com/api/lol/EUW1/profile/{puuid}/matchups?start=0&end=0&queue=ALL&minGames=5"

Missing required: puuid

CORS enabled (*) — runs directly in your browser against https://api.safjnest.com

GET /api/lol/{shard}/profile/{puuid}/matchups

Opponent matchups per champion — winrate vs individual opponents, optional lane/patch filter.

  • Controller: LolController.java:184 → LolApiParameters.matchupsFilter (:124) → profileService.getMatchups(shard, puuid, filter) → LolApiResponses.from with profile_matchups_pending (:201)
  • Response: 200 ProfileMatchups or 202 profile_matchups_pending
ParameterPositionDefaultValidationNotes
shardpath—requiredShard
puuidpath—requiredText
startquery0>=0 :242if start!=0 && end==0 → end=endOfToday() (:132)
endquery0>= start
queuequerynulloptionalQueue
patchquerynullpatch :103major.minor, ignored if start/end present
rolequerynullrole :168 + validateRole :177TOP,JUNGLE,MID,BOT,UTILITY
minGamesquery5minGames :119 >=1minimum games threshold

Response: ProfileMatchups — map champion → List<MatchupLeaf> with wins/losses/winrate.

curl

bash
curl "https://api.safjnest.com/api/lol/EUW1/profile/abc-puuid/matchups?queue=RANKED_SOLO_5X5&role=MID&minGames=5"