Python · Open Source · PyPI

Brazilian agricultural data in one line of code

CEPEA, CONAB, IBGE, NASA POWER, USDA, B3 and 34 more — 40 sources behind one unified API with automatic fallback, smart caching and versioned contracts.

$ pip install agrobr ⎘
soybeanR$ 131.07▼ 0.90% cornR$ 62.99▼ 0.10% live cattleR$ 348.80▼ 0.19% coffeeR$ 1,505.10▲ 2.10% wheatR$ 1,376.72▲ 0.54% cottonR$ 413.70▼ 0.33% CEPEA indicators · Jun 17, 2026 · fetched via agrobr
40sources
36datasets
6,400+passing tests
92%coverage
MITlicense

Proof, not promise

Nobody typed this number.

The panel beside this text is not a mockup: CEPEA publishes, agrobr fetches, this page updates — every trading day, with automatic fallback, DuckDB cache and a validated contract.

from agrobr import datasets df = await datasets.preco_diario("soja") # 10 trading days · CEPEA → Notícias Agrícolas → cache
R$ 131.07 / 60kg bag
soybean · CEPEA/ESALQ indicator · Jun 17, 2026
2026-06-12129.85
2026-06-15129.24
2026-06-16132.26
2026-06-17131.07
CEPEA
✗ 403 Forbidden
Not. Agrícolas
✓ 200 OK
contract v1.0
✓ valid schema
DataFrame
◈ delivered

Semantic Layer

Ask for the data.
The source is an internal detail.

Datasets abstract multiple sources with automatic fallback. When CEPEA returns a 403, agrobr fetches Notícias Agrícolas. When the server goes down, it serves from cache.

preco_diario
Spot prices for 20 agricultural commodities
CEPEA → NA → cache
estimativa_safra
Current crop season estimates
CONAB → IBGE LSPA
credito_rural
Rural credit by crop, program, insurance and modality
BCB/SICOR → BigQuery
clima
Monthly climate by state or daily by station
INMET → NASA POWER
futuros_agricolas
B3 futures: settlements, history and open interest
B3
desmatamento
Consolidated PRODES deforestation + DETER alerts
INPE TerraBrasilis
exportacao
Agricultural exports by NCM code
ComexStat → ABIOVE
seguro_rural
Rural insurance policies and claims
MAPA PSR
explore all 36 datasets in the docs →

Infrastructure

Built for production,
not for demos.

⟳

Cascading Fallback

Primary source fails → tries the secondary → serves from cache. Transparent.

⛁

Cache DuckDB

Local cache for CEPEA indicators (smart TTL, expires 6pm). Optional snapshots for reproducibility.

◈

Versioned Contracts

Guaranteed schema per dataset. Breaking changes only on majors. Semver.

↯

Async-first

Native httpx with a sync wrapper. Works in Jupyter, FastAPI and Airflow.

✓

Pydantic v2 Validation

Typed models. Statistical sanity checks. Layout fingerprinting.

◎

Deterministic Mode

Full reproducibility via contextvars. For papers and audits.

Data sources

40 origins. One API.

Every source has its own parser with versioning, fingerprinting and encoding handling. All you see is the DataFrame.

the real brazil, in dots — official ibge mesh
CEPEA/ESALQ CONAB IBGE/SIDRA BCB/SICOR NASA POWER B3 ComexStat USDA SICAR MapBiomas INPE Queimadas TerraBrasilis ZARC ANTAQ UN Comtrade CFTC ANDA ABIOVE ANEC UNICA IMEA DERAL INMET Notícias Agrícolas ANP Diesel MAPA PSR ANTT Pedágio Agrofit/MAPA FUNAI ICMBio INCRA Acervo Fundiário IBAMA MapBiomas Alerta Lista Suja ANA/SNIRH SFB RNC/CultivarWeb EMBRAPA Solos Rio Verde

in amber: non-commercial or restricted license — details at docs/licenses

Get started

pip install agrobr

MIT License (code). 6,400+ passing tests. 40 sources. 36 datasets.

Documentation GitHub ↗ PyPI ↗