ForHosting KIT · Finanças e dinheiro

Excedente do consumidor

Se você pagaria 120 por um ingresso e ele custa 85, fica com 35 de excedente do consumidor. Digite a sua disposição máxima a pagar e o preço real para avaliar uma oferta, conferir um exercício ou preencher uma análise de bem-estar. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Disposição a pagar: 120
Preço: 85

Você obtém

Excedente: 35

O excedente do consumidor é o valor extra que um comprador retém quando o preço pago fica abaixo do máximo que teria pago. Um cliente que teria pago cento e vinte por um ingresso e o encontra a oitenta e cinco conserva trinta e cinco de excedente; essa diferença é a identidade individual usada em microeconomia introdutória, checagens de bem-estar e revisões de preço. Esta calculadora do excedente do consumidor recebe a disposição máxima a pagar — o preço de reserva — e o preço de fato pago, subtrai e devolve o excedente para você avaliar uma oferta, conferir um exercício ou colocar a cifra numa planilha de bem-estar. Excedente nulo é permitido quando os dois valores coincidem: o comprador é indiferente.

O que significa o excedente unitário: disposição a pagar menos preço

O excedente unitário do consumidor é o valor extra, medido em dinheiro, que um comprador retém numa única compra quando o preço de bilheteria fica abaixo do seu preço de reserva. A disposição a pagar é o máximo que ele ainda pagaria e sairia satisfeito; o preço real é o que o caixa, a tarifa ou a fatura cobrou. Subtraí-los é a identidade CS igual a WTP menos P que todo curso de princípios escreve no primeiro slide de excedente.

Um frequentador de show que teria pago cento e vinte e paga oitenta e cinco conserva trinta e cinco de excedente; um passageiro cujo preço de reserva da passagem é quatro e que paga quatro conserva zero e é indiferente; um comprador a quem se pede mais do que o preço de reserva não fecha o negócio neste contrato. A identidade trata de uma unidade numa só moeda.

Ela não integra uma curva de demanda de mercado com inclinação negativa, não resolve uma quantidade de equilíbrio e não soma uma cesta de bens diferentes. Esses trabalhos pertencem a uma integral da função de demanda, não a esta ferramenta de reserva menos bilheteria. Você informa os dois valores; a calculadora os subtrai e arredonda o excedente para duas casas decimais para que os goldens coincidam byte a byte entre ambientes.

Um bem gratuito com price zero é permitido e então o excedente iguala a disposição a pagar completa. Um preço de reserva negativo ou um preço pago negativo é rejeitado, porque nenhum é um valor monetário que este contrato trate como compra.

Onde uma calculadora do excedente unitário do consumidor se justifica

Famílias que comparam um preço de promoção com o que já tinham decidido que um aparelho valia usam uma calculadora do excedente do consumidor para transformar essa reserva intuitiva numa única cifra comparável antes de comprar. Tutores e geradores de provas precisam de um oráculo determinístico que marque como erro o caso em que price supera a disposição a pagar, em vez de devolver em silêncio um excedente negativo que um corretor defeituoso poderia tratar como acerto.

Equipes de produto e de preços ligam o mesmo contrato a páginas de oferta e questionários de onboarding que precisam mostrar o excedente de uma reserva de amostra e um preço publicado sem chamar um modelo de demanda. Esta é uma busca e um trabalho diferentes da calculadora integral do excedente do consumidor que recebe uma curva de demanda inversa polinomial e um preço de mercado: aquela ferramenta integra a disposição sob a função de demanda até a quantidade de equilíbrio.

Esta ferramenta precifica uma unidade contra uma reserva e devolve dinheiro. A validação falha não consome saldo. Mantenha price não maior que a disposição a pagar, fixe o surplus arredondado nos testes e você terá um valor extra reproduzível para teasers, checagens de lição e workers de borda sem montar um livro-razão de bem-estar próprio.

Cestas de várias unidades, efeitos-renda e cunhas fiscais ficam de fora desta identidade de propósito: incorpore-os na sua própria camada depois de ter o excedente unitário bruto.

Casos de uso

Avaliar um preço publicado diante da sua reserva

Informe o máximo que você pagaria por um ingresso, uma passagem ou um aparelho e o preço da página; fixe o excedente para a oferta ficar numa só escala monetária antes de comprar.

Checagens de sala de aula e de lição de casa

Deixe os alunos enviarem a disposição a pagar e o preço pago e verifique o excedente unitário diante da identidade do livro CS = WTP − P, inclusive o empate de excedente nulo.

Páginas de oferta e questionários de preço

Mostre o excedente de uma reserva de amostra e um preço publicado no onboarding ou num texto A/B sem integrar uma curva de demanda de mercado.

Perguntas frequentes

O que acontece se o preço real superar a disposição a pagar?

O excedente do consumidor fica indefinido quando o comprador não completaria a compra, e a chamada não é faturada. Valores iguais são válidos e geram excedente nulo.

Isso é o mesmo que integrar uma curva de demanda?

Não. Esta calculadora é a identidade unitária CS = WTP − P para uma reserva e um preço de bilheteria. Uma integral da função de demanda de mercado usa outro contrato e outra busca.

A disposição a pagar ou o preço podem ser zero?

Um price de zero (um bem gratuito) é permitido e então o excedente iguala a disposição a pagar completa. Os dois valores em zero geram surplus de zero. Valores negativos são rejeitados.

O que é disposição a pagar?

O máximo que um comprador ainda pagaria por uma unidade e sairia satisfeito, também chamado de preço de reserva. Qualquer preço abaixo disso deixa excedente; exatamente nesse preço, comprar ou não dá na mesma.

Como usar o excedente do consumidor antes de comprar?

Decida quanto o item vale para você e compare com o preço de venda. O excedente transforma essa intuição em um número comparável, para você ordenar várias ofertas pelo valor que cada uma deixa.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/fin/consumer-surplus

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

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)

Exemplo de requisição

{
  "willingness_to_pay": 120,
  "price": 85
}

Exemplo de resposta

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

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

max_abs 1000000000000

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

Informe os dois valores na mesma moeda; receba o excedente, as entradas repetidas e a fórmula surplus igual a willingness_to_pay menos price. Se o preço real superar a disposição a pagar, a compra não ocorreria neste contrato e a tarefa falha com invalid_input em vez de um excedente negativo.

O que significa o excedente unitário: disposição a pagar menos preço

Esse último caso não é um número negativo num extrato: é um negócio que não ocorreria, então a calculadora o rejeita como invalid_input em vez de inventar um prejuízo.

Contrato de entrada, forma da resposta e comportamento em caso de erro

Se price for negativo, o tratador rejeita com uma mensagem clara de que o preço de fato pago não pode ser negativo. Valores iguais são válidos e devolvem surplus de zero. Exemplo: cento e vinte de disposição a pagar a um price de oitenta e cinco produz surplus de trinta e cinco. Mantenha os pedidos pequenos, fixe o surplus arredondado nos testes e você terá uma cifra de bem-estar reproduzível para planilhas, plugins LMS e workers de borda sem montar um motor de curva de demanda próprio. Envie por POST um corpo JSON com dois números finitos obrigatórios. willingness_to_pay é o preço de reserva numa unidade monetária; os aliases wtp, reservation_price, max_price e max_wtp apontam para o mesmo campo para que uma exportação de pesquisa ou uma folha de exercícios conserve os nomes de coluna. price é o valor de fato pago nessa mesma moeda; aceitam-se os aliases actual_price, paid, price_paid e p. Cada campo numérico pode chegar como número JSON ou como string numérica. Campos ausentes, strings vazias e valores não finitos falham com invalid_input nomeando o campo. Se willingness_to_pay for negativo, o tratador rejeita o pedido porque um preço de reserva não pode ser negativo; reserva zero só é permitida quando o preço pago também é zero, e então o excedente é zero. Se price for estritamente maior que willingness_to_pay, o tratador rejeita com uma mensagem de que price supera a disposição a pagar — essas falhas não são faturadas. Em sucesso, o corpo ecoa willingness_to_pay e price arredondados a duas casas decimais, informa surplus como a diferença arredondada a duas casas e inclui uma string formula que reafirma a identidade. Combine o JSON com a sua própria regra sobre qual unidade você está avaliando — um ingresso, uma passagem, um mês de assinatura — porque este ponto subtrai os dois números que você envia; ele não consulta listas de preços, não converte moedas nem escala por quantidade.

Onde uma calculadora do excedente unitário do consumidor se justifica

Como a implementação é parse de nível A puro, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo e sem rede de saída.

Perguntas técnicas

Como o excedente do consumidor é calculado a partir da disposição a pagar e do preço?

Envie números finitos não negativos willingness_to_pay (o preço de reserva) e price (o valor pago). A API devolve surplus = willingness_to_pay − price, arredondado a duas casas decimais.

Quanto custa a calculadora do excedente do consumidor?

A ferramenta do navegador é gratuita. Pedidos API usam saldo pré-pago do KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é faturada.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

O que significa o excedente unitário: disposição a pagar menos preço

Onde uma calculadora do excedente unitário do consumidor se justifica

Casos de uso

Avaliar um preço publicado diante da sua reserva

Checagens de sala de aula e de lição de casa

Páginas de oferta e questionários de preço

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Limites

Erros

Notas técnicas

O que significa o excedente unitário: disposição a pagar menos preço

Contrato de entrada, forma da resposta e comportamento em caso de erro

Onde uma calculadora do excedente unitário do consumidor se justifica

Perguntas técnicas

obrigado