ForHosting KIT · Outils pour développeurs

Équilibre matériel aux échecs

Le calculateur d’équilibre matériel lit une position en notation Forsyth–Edwards (FEN), additionne la valeur conventionnelle des pièces blanches et noires, puis indique le camp en avance et le nombre de points.

● BetaGratuit · dans votre navigateur

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Il applique le barème courant : un pour un pion, trois pour un cavalier ou un fou, cinq pour une tour et neuf pour une dame. Collez le plateau seul ou une FEN complète afin d’obtenir un décompte transparent, vérifiable pièce par pièce.

Interprétez le résultat comme un instantané pratique

L’équilibre matériel permet de s’orienter rapidement dans une position. Le calculateur additionne les pièces encore présentes et précise si les Blancs mènent, si les Noirs mènent ou si les totaux sont égaux. Un point correspond généralement à un pion supplémentaire, tandis que trois points évoquent souvent une pièce mineure. Le résultat détaille aussi les pions, cavaliers, fous, tours, dames et rois : le score reste donc entièrement explicable. Vous voyez si l’écart provient d’une tour absente, d’un échange de dames compensé ou de plusieurs petites transactions. Les rois figurent dans l’inventaire mais valent zéro, car leur valeur est absolue et non échangeable. Considérez cette réponse comme un inventaire, jamais comme un verdict. L’initiative, la sécurité du roi, la structure de pions et les menaces tactiques peuvent peser davantage qu’un avantage numérique.

Saisissez une position FEN valide

Utilisez le champ de placement d’une chaîne FEN, composé de huit rangées séparées par des barres obliques. Les majuscules représentent les pièces blanches et les minuscules les noires : P pour pion, N pour cavalier, B pour fou, R pour tour, Q pour dame et K pour roi. Les chiffres indiquent des cases vides consécutives. Vous pouvez également coller une FEN complète avec trait, droits de roque, cible en passant et compteurs ; seuls les placements sont lus, puisque les autres champs ne changent pas le matériel présent. Chaque rangée doit décrire exactement huit cases et le plateau doit en contenir huit. Les symboles inconnus, rangées manquantes et largeurs incorrectes sont rejetés au lieu d’être devinés. Cette validation permet de repérer une chaîne endommagée copiée depuis une étude, une base de données, un site ou un logiciel avant de poursuivre l’analyse.

Comprenez le barème et ses limites

Le calcul emploie le barème matériel standard : pion un, cavalier trois, fou trois, tour cinq, dame neuf et roi zéro. Ce choix est volontairement simple et déterministe. Certains ouvrages et moteurs nuancent ces valeurs, par exemple en favorisant le fou ou en tenant compte de la position ; ces raffinements relèvent toutefois de l’évaluation, non du simple inventaire. Ici, deux fous valent toujours six et une tour accompagnée de deux pions vaut toujours sept. L’écart absolu entre les totaux devient la marge annoncée. Si les totaux coïncident, le matériel est déclaré égal même lorsque sa composition diffère. Servez-vous du calculateur pour contrôler des échanges, préparer un cours, vérifier un problème ou compléter une analyse. Pour juger correctement la position, associez ce décompte aux variantes concrètes et aux facteurs positionnels : posséder davantage de matériel ne garantit pas automatiquement la victoire.

Cas d’usage

Contrôler une partie après un échange

Collez la FEN obtenue pour vérifier si la séquence a gagné du matériel ou simplement échangé des pièces équivalentes.

Vérifier la position d’un problème

Confirmez la présence de chaque pièce prévue et la concordance entre l’avantage annoncé et le plateau réel.

Enrichir un cours d’échecs

Présentez un décompte clair avant d’aborder compensation, initiative, sécurité du roi ou avantages positionnels.

Questions fréquentes

Quel barème de pièces est utilisé ?

Un pion vaut 1 point, un cavalier ou un fou 3, une tour 5, une dame 9 et un roi 0 pour le décompte matériel.

Puis-je coller une chaîne FEN complète ?

Oui. Le premier champ contenant le plateau est lu ; les autres sont ignorés car ils ne modifient pas le matériel actuel.

Une avance matérielle signifie-t-elle que ce camp gagne ?

Pas nécessairement. Tactique, initiative, sécurité du roi, structure de pions et compensation positionnelle peuvent dépasser l’écart numérique.

Pourquoi le roi vaut-il zéro ?

Un roi ne peut être ni échangé ni capturé légalement ; il figure donc dans l’inventaire sans entrer dans le total conventionnel.

Que se passe-t-il si les totaux sont égaux mais les pièces différentes ?

Le résultat annonce l’égalité matérielle et conserve le détail par type afin que vous puissiez apprécier séparément le déséquilibre.

Combien coûte une requête API ?

Chaque requête API coûte $0.002. Le même calcul déterministe peut aussi s’exécuter dans le navigateur.

Pour les développeurs — accès API

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

Endpoint

POSThttps://api.kit.forhosting.com/hobby/chess-material-balance

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/hobby/chess-material-balance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"position":"r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"}'

const res = await fetch("https://api.kit.forhosting.com/hobby/chess-material-balance", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "position": "r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/hobby/chess-material-balance",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "position": "r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/hobby/chess-material-balance", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"position":"r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"position":"r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/hobby/chess-material-balance", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "position": "r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "hobby.chess_material_balance",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

Tarifs

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →