Brazil CVM Filings for Commodity Trading Research

Brazil filings commodity trading desks need issuer documents behind producers and processors. apicvm serves DFP/ITR/FRE over HTTP. Pair with your price terminal — apicvm does not ship futures curves or warehouse receipts.

The persona

Desk analysts reading miner / protein / oil E&P filings
Quant researchers attaching document UUIDs to event studies
Risk teams reviewing FRE operational risk language

The problem

Price ticks without the regulatory PDF miss capex, covenants, and contingency footnotes. Portal ZIP dumps lack stable IDs for desk notebooks.

Solution flow

Producer ticker → list DFP/ITR → download → optional FRE name filter

curl -H "Authorization: Bearer $APICVM_KEY" \
  "$APICVM_URL/v1/documents?ticker=VALE3&type=DFP&year=2024&perPage=20"

See MRFG3 and VALE3 company pages.

Example: protein + mining pack

import os, requests

BASE = os.environ["APICVM_URL"]
H = {"Authorization": f"Bearer {os.environ['APICVM_KEY']}"}

for t in ["MRFG3", "VALE3", "RECV3"]:
    itr = requests.get(
        f"{BASE}/v1/documents",
        headers=H,
        params={"ticker": t, "type": "ITR", "year": 2024, "perPage": 20},
    ).json()["data"]
    print(t, len(itr))

Current limitations

No OHLCV, freight indices, or inventory datasets
Complementary to Bloomberg/Refinitiv price screens — not a replacement (Bloomberg alternative page)
Extraction of PDF text is async on Pro

Next steps

Ready to integrate?

Get an API key and start querying Brazilian CVM filings programmatically.

Read the API docs Get API key