Propension moyenne à consommer (APC)
Dépenser 36 000 sur un revenu disponible de 45 000 donne une propension moyenne à consommer de 0,8 : huit unités sur dix perçues après impôt sont parties en consommation. Sous un, il y a épargne ; au-dessus, on puise dans l'épargne ou la dette. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Consommation
- 36 000
- Revenu disponible
- 45 000
- Apc
- 0,8
La propension moyenne à consommer indique quelle part du revenu disponible est réellement dépensée plutôt qu'épargnée. Le résultat est arrondi à la précision de votre choix, validé contre les cas d'échec qui comptent, et calculé par le même code qui tourne gratuitement sur cette page, afin que ce que vous testez à la main soit exactement ce que votre pipeline reçoit à grande échelle.
Ce que mesure la propension moyenne à consommer
La propension moyenne à consommer est l'un des plus anciens ratios de la macroéconomie : la consommation totale divisée par le revenu disponible total. Une valeur de 0.8 signifie que quatre-vingts centimes de chaque dollar après impôt reçu pendant la période ont été consacrés à la consommation, les vingt centimes restants allant à l'épargne ou au remboursement de dettes.
Comme il s'agit d'un pur ratio, l'APC permet de comparer les comportements de dépense entre ménages de tailles différentes, régions aux niveaux de prix différents, ou une même économie à différentes années — à condition que les deux entrées décrivent la même population et la même période.
Un APC inférieur à un indique une épargne nette ; un APC supérieur à un signifie que la consommation de la période a dépassé le revenu, financée par un prélèvement sur l'épargne ou par l'emprunt, ce qui est fréquent chez les étudiants, les retraités et les ménages traversant un creux temporaire de revenu. Keynes a introduit ce concept pour soutenir que l'APC tend à baisser quand le revenu augmente, c'est pourquoi ce ratio sous-tend encore aujourd'hui les fonctions de consommation, les multiplicateurs budgétaires et la recherche en finance des ménages.
Au niveau micro, il répond à une question plus simple avec la même arithmétique : de l'argent dont cette personne ou ce segment disposait réellement, quelle part est repartie en dépenses ?
Comment le ratio est calculé et validé
Les deux entrées doivent être des nombres finis exprimés dans la même devise et les mêmes unités ; les chaînes numériques comme « 36000 » sont converties pour que les entrées de formulaire et de query-string fonctionnent sans prétraitement. La consommation peut être nulle — une période sans dépense est une observation valide — mais elle ne peut pas être négative, car une consommation négative n'a aucun sens économique à ce niveau d'agrégation.
L'appel rejeté n'est jamais facturé, afin que des données sources défectueuses échouent à moindre coût et clairement à la frontière de votre pipeline, au lieu de fausser silencieusement chaque agrégat en aval qui aurait consommé le ratio.
Où s'inscrit l'APC dans une analyse réelle
Les équipes qui calculent l'APC en ont généralement besoin comme une étape reproductible au sein d'un pipeline plus large, plutôt que comme une cellule isolée de tableur. Les configurations courantes incluent l'alimentation d'un tableau de bord du taux d'épargne à partir d'agrégats d'enquêtes sur les ménages, la normalisation des données de consommation avant comparaison de cohortes, et les environnements pédagogiques ou de notation où la même formule doit produire des résultats identiques au caractère près sur chaque machine.
Comme l'appel est sans état et idempotent, il se met aussi bien en cache : des paires d'entrées identiques donnent toujours le même ratio, donc les exécutions répétées d'un lot nocturne ou une nouvelle tentative après une panne réseau ne dérivent jamais.
Cas d’usage
Comparer le comportement d'épargne entre cohortes
Calculez l'APC par segment de ménages à partir d'agrégats d'enquête pour voir quels groupes dépensent la plus grande part de leur revenu disponible.
Normaliser les données pour un tableau de bord du taux d'épargne
Transformez les chiffres bruts de consommation et de revenu en un ratio unique et comparable avant de tracer les tendances dans le temps.
Noter des exercices d'économie de façon déterministe
Donnez à chaque copie d'étudiant le même résultat APC identique au caractère près, avec une précision d'arrondi configurable.
Questions fréquentes
Combien cela coûte-t-il ?
L'exécution est aussi gratuite dans votre navigateur sur cette page.
Quelle formule est utilisée ?
APC = consommation totale divisée par le revenu disponible total, arrondie à la précision demandée (4 décimales par défaut).
Que signifie un APC supérieur à 1 ?
La consommation a dépassé le revenu disponible sur la période — la différence a été financée par l'épargne ou l'emprunt.
Pourquoi ma requête a-t-elle été rejetée ?
Le revenu disponible doit être supérieur à zéro et la consommation ne peut pas être négative.
Puis-je passer des nombres sous forme de chaînes ?
Oui. Les chaînes numériques comme « 36000 » sont converties. Les valeurs qui ne s'analysent pas comme des nombres finis sont rejetées.
Des données sont-elles stockées ?
Non. Les deux entrées sont divisées puis abandonnées ; seul le ratio est renvoyé.
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/apc \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"consumption":36000,"disposable_income":45000}'const res = await fetch("https://api.kit.forhosting.com/fin/apc", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"consumption": 36000,
"disposable_income": 45000
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/apc",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"consumption": 36000,
"disposable_income": 45000
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/apc", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"consumption":36000,"disposable_income":45000}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"consumption":36000,"disposable_income":45000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/apc", 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
{
"consumption": 36000,
"disposable_income": 45000
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.apc",
"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.
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
Envoyez la consommation totale et le revenu disponible total pour la même période, et cette API renvoie le ratio APC en un appel déterministe — la normalisation exacte qu'utilisent économistes, analystes et étudiants avant de comparer ménages, régions ou années.
Comment le ratio est calculé et validé
Le point de terminaison effectue une seule division entièrement déterministe : APC = consumption / disposable_income, arrondie au nombre de décimales demandé (quatre par défaut, ajustable de zéro à six). Le revenu disponible doit être strictement supérieur à zéro : un dénominateur nul ou négatif rendrait le ratio indéfini ou trompeur, donc la requête est rejetée avec une erreur invalid_input et sans facturation plutôt que de renvoyer un nombre d'apparence plausible.
Où s'inscrit l'APC dans une analyse réelle
Comme le même code tourne gratuitement dans votre navigateur sur cette page et dans l'API payante, vous pouvez vérifier une paire de nombres à la main et ne payer — $0.002 par requête — qu'une fois l'appel automatisé. L'API ne stocke rien : les deux entrées sont divisées puis abandonnées, et seul le ratio est renvoyé, ce qui rend cette étape sûre à insérer dans des flux de reporting sensibles à la conformité.