Valores das séries macroeconômicas do Ipeadata¶
Resumo¶
Os valores das séries macroeconômicas do Ipeadata (câmbio, juros, preços, produção, contas públicas, entre outras) numa tabela só: uma linha por série e data. Cada série tem sua periodicidade, unidade e fonte, descritas em series.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | ipeadata/valores |
| Órgão | Instituto de Pesquisa Econômica Aplicada (Ipea) |
| Página oficial | http://www.ipeadata.gov.br/api/ |
| Licença | Termo de Direitos de Uso do Ipeadata: o conteúdo é informação pública que pode ser livremente distribuída e copiada, com obrigação de citar a fonte Ipeadata; sem garantia de exatidão; http://www.ipeadata.gov.br/iframe_direitouso.aspx |
| Periodicidade | varia por série (diária a decenal; ver series.pernome); o Ipeadata registra a última carga em series.seratualizacao |
| Cobertura | 1808 a em-curso |
| Unidade (uma linha) | valor de uma série numérica macroeconômica em uma data |
| Granularidade | espacial: Brasil (maioria), Estados Unidos e Mundial; temporal: da data da observação: dia a década, conforme a série |
| Formato bruto | JSON da API OData v4 do Ipeadata (função ValoresSerie), um arquivo por série |
| Estado no lake | convertido |
| Partições | base, periodicidade, ano |
| Chave | sercodigo, valdata |
| Colunas | 8 |
| Unidades de medida | valvalor: varia por série (series.uninome e series.mulnome); valor: varia por série (series.uninome e series.mulnome) |
| Dados pessoais | nenhum |
| Eras | nenhuma |
| Revisado em | 2026-11-10 |
| Versão do fetcher | 0.3.2 |
Origem e coleta¶
- O fetcher consulta a função
ValoresSerie(SERCODIGO='<código>')da API OData v4 do Ipeadata e grava uma resposta JSON por série, com o nome<SERCODIGO>@AAAAMMDD.json. As séries estão em duas pastas do bruto:macro/(220 códigos em 2026-11-10) eseries/(3.962 códigos). - A pasta
regional/esocial/guardam séries regionais e sociais, que vão paravalores_regional. - Cada série pode ter várias versões com carimbos diferentes; o conversor escolhe a mais recente. Se a mesma série existe em mais de uma pasta, vale só a cópia de carimbo mais recente, de qualquer pasta (as outras são ignoradas e registradas no log).
- Arquivos de valores no bruto em 2026-11-10: 3.962 códigos em
series/, 220 emmacro/(40 com mais de uma versão), 166 emregional/e 2 emsocial/.
Conteúdo¶
- Uma linha por série e data. Na amostra de 7 séries macroeconômicas: 15.370 linhas, 14.476 datas distintas de 1808-08-01 a 2026-11-05, nenhuma chave repetida.
- Das 15.370 linhas da amostra, 5.600 (36%) têm valor nulo, a maior parte na taxa diária da Anbima (
ANBIMA366_TJTLN12366). - A cobertura de cada série varia: o catálogo não traz a data inicial; ela só se vê nos valores. A menor data observada na amostra (1808) não vale para as demais séries.
- Três arquivos de
macro/(IGP_IGPM,INPC_INPC,PIB_PIB; 136 bytes) têm a listavaluevazia e seus códigos não estão no catálogo; o conversor os ignora, registra um aviso no log e os conta como pulados (skipped).
Variáveis¶
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
sercodigo |
SERCODIGO | texto | Código da série (junta com series.sercodigo) |
— | todo |
valdata |
VALDATA | texto | Data do valor, como a API entrega, com hora e deslocamento de fuso (ex.: T00:00:00-03:00; vê-se também -02:00 do horário de verão) |
ISO 8601 | todo |
valvalor |
VALVALOR | decimal | Valor da série na data, como publicado | varia por série; ver series.uninome e series.mulnome |
todo |
nivnome |
NIVNOME | texto | Nível territorial; sempre vazio na base macroeconômica | nulo em todas as linhas da amostra | todo |
tercodigo |
TERCODIGO | texto | Código do território; sempre vazio na base macroeconômica | nulo em todas as linhas da amostra | todo |
data |
— (gerada) | texto | Data do valor no formato AAAA-MM-DD, os 10 primeiros caracteres de valdata |
AAAA-MM-DD, texto | todo |
valor |
— (gerada) | decimal | Cópia de valvalor convertida para decimal |
igual a valvalor |
todo |
_origem |
— (conversor) | texto | Série de origem da linha: o código do arquivo bruto (PRECOS_IPCAG); o rodapé do Parquet lista as séries do arquivo (quantilica.members) |
— | todo (depois da reconversão) |
No lake¶
- Dataset
ipeadata/valores, particionado porbase,periodicidadeeano(ano da data da observação, inteiro):base=macro/periodicidade=mensal/ano=2024/valores_macro_mensal.parquet, um arquivo por pasta, com as observações de todas as séries daquele ano. A coluna_origemtraz o código da série de cada linha, e o rodapé do Parquet lista as séries do arquivo (quantilica.members, com sha256 e linhas de cada uma). Cada série aparece em tantos arquivos quantos forem os anos que ela cobre. A série com alguma linha sem data AAAA-MM-DD emvaldatanão é convertida (erro do conversor). baseémacro, exceto quando a pasta do bruto se chamasocial; como as séries sociais têmnivnomepreenchido, elas vão paravalores_regional, ebase=socialnão ocorre na prática.periodicidadevem do metadado da série (pernome) em minúsculas e sem acento:diaria,mensal,trimestral,anual,decenal,quinquenal,quadrienal,irregular,nao_se_aplica. Série sem periodicidade nos metadados vai paraperiodicidade=__HIVE_DEFAULT_PARTITION__.- Chave natural: (
sercodigo,valdata), sem repetição na amostra. - O conversor lê o JSON da série (
ValoresSerie), renomeia as colunas para minúsculas e acrescentadata(os 10 primeiros caracteres devaldata, sem deslocamento de fuso) evalor(valvalorcomo decimal; o que não converte vira nulo).valvaloré sempre decimal (série só com valores inteiros também), e as demais colunas são texto. - Textos vazios em
nivnomeetercodigoviram nulo. - Séries cuja resposta não tem
VALDATAeVALVALOR, e séries vazias, são ignoradas com um aviso no log e contadas como puladas (skipped).
Cuidados de uso¶
- Mesma série em mais de uma pasta. Em 2026-11-10 havia mais de cem códigos em
macro/eseries/, 90 emseries/eregional/e 2 emseries/esocial/. Todas as cópias iriam para o mesmo destino; o conversor mantém só a de carimbo mais recente. Antes da correção (conversor até a 0.3.2) valia a última pasta em ordem alfabética, mesmo sendo a mais antiga: emABRAS12_INVNR12, a cópia demacro/(69 linhas) era substituída pela deseries/(68). Se o lake foi gerado por versão anterior, reconverta (veja oCHANGELOG.md). - Unidade e escala por série. O valor vem como publicado; consulte
series.uninomeeseries.mulnomeantes de somar ou comparar. - Muitos nulos. 36% das linhas da amostra têm valor nulo (7 séries); filtre ou trate antes de calcular.
datadescarta a hora.dataé o texto da data local;valdatamostra o fuso. Não some horas adata.- Séries diárias nulas. A taxa Anbima diária da amostra tem 14.022 linhas, boa parte nulas (feriados e fins de semana).
- Fontes de terceiros. O Ipeadata republica séries de outras instituições (campo
series.fntnome); a exatidão é da fonte original, conforme o termo de uso. - Séries inativas. Séries com
series.serstatus = Ijá não recebem atualizações. - Revisões. O Ipeadata pode revisar valores passados; o lake guarda a última versão coletada de cada série.
Exemplos¶
Média anual da taxa de juros diária da Anbima em uma série, ignorando nulos (a unidade está em series):
import duckdb
duckdb.sql("""
SELECT year(CAST(data AS DATE)) AS ano, avg(valor) AS media
FROM read_parquet('lake/ipeadata/valores/**/*.parquet', hive_partitioning = true)
WHERE sercodigo = 'ANBIMA366_TJTLN12366' AND valor IS NOT NULL
GROUP BY ano ORDER BY ano
""").show()
Referências¶
- API do Ipeadata (entidades Metadados e Valores): http://www.ipeadata.gov.br/api/
- Direitos de uso: http://www.ipeadata.gov.br/iframe_direitouso.aspx