BCB/SICOR — Credito Rural¶
Dados de credito rural do Sistema de Operacoes do Credito Rural (SICOR), disponibilizados via API OData do Banco Central.
API¶
from agrobr import bcb
# Credito de custeio para soja, safra 2024/25
df = await bcb.credito_rural(produto="soja", safra="2024/25", finalidade="custeio")
# Filtrar por UF
df = await bcb.credito_rural(produto="soja", safra="2024/25", uf="MT")
# Agregacao por UF (soma municipios)
df = await bcb.credito_rural(produto="soja", safra="2024/25", agregacao="uf")
# Agregacao por programa
df = await bcb.credito_rural(produto="soja", safra="2024/25", agregacao="programa")
# Filtrar por programa
df = await bcb.credito_rural(produto="soja", safra="2024/25", programa="Pronamp")
# Filtrar por tipo de seguro
df = await bcb.credito_rural(produto="soja", safra="2024/25", tipo_seguro="Proagro")
Colunas — credito_rural¶
| Coluna | Tipo | Descricao |
|---|---|---|
safra |
str | Safra no formato "2024/2025" |
ano_emissao |
int | Ano de emissao do contrato |
mes_emissao |
int | Mes de emissao |
uf |
str | UF do municipio |
municipio |
str | Nome do municipio |
produto |
str | Produto financiado |
finalidade |
str | Finalidade (custeio, investimento, comercializacao) |
valor |
float | Valor financiado (R$) |
area_financiada |
float | Area financiada (ha) |
qtd_contratos |
int | Quantidade de contratos |
cd_programa |
str | Codigo do programa SICOR |
programa |
str | Nome do programa (Pronamp, Pronaf, etc.) |
cd_sub_programa |
str | Codigo do sub-programa |
cd_fonte_recurso |
str | Codigo da fonte de recurso |
fonte_recurso |
str | Nome da fonte (LCA, FNE, Poupanca rural, etc.) |
cd_tipo_seguro |
str | Codigo do tipo de seguro |
tipo_seguro |
str | Nome do seguro (Proagro, Seguro privado, etc.) |
cd_modalidade |
str | Codigo da modalidade |
modalidade |
str | Nome (Individual, Coletiva) |
cd_atividade |
str | Codigo da atividade |
atividade |
str | Nome (Agricola, Pecuaria) |
regiao |
str | Regiao (SUL, CENTRO-OESTE, etc.) |
Dimensoes SICOR¶
A API retorna codigos de dimensao (cdPrograma, cdFonteRecurso, etc.)
que o parser enriquece automaticamente com nomes legiveis via dicionarios
hardcoded. Codigos desconhecidos geram "Desconhecido ({code})" com log warning.
Finalidades¶
custeio— financiamento da producaoinvestimento— aquisicao de maquinas, infraestruturacomercializacao— financiamento da comercializacao
Nota:
industrializacaofoi removida — endpoint nao existe mais na API reestruturada.
Produtos¶
Soja, milho, cafe, algodao, arroz, trigo, feijao, cana-de-acucar, mandioca, sorgo, aveia, cevada, entre outros. Use o nome canonico do agrobr.
MetaInfo¶
df, meta = await bcb.credito_rural(produto="soja", safra="2024/25", return_meta=True)
print(meta.source) # "bcb"
print(meta.schema_version) # "1.1"
Status (fev/2026)¶
A API SICOR foi reestruturada (~2024). Endpoints antigos (CusteioMunicipio,
InvestimentoMunicipio) foram substituidos por CusteioRegiaoUFProduto,
InvestRegiaoUFProduto, ComercRegiaoUFProduto.
O operador OData $filter eq nao funciona nos novos endpoints. O client usa
contains(nomeProduto,'...') para filtro server-side por produto, e filtra
ano/UF client-side apos download paginado. Filtros por programa e tipo de
seguro tambem sao client-side (API nao suporta $filter nesses campos).
Retry com backoff exponencial (6 tentativas, timeout read 120s).
A API retorna HTTP 500 de forma intermitente. Desde v0.8.0, o agrobr
utiliza Base dos Dados (BigQuery) como fallback automatico quando a API
OData falha. Instale com pip install agrobr[bigquery].
Fonte¶
- API:
https://olinda.bcb.gov.br/olinda/servico/SICOR/versao/v2/odata - Atualizacao: mensal
- Historico: 2013+
- Contract: v1.1 (11 novas colunas nullable desde v0.10.1)