Percentil de renda familiar EUA
Uma renda domiciliar de 80.000 fica no percentil 50, bem na mediana: metade dos domicílios dos EUA ganha menos. Informe qualquer renda anual do domicílio e veja sua posição no país. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Renda
- 80.000
- Percentil
- 50
- Percentil arredondado
- 50
- Posto
- 50th
- Proporção abaixo
- 50
Uma calculadora de percentil de renda familiar dos Estados Unidos responde à pergunta que um salário bruto nunca responde: dada esta renda anual do domicílio, onde ela se situa entre os lares americanos? Ofertas de emprego, debates de mudança, conversas de hipoteca e artigos de finanças pessoais citam uma cifra em dólares, mas essa cifra só se torna comparável quando se sabe quantos domicílios ganham menos. Esta ferramenta aceita uma renda anual não negativa em dólares americanos, localiza-a numa tabela fixa de distribuição de renda familiar, interpola de forma linear entre nós vizinhos e devolve o posto percentil de zero a cem.
Como uma tabela interna de renda familiar vira percentil
A distribuição de renda familiar dos Estados Unidos é uma curva acumulada: em cada valor em dólares, uma parcela dos domicílios ganha menos do que esse valor. Essa parcela, expressa de 0 a 100, é o posto percentil. Dada uma renda anual, o solver encontra os dois nós vizinhos que a enquadram e interpola de forma linear.
A identidade é P igual a P_lo mais a fração (income menos I_lo) dividida por (I_hi menos I_lo), vezes (P_hi menos P_lo). Uma renda que cai exatamente num nó devolve o percentil daquele nó, sem interpolação. Renda acima do último nó tabelado é limitada ao último percentil tabelado, em vez de inventar uma cauda não medida.
Renda zero mapeia para o percentil 0.
Onde uma calculadora de percentil de renda dos EUA ganha o lugar
Quem pesquisa percentil de renda nos EUA ou percentil de renda familiar já sabe que tem uma cifra em dólares e quer um posto, não uma conta de imposto, não uma conversão para salário por hora e não o percentil k-ésimo de um conjunto arbitrário que teria de enviar. Uma comparação de ofertas de emprego usa isso antes de aceitar uma mudança: cento e vinte e cinco mil dólares numa classificação nacional de domicílios pintam um quadro diferente do mesmo número como faixa tributária.
Como a implementação é código analítico parse de categoria A com uma tabela congelada, cada chamada correta permanece barata, sem tokens de modelo e sem rede de saída. Validação falha não consome saldo.
Casos de uso
Ofertas de emprego e posto na mudança
Transforme uma cifra anual do domicílio num percentil nacional antes de comparar propostas, cidades ou planos de renda dupla.
Explicações de finanças pessoais
Editoras e jornalistas podem anexar um posto de domicílio reproduzível ao lado de um salário citado, em vez de um rótulo vago de rico ou pobre.
Perguntas frequentes
Como se calcula o percentil de renda familiar nos Estados Unidos?
O solver consulta a renda anual numa tabela CDF familiar embutida e fixa e interpola de forma linear entre os dois nós vizinhos. Um nó exato devolve o percentil daquele nó; renda acima do último nó é limitada ao último percentil tabelado.
Deve informar o salário individual ou a renda do domicílio?
Informe a renda anual do domicílio em dólares americanos, a grandeza que a tabela embutida descreve. Salários individuais podem ser enviados, mas o posto ainda será lido contra a distribuição familiar, não contra uma tabela de ganhos por trabalhador.
O que acontece se a renda for negativa ou estiver ausente?
O posto percentil só está definido para um número finito não negativo; valores ausentes, vazios, NaN, Infinity e negativos não são cobrados.
Estes são dados ao vivo do Census do ano corrente?
É uma curva nacional estilizada de domicílios, não um fetch ao vivo de ACS ou CPS.
O que acontece com uma renda acima do fim da tabela?
Ela fica no último percentil da tabela, em vez de inventar uma faixa que nunca foi medida. Na outra ponta, uma renda igual a zero corresponde ao percentil 0.
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
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/us-income-percentile \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"income":80000}'const res = await fetch("https://api.kit.forhosting.com/fin/us-income-percentile", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"income": 80000
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/us-income-percentile",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"income": 80000
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/us-income-percentile", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"income":80000}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"income":80000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/us-income-percentile", 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
{
"income": 80000
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.us_income_percentile",
"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
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Limites
max_abs | 1000000000000000 |
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
Renda ausente, renda negativa e números não finitos falham com invalid_input e não são cobrados. Chamadas corretas são cobradas a US$ 0,002.
Contrato de entrada, erros e forma da resposta
Magnitudes acima do limite publicado também falham. Exemplo: oitenta mil dólares caem no nó mediano e devolvem percentile 50, rank 50th e band middle. Duzentos e vinte e cinco mil dólares ficam no meio do caminho entre os nós de duzentos mil e duzentos e cinquenta mil e devolvem percentile 87. Combine o posto com as próprias notas de custo de vida se precisar de contexto regional; este extremo só classifica contra uma tabela nacional de domicílios. Envie via POST um corpo JSON com um campo obrigatório: income, a renda anual do domicílio nos Estados Unidos, em dólares. Deve ser um número finito não negativo; os aliases annual_income, household_income, amount e salary são aceitos para que uma linha de folha de pagamento não precise de um passo de rename. Preferem-se números JSON; strings numéricas que se interpretem como um decimal finito são aceitas. Renda ausente, string vazia, NaN, Infinity, valor não numérico ou quantia negativa falham com invalid_input nomeando o campo e não são cobrados, porque um percentil não está definido para renda familiar negativa nesta tabela. Em caso de sucesso o corpo ecoa income e depois devolve percentile como o posto interpolado numa escala 0–100, percentile_rounded como o inteiro mais próximo, rank como o ordinal inglês desse inteiro —por exemplo 50th ou 91st—, share_below igual ao percentil, share_above igual a 100 menos o percentil, e band como um rótulo grosso como bottom_20, lower_middle, middle, upper_middle, top_20, top_10, top_5 ou top_1. A resposta também nomeia os nós que enquadram lower_income, lower_percentile, upper_income e upper_percentile, mais method linear_interpolation e uma string formula que voce pode exibir ao lado da resposta. O preço de um item correto é um US$ 0,002 fixo.
Onde uma calculadora de percentil de renda dos EUA ganha o lugar
Cursos de matemática do consumidor passam folhas de distribuição e precisam de um oráculo que marque renda negativa como invalid_input em vez de recortar para zero em silêncio. Painéis de remuneração e cadernos de orçamento doméstico chamam o mesmo contrato a US$ 0,002 por item correto sem levantar um pipeline de download do Census. Mantenha as solicitações pequenas, fixe o percentil interpolado nos testes e voce obtém um posto reproduzível de domicílios dos EUA para artigos, cartas de oferta e webhooks financeiros leves, sem fingir que a tabela é o microdado da pesquisa deste ano.
Casos de integração
Folhas de distribuição em sala de aula
Corrija itens de matemática do consumidor com um oráculo determinístico que rejeita renda negativa como invalid_input e devolve um percentil estável.
Perguntas técnicas
Quanto custa a calculadora de percentil de renda dos EUA?
A ferramenta do navegador é gratuita. Pedidos API são cobrados a US$ 0,002 por chamada correta; entrada inválida não é cobrada.