---
title: "Histórico da Carteira"
method: GET
path: "/api/v2/fii/portfolio/history"
tags: ["Fundos Imobiliários"]
---

# Histórico da Carteira

`GET /api/v2/fii/portfolio/history`

Retorna a série trimestral compacta da composição da carteira dos FIIs. Use este endpoint para acompanhar evolução de alocação, valor declarado, quantidade de ativos, imóveis e exposição por classe ao longo do tempo.

### Funcionalidades:
*   **Série trimestral:** Um ponto por FII, trimestre e versão do informe.
*   **Resumo de carteira:** Retorna `summary` e `allocations`, sem listas detalhadas de ativos.
*   **Múltiplos FIIs:** Consulte até 20 FIIs em uma única requisição.
*   **Filtro por período:** Use `startDate=YYYY-MM-DD` e `endDate=YYYY-MM-DD`. O padrão são os últimos 12 meses.
*   **Versionamento:** Por padrão retorna a versão mais recente de cada trimestre. Use `allVersions=true` para incluir retificações.

### Exemplos de Requisição:
```bash
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio/history?symbols=HGLG11"
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/fii/portfolio/history?symbols=HGLG11,MXRF11&startDate=2024-01-01&endDate=2026-03-31"
```

### Fonte dos Dados:
CVM (Informe Trimestral FII)

**Plano Mínimo:** Pro
**Autenticação:** Necessária (exceto MXRF11 e HGLG11)

## Query parameters

- `symbols` string, required — Símbolos separados por vírgula (máximo 20). Exemplo: HGLG11,MXRF11
- `startDate` string — Data de início no formato YYYY-MM-DD
- `endDate` string — Data de fim no formato YYYY-MM-DD
- `sortBy` string — Campo para ordenação
- `sortOrder` 'asc' | 'desc' — Direção da ordenação
- `allVersions` 'true' | 'false' — Incluir todas as versões de cada trimestre (padrão: false, retorna apenas a mais recente)

## Response `200`

Histórico trimestral da carteira retornado com sucesso.

- FiiPortfolioHistoryResponse
  - `history` FiiPortfolioHistoryEntry[], required
    - `symbol` string, nullable, required
    - `cnpj` string, required
    - `referenceDate` string, required
    - `version` number, required
    - `summary` FiiPortfolioSummary, required
      - `totalItems` number, required
      - `declaredValue` number, nullable, required
      - `properties` FiiPropertySummary, required
        - `count` number, required
        - `totalArea` number, nullable, required
        - `vacancyRate` number, nullable, required
        - `averageVacancyRate` number, nullable, required
        - `propertiesWithVacancy` number, required
      - `financialAssets` object, required
        - `count` number, required
        - `declaredValue` number, nullable, required
      - `lands` object, required
        - `count` number, required
        - `totalArea` number, nullable, required
      - `rights` object, required
        - `count` number, required
        - `declaredValue` number, nullable, required
    - `allocations` FiiPortfolioAllocation[], required
      - `assetClass` string, required
      - `count` number, required
      - `value` number, 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
- `404` — Não encontrado
- `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/revisions/f275d46193ea/schema)