Fintatica
Home
WebsiteContato
Home
WebsiteContato
  1. Investment Funds
  • Getting started
    • Introduction
    • Quick start
    • SDKs & Libraries
    • Authentication & Limits
    • Error Codes
    • Common Params
  • Investment Funds
    • Retrive Portifolio
      GET
    • FOF Portifolio Look-Through
      GET
  • Others
    • Flight Fares
      GET
  • FAQ
    • FAQ
  1. Investment Funds

Retrive Portifolio

GET
https://api.fintatica.com.br/v1/fund/{CNPJ}/portfolio

What is it?#

CDA (Composição da Carteira) is the official monthly holdings file Brazilian funds send to the CVM. Each competence month (e.g., 2025-06) contains line items with quantities, end-month values in BRL, and classification tags such as aplication_type (application bucket: e.g., “Funds holdings”, “Public Bonds”). Files can be amended by the fund after first publication.

Why this data matters?#

It’s the only regulatory, point-in-time view of what Brazilian funds actually hold. It unlocks exposure analysis, mandate compliance checks, risk aggregation, manager due diligence, and FoF look-through logic.
Some other important points are:
Exposure & risk: Identify asset mix, issuer exposures, credit quality hints, duration proxies, and concentration risks.
Peer benchmarking: Compare holdings and portfolio shifts vs. peers or indices; track style drift and conviction.
Compliance & governance: Check RCVM 175 alignment flags, service providers, and operational status (functioning as normal, suspensions, liquidations).
Performance drivers: Connect holdings to market factors (rates, credit spreads) to explain NAV (PL) moves and anticipate next reports.
Flow inference (advanced): Changes in PL alongside purchases/sales fields can hint at subscriptions/redemptions vs. mark-to-market.

Important Considerations#

1.
Accruals vs. investments: “Disponibilidades,” valores a pagar/receber are not investment bets; they reconcile cash & settlements and can push weights slightly over/under 100% due to rounding and timing. Your example sums to ~100.42%, within a reasonable rounding window.
2.
Derivatives signs: Short index futures appear with negative value/weight, which reduces net exposure; naïve charts that clamp negatives to zero will misstate risk.

Examples of use#

Top holdings & sectors (by aplication) with a one-liner chart: Example mix in your sample: Public Bonds ~62.18%, Funds Holdings ~37.95%, small cash/settlement and futures hedge rounding the rest.
Fact sheet exposure table (public debt LFT/LTN/NTN-B, equities via FoF, cash).
Compliance checklist: flag if related-party exposure exceeds internal thresholds.
Effective concentration (HHI): Your sample’s HHI ≈ 0.098 → ~10 effective bets, helpful for risk parity and capacity analysis.
Hedge efficacy: Track sign and magnitude of index futures vs. equity beta proxy from FoF sleeves; alert when hedge under-covers due to market moves.
Liquidity stress tests: Tag each bucket with a liquidity horizon and haircuts; simulate T-3/T-5 outflows.
Governance map: Build graphs linking funds and managers via emissor_ligado and CNPJ to surface internal “platform” cross-holdings.
Macro attribution: Split NTN-B vs. LFT term buckets and track duration drift month-over-month.

Request

Authorization
Add parameter in header
x-api-key
Example:
x-api-key: ********************
Path Params

Query Params

Responses

🟢200OK
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.fintatica.com.br/v1/fund/11701977000152/portfolio?date=2025-06-01' \
--header 'x-api-key: <api-key>'
Response Response Example
{
    "success": true,
    "reference_date": "string",
    "data": {
        "fund": {
            "id": "string",
            "cvm_id": "string",
            "cvm_code": "string",
            "cnpj": "string",
            "type": "string",
            "status": "string",
            "status_date": "string",
            "registration_date": "string",
            "creation_date": "string",
            "exercise_date": "string",
            "exercise_end_date": "string",
            "cancelation_date": null,
            "updated_at": "string",
            "name": "string",
            "rcvm175": {
                "is_compliant": true,
                "compliance_date": "string"
            },
            "nav_value_reported": 0,
            "nav_value_reported_reference_date": 0,
            "integrants": [
                {
                    "type": "string",
                    "name": "string",
                    "document": "string",
                    "document_type": "string"
                }
            ],
            "total_portfolio_value": 0,
            "total_portfolio_value_reference_date": "string"
        },
        "portfolio": [
            {
                "id": "string",
                "application_type": "string",
                "asset_type": "string",
                "related_issuer": true,
                "business_type": "string",
                "sales_quantity": 0,
                "sales_value": 0,
                "purchases_quantity": 0,
                "purchases_value": 0,
                "final_position_quantity": 0,
                "final_position_value": 0,
                "final_position_cost": null,
                "confidentiality_deadline": "string",
                "portfolio_share_percent": 0,
                "metainfo": {}
            }
        ]
    }
}
Previous
Common Params
Next
FOF Portifolio Look-Through
Built with