Método	URL
	`https://BASE_URL/public/api/v1/patrimonio-liquido`

Consulta o patrimônio líquido (PL) dos fundos numa data de referência.

O PL é informado manualmente, um dia útil por vez. Quando o dia pedido ainda não tem PL informado, o endpoint não devolve vazio: ele recua para o último dia anterior que tenha e devolve aquele valor, dizendo em dataReferencia a que data ele realmente pertence.

O recuo só olha para trás. Um PL cadastrado em data posterior à pedida nunca é devolvido — devolvê-lo inventaria histórico que não existia na data consultada.

Os resultados respeitam o RLS e ficam restritos ao grupo econômico do token informado no header GrupoEconomico.

Query Params¶

Todos os parâmetros são opcionais.

Parâmetro	Tipo	Descrição
`dataReferencia`	Texto (date)	Data-base da consulta. Formato `YYYY-MM-DD`. Quando omitida, assume a data atual.
`idCessionario`	Número (long)	Filtra por um financiador (fundo). Quando omitido, devolve todos os fundos ativos do grupo econômico que tenham PL até a data.

Query parameters são case-insensitive (dataReferencia ou DataReferencia funcionam).

Request¶

Exemplo de querystring

GET https://BASE_URL/public/api/v1/patrimonio-liquido?dataReferencia=2026-03-20&idCessionario=12

Response¶

A resposta é sempre uma lista, mesmo quando idCessionario é informado (com um único item).

Response Body — 200 OK

[
  {
    "idCessionario": 12,
    "nome": "FIDC Exemplo",
    "cnpj": "12345678000190",
    "dataReferenciaSolicitada": "2026-03-20",
    "dataReferencia": "2026-03-18",
    "patrimonioLiquido": 12450000.00,
    "dataCadastro": "2026-03-18T21:42:11.482Z",
    "dataAtualizacao": null
  }
]

No exemplo acima, não havia PL cadastrado em 20/03: o valor devolvido é o de 18/03, o último dia com informação até a data pedida.

Modelo de dados¶

Campo	Tipo	Descrição
`idCessionario`	Número (long)	Identificador do financiador (fundo).
`nome`	Texto	Nome do fundo.
`cnpj`	Texto	CNPJ do fundo, somente dígitos.
`dataReferenciaSolicitada`	Texto (date)	A data que você pediu, repetida na resposta.
`dataReferencia`	Texto (date)	A data a que o `patrimonioLiquido` devolvido realmente se refere.
`patrimonioLiquido`	Número (decimal)	Valor do patrimônio líquido do fundo na `dataReferencia`.
`dataCadastro`	Texto (date-time)	Quando o PL daquela data foi cadastrado.
`dataAtualizacao`	Texto (date-time)	Quando o valor foi corrigido pela última vez. `null` quando nunca foi alterado depois de cadastrado.

Como interpretar as duas datas¶

dataReferenciaSolicitada e dataReferencia existem separadas de propósito — é a diferença entre elas que diz quão defasado está o número que você recebeu.

Situação	Resultado
`dataReferencia` igual a `dataReferenciaSolicitada`	Há PL informado no próprio dia pedido.
`dataReferencia` anterior a `dataReferenciaSolicitada`	O dia pedido não tem PL; o valor é o do último dia com informação. Quanto maior a distância, mais antigo o dado.

Sem comparar as duas, um PL de três semanas atrás chega indistinguível do PL de hoje.

Códigos de retorno¶

Código	Modelo	Descrição
`200 OK`	Lista de `PatrimonioLiquidoDto`	Consulta realizada. Sem `idCessionario`, a lista pode vir vazia quando nenhum fundo ativo tem PL até a data.
`400 Bad Request`	`RetornoPadrao`	Erro ao consultar o patrimônio líquido.
`404 Not Found`	`RetornoPadrao`	Só ocorre com `idCessionario` informado: o fundo não existe, está inativo, ou não tem PL algum até a data pedida.

Com idCessionario informado, a ausência de PL é 404, não uma lista vazia com 200. Quem pede um fundo específico espera um número, e um [] com 200 convida a tratar a ausência como zero.

Response Body — 404 Not Found

{
  "status": "erro",
  "mensagem": "Não há patrimônio líquido informado para o financiador 12 até 20/03/2026."
}