Renda FII API integration services (FII dividends · Open Finance Brasil)

Feature modules

Data available for integration

The table below summarizes the structured data we can expose, mapped to the Renda FII screen or upstream public source it originates from. This is the OpenData inventory most fintech and wealth-tech consumers ask for.

Typical integration scenarios

1. Wealth-tech consolidation — A platform like a private bank or a multi-broker dashboard wants to merge a customer's positions held at the broker (read via Open Finance Brasil Phase 4, which since 2023 has covered investment funds, CDBs, Tesouro Direto and equities) with the user's manually curated Renda FII wallet. Our endpoint returns one canonical position list per ticker, deduplicated by share count and avg. price.
2. Tax (Imposto de Renda) automation — An accounting product needs every FII rendimento received in the calendar year, broken down by month and by ticker. We pipe the payment-history ledger straight into the IR engine, including the cut-off rules required for Brazilian declaration.
3. Cash-flow forecasting for FIRE / passive-income users — Personal finance apps targeting the "viver de FII" community pull the next 30 / 60 / 90-day payout forecast (the exact view Renda FII shows) and roll it into their monthly budget projections.
4. Distribution anomaly alerts — A risk tool monitors the per-cota payment versus the trailing 12-month average and pushes a webhook when a fund (e.g. MXRF11, BTLG11, KNIP11) materially deviates, so analysts can react before the market opens.
5. Migration between trackers — Users moving from Renda FII to (or from) Finy FII, Mais Retorno, Kinvo, Status Invest, Investidor 10 or My Fiis often need a one-shot export. Our converter takes the Renda FII CSV/JSON backup and normalizes it into the target schema, preserving avg. price and history.

Technical implementation

Below are example payloads we deliver. Auth uses a customer-issued bearer token; rate limits and idempotency keys are documented in the OpenAPI spec we ship with the source code.

1) Portfolio sync (read avg. price + positions)

POST /api/v1/rendafii/portfolio
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>

{
  "user_ref": "u_29381",
  "include_avg_price": true,
  "include_segment": true
}

200 OK
{
  "user_ref": "u_29381",
  "positions": [
    {"ticker": "MXRF11", "qty": 1200, "avg_price": 9.84, "segment": "Recebiveis"},
    {"ticker": "HGLG11", "qty":   45, "avg_price": 158.72, "segment": "Logistica"},
    {"ticker": "KNCR11", "qty":  300, "avg_price": 102.10, "segment": "Recebiveis"}
  ],
  "updated_at": "2026-04-15T03:12:00-03:00"
}

2) Dividend forecast (next month)

GET /api/v1/rendafii/dividends?user_ref=u_29381&month=2026-05
Authorization: Bearer <ACCESS_TOKEN>

200 OK
{
  "month": "2026-05",
  "expected_total_brl": 1843.27,
  "items": [
    {"ticker": "MXRF11", "per_cota": 0.10, "qty": 1200, "amount": 120.00, "pay_date": "2026-05-15", "buy_by": "2026-04-30"},
    {"ticker": "HGLG11", "per_cota": 1.05, "qty":   45, "amount":  47.25, "pay_date": "2026-05-14", "buy_by": "2026-04-30"},
    {"ticker": "KNCR11", "per_cota": 1.18, "qty":  300, "amount": 354.00, "pay_date": "2026-05-13", "buy_by": "2026-04-29"}
  ],
  "source": "B3 / Fundos.NET"
}

3) Webhook on new announcement

POST https://your-app.example.com/hooks/rendafii
X-Signature: t=...,v1=...
Content-Type: application/json

{
  "event": "fii.distribution.announced",
  "ticker": "BTLG11",
  "per_cota": 0.78,
  "ex_date": "2026-04-30",
  "pay_date": "2026-05-12",
  "source_url": "https://fnet.bmfbovespa.com.br/...",
  "received_at": "2026-04-26T18:42:11-03:00"
}

# error envelope (standardized across endpoints)
{
  "error": {"code": "rate_limited", "message": "60 req/min exceeded", "retry_after": 12}
}

Market positioning & user profile

Renda FII targets Brazilian retail FII investors — a segment that, according to B3, reached 3.13 million unique cotistas by March 2026 across 434 listed funds. The user base skews mobile-first (the app ships on Android and iOS, with no web client) and centers around the "renda passiva" / FIRE community that prioritizes monthly dividend visibility. Integrators commissioning this work are typically Brazilian wealth-tech startups, IFAs, accountants serving high-volume PJ investors, content creators with FII portfolios for their audience, and overseas products covering Brazilian REITs (FIIs) for diaspora or LATAM-focused investors.

Screenshots

Click any screenshot to see a larger version.

Similar apps & integration landscape

The Brazilian FII tracking and consolidation ecosystem is wide, and most teams that integrate Renda FII end up touching one or more of the products below. We frame them as adjacent surfaces, not as comparisons: each holds slightly different data, and unified exports across them are a recurring ask.

FAQ

What do you need from me to start?

How long does delivery take?

How do you handle compliance?

Can you also integrate similar apps like Finy FII, Kinvo, or Mais Retorno?