Documentation

API Valorant compatible avec le format d'HenrikDev : rang, RR, placement, matchs, leaderboard, stats de session. Les données viennent de Riot en direct à chaque requête.

URL de base : https://val-api.kbouu.com · Régions : eu, na, ap, kr, br, latam · Plateformes : pc, console.

Dans un Riot ID, le # devient un / et les espaces s'écrivent %20 : Mon Pseudo#EUW → /Mon%20Pseudo/EUW.

Quel outil pour quel usage ?

Clé API

Toutes les routes /valorant/… demandent une clé. Crée-la dans ton panel, puis envoie-la dans l'en-tête Authorization :

curl -H "Authorization: $VAL_API_KEY" \
  "https://val-api.kbouu.com/valorant/v3/mmr/eu/pc/Mon%20Pseudo/EUW"

Ta clé est personnelle, comme un mot de passe :

• garde-la côté serveur, dans une variable d'environnement (ex. VAL_API_KEY), jamais dans le code ni dans un dépôt git ;
• ne la mets jamais dans du code exécuté chez les visiteurs (page web, overlay OBS, extension) ni dans une commande de bot visible par d'autres : n'importe qui pourrait la lire et utiliser ton quota ;
• si elle a fuité, clique sur « Régénérer » dans ton panel : l'ancienne cesse aussitôt de fonctionner.

Le paramètre ?api_key= est aussi accepté, mais déconseillé : la clé finit dans les historiques et les liens partagés.

Limites

Chaque clé a une limite par minute et un quota par jour (visibles dans ton panel). Chaque réponse contient :

X-RateLimit-Limit      requêtes autorisées par minute
X-RateLimit-Remaining  requêtes restantes dans la minute
X-RateLimit-Reset      secondes avant que la fenêtre se libère
X-Quota-Limit          requêtes autorisées par jour (remis à zéro à minuit UTC)
X-Quota-Remaining      requêtes restantes aujourd'hui

Chaque appel à l'API compte pour 1, quelle que soit la route. Au-delà des limites, l'API répond 429 (avec Retry-After pour la limite par minute) : attends le délai indiqué avant de réessayer. Besoin de plus ? Demande à un administrateur.

Erreurs

Même format qu'HenrikDev :

{"errors": [{"code": 22, "message": "Account not found", "status": 404, "details": null}]}

Stats de session

Calculées sur les parties de la période, en direct :

GET /valorant/v1/stats/{region}/{name}/{tag}          → toutes les stats (JSON)
GET /valorant/v1/stats/{region}/{name}/{tag}/{stat}   → une stat (texte brut)

# Bilan de la session en cours (depuis 20 h), en JSON
curl -H "Authorization: $VAL_API_KEY" \
  "https://val-api.kbouu.com/valorant/v1/stats/eu/Mon%20Pseudo/EUW?period=since&since=2026-09-27T20:00"

# Une seule stat, en texte brut : 3W/1L
curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v1/stats/eu/Mon%20Pseudo/EUW/record"

Riot conserve environ 100 parties par joueur : c'est la limite pour les longues périodes. Le format texte des stats seules est pratique pour un service qui relaie la valeur telle quelle (message de chat, overlay).

Liste des stats

Exemples

Une commande /rank pour un bot Discord : elle interroge /valorant/v3/mmr, qui renvoie le rang, le RR, le dernier gain et le placement au leaderboard en un seul appel, puis répond par exemple Mon Pseudo#EUW : Immortal 2 #412, 187 RR (+18).

JavaScript (discord.js)

// Bot Discord (discord.js v14) : commande /rank riot_id:"Pseudo#TAG"
// npm install discord.js   ·   VAL_API_KEY et DISCORD_TOKEN dans les variables d'environnement
import { Client, GatewayIntentBits } from "discord.js";

const API = "https://val-api.kbouu.com";
const client = new Client({ intents: [GatewayIntentBits.Guilds] });

client.on("interactionCreate", async (interaction) => {
  if (!interaction.isChatInputCommand() || interaction.commandName !== "rank") return;
  const [name, tag] = interaction.options.getString("riot_id").split("#");
  const url = `${API}/valorant/v3/mmr/eu/pc/${encodeURIComponent(name)}/${encodeURIComponent(tag)}`;
  const res = await fetch(url, { headers: { Authorization: process.env.VAL_API_KEY } });
  const body = await res.json();
  if (!res.ok) return interaction.reply(body.errors?.[0]?.message ?? "Erreur");

  const c = body.data.current;
  const place = c.leaderboard_placement ? ` #${c.leaderboard_placement.rank}` : "";
  const change = c.last_change >= 0 ? `+${c.last_change}` : `${c.last_change}`;
  await interaction.reply(`${name}#${tag} : ${c.tier.name}${place}, ${c.rr} RR (${change})`);
});

client.login(process.env.DISCORD_TOKEN);

Python (discord.py)

# Bot Discord (discord.py 2.x) : commande /rank riot_id:"Pseudo#TAG"
# pip install discord.py aiohttp   ·   VAL_API_KEY et DISCORD_TOKEN dans les variables d'environnement
import os
from urllib.parse import quote

import aiohttp
import discord
from discord import app_commands

API = "https://val-api.kbouu.com"
client = discord.Client(intents=discord.Intents.default())
tree = app_commands.CommandTree(client)


@tree.command(description="Rang Valorant d'un joueur")
async def rank(interaction: discord.Interaction, riot_id: str, region: str = "eu"):
    name, _, tag = riot_id.partition("#")
    url = f"{API}/valorant/v3/mmr/{region}/pc/{quote(name)}/{quote(tag)}"
    async with aiohttp.ClientSession() as session:
        async with session.get(url, headers={"Authorization": os.environ["VAL_API_KEY"]}) as res:
            body = await res.json()
            ok = res.status == 200
    if not ok:
        return await interaction.response.send_message(body["errors"][0]["message"])

    c = body["data"]["current"]
    place = f" #{c['leaderboard_placement']['rank']}" if c["leaderboard_placement"] else ""
    await interaction.response.send_message(f"{riot_id} : {c['tier']['name']}{place}, {c['rr']} RR ({c['last_change']:+d})")


@client.event
async def on_ready():
    await tree.sync()  # enregistre la commande /rank auprès de Discord


client.run(os.environ["DISCORD_TOKEN"])

Dans les deux cas, déclare la commande /rank avec une option texte riot_id. La clé et le jeton Discord restent sur la machine qui fait tourner le bot.

Overlays de stream

Un overlay OBS est une page web : tout son contenu est lisible par n'importe qui. Il ne doit donc jamais contenir ta clé. Fais-le passer par un service intermédiaire :

overlay (page web)  →  ton service (garde la clé)  →  https://val-api.kbouu.com/valorant/…

Le service appelle l'API avec la clé et ne renvoie à l'overlay que ce qu'il affiche (rang, RR, bilan de la session…). Pour limiter les appels, il peut garder la réponse quelques secondes avant de redemander. Les stats de session sont faites pour ce genre d'affichage.

Comptes

curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v1/account/Mon%20Pseudo/EUW"

curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v2/account/Mon%20Pseudo/EUW"

Rang & MMR

curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v3/mmr/eu/pc/Mon%20Pseudo/EUW"

curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v2/mmr/eu/Mon%20Pseudo/EUW"

curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v2/mmr-history/eu/pc/Mon%20Pseudo/EUW"

Stats (routes)

curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v1/stats/eu/Mon%20Pseudo/EUW?period=today"

curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v1/stats/eu/Mon%20Pseudo/EUW/record"

Matchs

curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v4/matches/eu/pc/Mon%20Pseudo/EUW?size=3"

Leaderboard

curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v3/leaderboard/eu/pc?size=10"

Jeu & serveurs

curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v1/version/eu"

curl -H "Authorization: $VAL_API_KEY" "https://val-api.kbouu.com/valorant/v1/crosshair/generate?id=0;P;c;5;h;0;0l;4;0o;2;0a;1;0f;0;1b;0"

Premier (partiel)