---
title: "Carteira de fundos"
method: GET
path: "/api/v2/funds/portfolio"
tags: ["Fundos"]
---

# Carteira de fundos

`GET /api/v2/funds/portfolio`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/funds/portfolio`
- Auth: HTTP bearer

Carteira de fundos FI e FIF, do arquivo CDA da CVM. As posições vêm agrupadas em títulos públicos, cotas de fundos, crédito privado, ativos listados, recebíveis e valores a pagar.

Use para ver onde o fundo investe e qual o peso de cada grupo de ativos.

Informe `symbols` ou `cnpjs`. Sem `referenceDate`, a resposta traz a carteira mais recente.

Filtre os grupos com `include`: `publicBonds`, `fundHoldings`, `creditAssets`, `listedSecurities`, `receivables` e `payables`.

Posições confidenciais aparecem só no total, em `confidentialSummary`.

A CVM publica o CDA com meses de atraso. Mostre `referenceDate` junto do dado.

Plano Pro.

## Query parameters

- `symbols` string: Tickers separados por vírgula, até 20. Ex.: JURO11,XPCA11.
- `cnpjs` string: CNPJs separados por vírgula, até 20, com ou sem pontuação.
- `page` integer: Número da página, a partir de 1.
- `limit` integer: Itens por página.
- `referenceDate` string: Mês de referência no formato YYYY-MM-DD.
- `include` string: Grupos de ativos separados por vírgula. Ex.: publicBonds,creditAssets.

## Response `200`

Carteiras

- object
  - `funds` FundPortfolio[], required
    - `symbol` string, nullable, required
    - `cnpj` string, required
    - `name` string, nullable, required
    - `referenceDate` string, required
    - `summary` object, required
    - `publicBonds` FundHolding[], required
      - `bucket` string, required
      - `assetType` string, nullable, required
      - `assetName` string, nullable, required
      - `issuerName` string, nullable, required
      - `issuerCnpj` string, nullable, required
      - `isin` string, nullable, required
      - `selicCode` string, nullable, required
      - `quantity` number, nullable, required
      - `marketValue` number, nullable, required
      - `costValue` number, nullable, required
      - `maturityDate` string, nullable, required
      - `confidential` boolean, required
      - `details` FundHoldingDetails, nullable, required
        - `applicationType` string
        - `negotiationType` string
        - `assetCode` string
        - `issueDate` string
        - `relatedIssuer` boolean
        - `purchasedQuantity` number
        - `soldQuantity` number
        - `purchaseValue` number
        - `saleValue` number
        - `confidentialUntil` string
        - `fundClassType` string
        - `subclassId` string
        - `issuerType` string
    - `fundHoldings` FundHolding[], required
      - `bucket` string, required
      - `assetType` string, nullable, required
      - `assetName` string, nullable, required
      - `issuerName` string, nullable, required
      - `issuerCnpj` string, nullable, required
      - `isin` string, nullable, required
      - `selicCode` string, nullable, required
      - `quantity` number, nullable, required
      - `marketValue` number, nullable, required
      - `costValue` number, nullable, required
      - `maturityDate` string, nullable, required
      - `confidential` boolean, required
      - `details` FundHoldingDetails, nullable, required
        - `applicationType` string
        - `negotiationType` string
        - `assetCode` string
        - `issueDate` string
        - `relatedIssuer` boolean
        - `purchasedQuantity` number
        - `soldQuantity` number
        - `purchaseValue` number
        - `saleValue` number
        - `confidentialUntil` string
        - `fundClassType` string
        - `subclassId` string
        - `issuerType` string
    - `creditAssets` FundHolding[], required
      - `bucket` string, required
      - `assetType` string, nullable, required
      - `assetName` string, nullable, required
      - `issuerName` string, nullable, required
      - `issuerCnpj` string, nullable, required
      - `isin` string, nullable, required
      - `selicCode` string, nullable, required
      - `quantity` number, nullable, required
      - `marketValue` number, nullable, required
      - `costValue` number, nullable, required
      - `maturityDate` string, nullable, required
      - `confidential` boolean, required
      - `details` FundHoldingDetails, nullable, required
        - `applicationType` string
        - `negotiationType` string
        - `assetCode` string
        - `issueDate` string
        - `relatedIssuer` boolean
        - `purchasedQuantity` number
        - `soldQuantity` number
        - `purchaseValue` number
        - `saleValue` number
        - `confidentialUntil` string
        - `fundClassType` string
        - `subclassId` string
        - `issuerType` string
    - `listedSecurities` FundHolding[], required
      - `bucket` string, required
      - `assetType` string, nullable, required
      - `assetName` string, nullable, required
      - `issuerName` string, nullable, required
      - `issuerCnpj` string, nullable, required
      - `isin` string, nullable, required
      - `selicCode` string, nullable, required
      - `quantity` number, nullable, required
      - `marketValue` number, nullable, required
      - `costValue` number, nullable, required
      - `maturityDate` string, nullable, required
      - `confidential` boolean, required
      - `details` FundHoldingDetails, nullable, required
        - `applicationType` string
        - `negotiationType` string
        - `assetCode` string
        - `issueDate` string
        - `relatedIssuer` boolean
        - `purchasedQuantity` number
        - `soldQuantity` number
        - `purchaseValue` number
        - `saleValue` number
        - `confidentialUntil` string
        - `fundClassType` string
        - `subclassId` string
        - `issuerType` string
    - `receivables` FundHolding[], required
      - `bucket` string, required
      - `assetType` string, nullable, required
      - `assetName` string, nullable, required
      - `issuerName` string, nullable, required
      - `issuerCnpj` string, nullable, required
      - `isin` string, nullable, required
      - `selicCode` string, nullable, required
      - `quantity` number, nullable, required
      - `marketValue` number, nullable, required
      - `costValue` number, nullable, required
      - `maturityDate` string, nullable, required
      - `confidential` boolean, required
      - `details` FundHoldingDetails, nullable, required
        - `applicationType` string
        - `negotiationType` string
        - `assetCode` string
        - `issueDate` string
        - `relatedIssuer` boolean
        - `purchasedQuantity` number
        - `soldQuantity` number
        - `purchaseValue` number
        - `saleValue` number
        - `confidentialUntil` string
        - `fundClassType` string
        - `subclassId` string
        - `issuerType` string
    - `payables` FundHolding[], required
      - `bucket` string, required
      - `assetType` string, nullable, required
      - `assetName` string, nullable, required
      - `issuerName` string, nullable, required
      - `issuerCnpj` string, nullable, required
      - `isin` string, nullable, required
      - `selicCode` string, nullable, required
      - `quantity` number, nullable, required
      - `marketValue` number, nullable, required
      - `costValue` number, nullable, required
      - `maturityDate` string, nullable, required
      - `confidential` boolean, required
      - `details` FundHoldingDetails, nullable, required
        - `applicationType` string
        - `negotiationType` string
        - `assetCode` string
        - `issueDate` string
        - `relatedIssuer` boolean
        - `purchasedQuantity` number
        - `soldQuantity` number
        - `purchaseValue` number
        - `saleValue` number
        - `confidentialUntil` string
        - `fundClassType` string
        - `subclassId` string
        - `issuerType` string
    - `confidentialSummary` object, nullable, required
  - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601.
  - `took` integer, required: Tempo de processamento, em milissegundos.

## Other responses

- `400`: Requisição inválida. Confira os parâmetros.
- `401`: Token ausente ou inválido.
- `403`: O plano não inclui este recurso ou parâmetro.
- `500`: Erro interno do servidor.

## Changes

- **2026-08-21** `d51b6ee0304a`: 1 info
  - api operation id `getFundPortfolio` was added
- **2026-06-22** `c05504ccc8be`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/funds/portfolio/get.md)

---

[API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)
