Docs · Datasheet
Crédito
imobiliário: juros por banco.
Taxa de juros do financiamento imobiliário (pessoa física) por instituição financeira, nas 6 modalidades do BCB, com ranking da menor à maior taxa, e a taxa média do mercado desde 2011.
Motivação
O BCB publica a taxa de cada banco em um serviço de consulta (Olinda) e a média do mercado em outro (SGS). Quem compara financiamento, corretores, imobiliárias, contadores, jornalistas e planejadores financeiros precisa dos dois juntos, em formato estável, com o mês de referência e a fonte.
Composição
- Unidade
- Instituição financeira em uma modalidade, em um mês.
- Modalidades
- Taxas de mercado e taxas reguladas, cada uma em prefixado, pós-fixado referenciado em TR e pós-fixado referenciado em IPCA (códigos BCB 903101, 903201, 903203, 905101, 905201, 905203).
- Campos da instituição
- modalidade, instituicao, cnpj8, taxa_mes (% a.m.), taxa_ano (% a.a.), posicao_bcb no estado; na API: rank, observacao.
- Taxa média do mercado
- SGS 20772 (taxas de mercado, % a.a.), 20773 (taxas reguladas, % a.a.), 25497 e 25498 (as mesmas médias em % a.m.), mensais desde 03/2011.
Cobertura: Taxas por instituição desde 01/2012 (carga histórica noturna, uma vez) até o último mês publicado pelo BCB; a resposta informa o primeiro, o último e o total de meses.
Como é coletado
- Fonte oficial
- BCB, Olinda: olinda.bcb.gov.br/olinda/servico/taxaJuros/versao/v2/odata/TaxasJurosMensalPorMes; BCB, SGS: api.bcb.gov.br/dados/serie/bcdata.sgs.{20772,20773,25497,25498}/dados.
- Método
- Coletor próprio (lib/credito-imobiliario.ts) identificado no User-Agent como "PIRANOT-DataX/1.0". Incremental: o mês de instituições já gravado é fixo e não é pedido de novo; as séries SGS são pedidas do último ponto gravado em diante e uma revisão vira errata. A API e a página leem só do estado.
- Cadência
- A fonte é mensal (modalidades de tipo "M" no Olinda). A checagem roda toda segunda às 05h e traz o mês novo quando o BCB o publica. Carga histórica: uma vez, de madrugada (01h-06h), retomável.
- Orçamento de requisições
- Por rodada semanal: 4 (SGS) + 1 (descobrir o mês mais novo) + 1 por mês que falta, normalmente 6 requisições por semana; no máximo 1 por segundo (2 s na carga histórica, cerca de 175 requisições); timeout de 30 s; backoff exponencial em 429 e 5xx.
- Túnel
- Não há.
Pré-processamento e limpeza
- Mês de referência normalizado para AAAA-MM; nome da modalidade do BCB mapeado, sem acento, para um id fixo (mercado-prefixado, mercado-tr, mercado-ipca, regulado-prefixado, regulado-tr, regulado-ipca). Modalidade desconhecida reprova o mês.
- Ranking: da menor para a maior taxa ao ano dentro de cada modalidade. Taxa 0,00 publicada pelo BCB fica no dado, sem posição e fora de menor e maior.
- Nenhum valor é arredondado nem recalculado: as taxas são as publicadas, com duas casas.
Checks de qualidade aplicados
- Esquema: mês AAAA-MM, modalidade conhecida, instituição e CNPJ-base de 8 dígitos presentes, taxas numéricas; série SGS não vazia, no 1º dia do mês.
- Faixa: taxa ao ano entre 0 e 30% a.a. (taxa mensal entre 0 e 2,5% a.m. nas séries SGS).
- Coerência: a taxa mensal e a anual publicadas juntas precisam bater, (1+m)^12-1, com folga de 0,15 p.p. para o arredondamento.
- Unicidade e continuidade: nenhuma instituição repetida na modalidade; série SGS mensal sem buracos.
- Salto: a mediana de uma modalidade não pode mudar mais de 4 p.p. de um mês para o outro; z-score da série SGS acima de 4 contra o histórico retém o ponto.
- Verificação antes de publicar: os dados passam pelos checks antes de ir ao ar; o que reprova fica retido e a API segue entregando a última versão boa. Toda resposta informa o resumo qualidade.
Licença e usos
- Licença
- ODbL 1.0 (Banco Central do Brasil). A base derivada também fica sob ODbL; atribuição: "Fonte: Banco Central do Brasil, processamento PIRANOT".
- Usos
- Comparar financiamento imobiliário entre bancos, acompanhar a taxa média do mercado, pautas e relatórios. Não substitui simulação nem proposta da instituição.
Limitações conhecidas
- A taxa é a média informada ao BCB para o mês, não a taxa que um cliente específico receberá.
- Modalidades pós-fixadas não são comparáveis às prefixadas; compare dentro da mesma modalidade.
- O BCB publica 0,00 para algumas instituições; elas ficam fora do ranking.
- Dado mensal: a publicação do BCB tem defasagem; o último mês pode ser o do mês anterior.
Distribuição
| Endpoint | Descrição |
|---|---|
GET /api/v1/credito-imobiliario | Ranking por instituição e taxa média; parâmetros mes, modalidade, instituicao e de. |
Metadados (DCAT / schema.org Dataset)
- dct:identifier
- credito-imobiliario
- dct:publisher
- PIRANOT
- dct:source
- Banco Central do Brasil
- dct:license
- ODbL 1.0
- dct:temporal
- 2012-01 ao último mês publicado
- dct:spatial
- Brasil
- dct:accrualPeriodicity
- mensal
- dcat:distribution
- JSON via API v1
Histórico de versões
| Versão | Mudança |
|---|---|
| 1.0 (27/10/2026) | Taxas por instituição em 6 modalidades, taxa média do mercado (SGS), API /api/v1/credito-imobiliario e página /dados/credito-imobiliario. |
Reportar erro
POST /api/v1/qualidade/reportar com dataset, chave_registro, valor_visto, valor_esperado e fonte_esperada (detalhes em /docs/qualidade). Correções confirmadas aparecem em /erratas. Sem chave, escreva para [email protected].
Aviso. O DataX PIRANOT organiza dados de fontes oficiais e pode conter erros ou atrasos. Confira na fonte oficial, indicada em cada dado, antes de qualquer decisão importante. Respostas geradas por IA podem errar.DataX PIRANOT organises data from official sources and may contain errors or delays. Check the official source, linked with each dataset, before any important decision. AI-generated answers can be wrong.