NightDev Community Forums

[Custom API] Valorant MMR Rank API v1

I have written Valorant API wrapper to display your rank tier, RR and Elo according to your MMR.

Usage: https://api.kyroskoh.xyz/valorant/v1/mmr/[region]/[ID]/[Tag]

[Note]
region: na, eu, ap, kr
ID: username
Tag: #___

For example, using belles#huats in ap region:
https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats

The following will not display the ID, Tag, Region with showing rank, RR and Elo (By default):
!addcom !rank $(urlfetch https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats)
Response: “[Gold 1] - 32RR. MMR Elo: 932.” (Screenshot)

The following will display the ID, Tag, Region with showing rank, RR and Elo:
!addcom !rank $(urlfetch https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats?display=1)
Response: “belles#huats (ap Region): [Gold 1] - 32RR. MMR Elo: 932.” (Screenshot)

The following will not display the ID, Tag, Region with showing rank, RR and Elo:
!addcom !rank $(urlfetch https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats?display=0)
Response: “[Gold 1] - 32RR. MMR Elo: 932.” (Screenshot)

The following will display the ID, Tag, Region with showing rank only:
!addcom !rank $(urlfetch https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats?show=rankonly&display=1)
Response: “belles#huats (ap Region): [Gold 1]” (Screenshot)

The following will not display the ID, Tag, Region with showing rank only:
!addcom !rank $(urlfetch https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats?show=rankonly&display=0)
Response: “[Gold 1]” (Screenshot)

The following will display the ID, Tag, Region with showing RR only:
!addcom !rank $(urlfetch https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats?show=rronly&display=1)
Response: “belles#huats (ap Region): 47RR.” (Screenshot)

The following will not display the ID, Tag, Region with showing RR only:
!addcom !rank $(urlfetch https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats?show=rronly&display=0)
Response: “47RR.” (Screenshot)

The following will display the ID, Tag, Region with showing Elo only:
!addcom !rank $(urlfetch https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats?show=eloonly&display=1)
Response: “belles#huats (ap Region): MMR Elo: 947.” (Screenshot)

The following will not display the ID, Tag, Region with showing Elo only:
!addcom !rank $(urlfetch https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats?show=eloonly&display=0)
Response: “MMR Elo: 947.” (Screenshot)

The following will display the ID, Tag, Region with showing rank and RR only:
!addcom !rank $(urlfetch https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats?show=combo&display=1)
Response: “belles#huats (ap Region): [Gold 1 - 47RR].” (Screenshot)

The following will not display the ID, Tag, Region with showing rank and RR only:
!addcom !rank $(urlfetch https://api.kyroskoh.xyz/valorant/v1/mmr/ap/belles/huats?show=combo&display=0)
Response: “[Gold 1 - 47RR].” (Screenshot)

You might encounter “Bad Request” (Status Code: 400) in return if the ID#Tag user account did not played ranked/rated games in last 20 game matches and your ID and Tag should be in English encoded characters. Looks like Riot API doesn’t support special characters such as “ñ” etc.

*Feel free to reach me directly in here or whisper me via Twitch (kyroskoh).

7 Likes

[Change Log]

  • v1.0 [15 Jun 2021] If your ID contains 2 words or more with spacing, please use %20 to replace with the spacing as it is URI encoded.
  • v1.1 [24 Jun 2021] Updated with more parameters support: rronly, eloonly, combo.
3 Likes

Note: Your ID and Tag should be in English encoded characters. Looks like Riot API doesn’t support special characters such as “ñ” etc.

2 Likes

Hi, kyroskoh
Is your api free to use?

1 Like

Yes. You can use it for Streamlabs/Streamelements too with the similar respective variables.

1 Like

Hi, can I use this command if I am from a region other than na, eu, ap or kr? (lan or las)

I’m not sure but give it a try.

So far the API allows me to input those given regions. However you can try it out if it is supported, else Valorant regions might be combined with another main regions as their database collections.

Such as SA is using NA.

1 Like

thanks, I already managed to configure it using NA

1 Like

I have received a Feature Request…

Valorant Leaderboard API based on Region. (It will be based on example: VALORANT Leaderboards: Search or log in to view ranks)

Please poll on your interest below:

  • Yes
  • No

0 voters

P.S: I have done the coding for this. Due to RiotAPI has a huge leaderboard ranking per region, sometimes the API will response “not found” even tho the ID and Tag is in the leaderboard. (probably not stable at this point for RiotAPI Developers for API calling fetching using my workaround implementation method)

RequestError: certificate has expired

Let’s Encrypt SSL renewed - with only TLSv1.2 and TLSv1.3 support.
https://www.ssllabs.com/ssltest/analyze.html?d=api.kyroskoh.xyz

Is it possible to customize the response a bit more. The given response is always in “” and the “rank” part is always in [], is it possible to get rid of these/opt to not display them?

Hi,

You can use the above parameters to only show the certain data. So far, there’s no issue for other users. Are you using Nightbot for this? Please also note that there’s a cooldown for calling the API as per documented in RiotAPI.