---
title: "Carteira oficial CVM CDA para fundos FI/FIF"
method: GET
path: "/api/v2/funds/portfolio"
tags: ["Fundos"]
---

# Carteira oficial CVM CDA para fundos FI/FIF

`GET /api/v2/funds/portfolio`

Retorna carteira oficial CVM CDA agrupada por títulos públicos, cotas de fundos, crédito privado, recebíveis e valores a pagar.

## Query parameters

- `symbols` string — Símbolos B3 separados por vírgula (máximo 20)
- `cnpjs` string — CNPJs separados por vírgula, com ou sem formatação
- `page` integer — Página (começa em 1)
- `limit` integer — Itens por página (padrão 20). Sem limite rígido; valores altos são aceitos.
- `referenceDate` string
- `include` string

## 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 formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Requisição inválida
- `401` — Não autorizado
- `403` — Acesso negado
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/versions/f275d46193ea/schema)