Surplus du consommateur
Si vous auriez payé 120 pour un billet et qu'il coûte 85, vous gardez 35 de surplus du consommateur. Saisissez votre consentement maximal à payer et le prix réel pour juger une offre, vérifier un exercice ou remplir une analyse de bien-être. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Consentement à payer
- 120
- Prix
- 85
- Excédent
- 35
Le surplus du consommateur est la valeur extra qu'un acheteur conserve lorsque le prix payé reste sous le maximum qu'il aurait accepté. Un client qui aurait payé cent vingt pour un billet et le trouve à quatre-vingt-cinq conserve trente-cinq de surplus ; cet écart est l'identité individuelle utilisée en microéconomie d'introduction, dans les contrôles de bien-être et les revues de prix. Ce calculateur de surplus du consommateur prend le consentement maximal à payer — le prix de réserve — et le prix réellement payé, soustrait et renvoie le surplus afin que vous évaluiez une offre, vérifiiez un exercice ou intégriez un chiffre dans une feuille de bien-être. Un surplus nul est admis lorsque les deux montants coïncident : l'acheteur est indifférent.
Ce que signifie le surplus unitaire : consentement à payer moins le prix
Le surplus unitaire du consommateur est la valeur extra, mesurée en monnaie, qu'un acheteur conserve sur un seul achat lorsque le prix de guichet reste sous son prix de réserve. Le consentement à payer est le maximum qu'il paierait encore en partant satisfait ; le prix réel est ce que la caisse, le tarif ou la facture a facturé. Les soustraire est l'identité CS égale à WTP moins P que tout cours de principes écrit sur la première diapositive de surplus.
Un spectateur qui aurait payé cent vingt et paie quatre-vingt-cinq conserve trente-cinq de surplus ; un usager dont le prix de réserve du trajet est quatre et qui paie quatre conserve zéro et est indifférent ; un acheteur à qui l'on demande plus que son prix de réserve ne conclut pas l'échange sous ce contrat. L'identité porte sur une unité dans une seule monnaie. Elle n'intègre pas une courbe de demande de marché à pente négative, ne résout pas une quantité d'équilibre et n'additionne pas un panier de biens distincts.
Ces travaux appartiennent à une intégrale de la fonction de demande, non à cet outil réserve moins guichet. Vous fournissez les deux montants ; le calculateur les soustrait et arrondit le surplus à deux décimales pour que les goldens coïncident octet par octet entre exécutions. Un bien gratuit avec price à zéro est admis et alors le surplus égale le consentement à payer entier.
Un prix de réserve négatif ou un prix payé négatif est rejeté, car ni l'un ni l'autre n'est un montant que ce contrat traitera comme un achat.
Où un calculateur de surplus unitaire du consommateur justifie son existence
Les ménages qui comparent un prix soldé à ce qu'ils avaient déjà décidé qu'un appareil valait utilisent un calculateur de surplus du consommateur pour transformer cette réserve intuitive en un seul chiffre comparable avant d'acheter. Les tuteurs et les générateurs d'épreuves ont besoin d'un oracle déterministe qui marque comme faux le cas où price dépasse le consentement à payer, au lieu de renvoyer en silence un surplus négatif qu'un correcteur défectueux pourrait traiter comme un succès.
Les équipes produit et prix branchent le même contrat sur des pages d'offre et des quiz d'accueil qui doivent afficher le surplus d'une réserve d'échantillon et d'un prix affiché sans appeler un modèle de demande. C'est une recherche et un travail différents du calculateur intégral de surplus du consommateur qui prend une courbe de demande inverse polynomiale et un prix de marché : cet outil intègre le consentement sous la fonction de demande jusqu'à la quantité d'équilibre. Cet outil valorise une unité contre une réserve et renvoie de l'argent.
Une validation échouée ne consomme pas de solde. Gardez price au plus égal au consentement à payer, figez le surplus arrondi dans les tests, et vous obtenez un montant de valeur extra reproductible pour teasers, contrôles de devoirs et workers de bord sans dresser un grand livre de bien-être à vous. Les paniers multi-unités, les effets revenu et les coins fiscaux restent hors de cette identité à dessein : repliez-les dans votre propre couche après avoir le surplus unitaire brut.
Cas d’usage
Valoriser un prix affiché face à votre réserve
Saisissez le maximum que vous paieriez pour un billet, un trajet ou un appareil et le prix de la page, puis figez le surplus pour que l'offre tienne sur une seule échelle monétaire avant l'achat.
Contrôles en classe et devoirs
Laissez les élèves envoyer le consentement à payer et le prix payé et vérifiez le surplus unitaire face à l'identité du manuel CS = WTP − P, y compris l'égalité à surplus nul.
Pages d'offre et quiz de prix
Montrez le surplus d'une réserve d'échantillon et d'un prix affiché dans l'accueil ou un texte A/B sans intégrer une courbe de demande de marché.
Questions fréquentes
Que se passe-t-il si le prix réel dépasse le consentement à payer ?
Le surplus du consommateur est indéfini lorsque l'acheteur n'achèverait pas l'achat, et l'appel n'est pas facturé. Des montants égaux sont valides et donnent un surplus nul.
Est-ce la même chose qu'intégrer une courbe de demande ?
Non. Ce calculateur est l'identité unitaire CS = WTP − P pour une réserve et un prix de guichet. Une intégrale de la fonction de demande de marché utilise un autre contrat et une autre recherche.
Le consentement à payer ou le prix peuvent-ils être nuls ?
Un price de zéro (un bien gratuit) est admis et alors le surplus égale le consentement à payer entier. Les deux montants à zéro donnent surplus de zéro. Les montants négatifs sont rejetés.
Qu'est-ce que le consentement à payer ?
Le maximum qu'un acheteur paierait encore pour une unité en restant satisfait, aussi appelé prix de réserve. Tout prix inférieur lui laisse un surplus ; à ce prix exact, acheter ou non lui est indifférent.
Comment utiliser le surplus du consommateur avant un achat ?
Fixez ce que l'article vaut pour vous, puis comparez-le au prix de vente. Le surplus transforme cette intuition en un chiffre comparable, pour classer plusieurs offres selon la valeur que chacune vous laisse.
Outils associés
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
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/fin/consumer-surplus \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"willingness_to_pay":120,"price":85}'const res = await fetch("https://api.kit.forhosting.com/fin/consumer-surplus", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"willingness_to_pay": 120,
"price": 85
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/consumer-surplus",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"willingness_to_pay": 120,
"price": 85
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/consumer-surplus", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"willingness_to_pay":120,"price":85}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"willingness_to_pay":120,"price":85}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/consumer-surplus", 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
{
"willingness_to_pay": 120,
"price": 85
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.consumer_surplus",
"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
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_abs | 1000000000000 |
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. |
Notes techniques
Saisissez les deux montants dans la même monnaie ; recevez le surplus, les entrées renvoyées et la formule surplus égale à willingness_to_pay moins price. Si le prix réel dépasse le consentement à payer, l'achat n'aurait pas lieu sous ce contrat et la tâche échoue avec invalid_input au lieu d'un surplus négatif.
Ce que signifie le surplus unitaire : consentement à payer moins le prix
Ce dernier cas n'est pas un nombre négatif sur un relevé : c'est une affaire qui n'aurait pas lieu, aussi le calculateur le rejette comme invalid_input plutôt que d'inventer une perte.
Contrat d'entrée, forme de la réponse et comportement en cas d'erreur
Si price est négatif, le gestionnaire rejette avec un message clair indiquant que le prix réellement payé ne peut pas être négatif. Des montants égaux sont valides et renvoient surplus de zéro. Exemple : cent vingt de consentement à payer à un price de quatre-vingt-cinq produit surplus de trente-cinq. Gardez les requêtes petites, figez le surplus arrondi dans les tests, et vous obtenez un chiffre de bien-être reproductible pour feuilles, greffons LMS et workers de bord sans dresser un moteur de courbe de demande à vous. Envoyez par POST un corps JSON avec deux nombres finis obligatoires. willingness_to_pay est le prix de réserve dans une unité monétaire ; les alias wtp, reservation_price, max_price et max_wtp pointent vers le même champ afin qu'un export d'enquête ou une feuille d'exercices conserve les noms de colonnes. price est le montant réellement payé dans cette même monnaie ; les alias actual_price, paid, price_paid et p sont acceptés. Chaque champ numérique peut arriver comme nombre JSON ou comme chaîne numérique. Les champs manquants, les chaînes vides et les valeurs non finies échouent avec invalid_input en nommant le champ. Si willingness_to_pay est négatif, le gestionnaire rejette la requête car un prix de réserve ne peut pas être négatif ; une réserve nulle n'est admise que lorsque le prix payé est aussi zéro, et alors le surplus est zéro. Si price est strictement supérieur à willingness_to_pay, le gestionnaire rejette avec un message indiquant que price dépasse le consentement à payer — ces échecs ne sont pas facturés. En cas de succès, le corps renvoie willingness_to_pay et price arrondis à deux décimales, indique surplus comme leur différence arrondie à deux décimales, et inclut une chaîne formula qui réaffirme l'identité. Associez le JSON à votre propre règle sur l'unité que vous valorisez — un billet, un trajet, un mois d'abonnement — car ce point soustrait les deux nombres que vous envoyez ; il ne consulte pas de listes de prix, ne convertit pas les devises et ne met pas à l'échelle par quantité.
Où un calculateur de surplus unitaire du consommateur justifie son existence
Comme l'implémentation est parse de niveau A pur, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle et sans réseau sortant.
Questions techniques
Comment calcule-t-on le surplus du consommateur à partir du consentement à payer et du prix ?
Envoyez des nombres finis non négatifs willingness_to_pay (le prix de réserve) et price (le montant payé). L'API renvoie surplus = willingness_to_pay − price, arrondi à deux décimales.
Combien coûte le calculateur de surplus du consommateur ?
L'outil du navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.