Consulta paginada de Fechamento das Aplicações Financeiras

Lista os fechamentos diários (posição contábil) das aplicações financeiras, por classe de fundo ou por aplicação.

Por classe de fundo

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Leitura

URL base de cada host: Ambientes (Hosts).

ENDPOINT

/quota/fund_class/FUND_CLASS_KEY/financial_application_closings

MÉTODO

GET

STATUS

200

Query Params

Parâmetro	Descrição
accounting_date	Data contábil específica de fechamento (yyyy-mm-dd)
from_date	Data de início do período (yyyy-mm-dd)
to_date	Data de fim do período (yyyy-mm-dd)
investor_document_number	CPF/CNPJ do investidor
limit	Itens por página (default 75, máximo 75)
page	Página, a partir de 0 (default 0)

Atenção

Envie accounting_date ou o par from_date e to_date — nunca os dois. Sem nenhum deles, a API devolve QTA000026; com os dois, QIT000001. Parâmetros fora desta lista também são recusados com QIT000001.

Os resultados vêm ordenados da data contábil mais recente para a mais antiga.

Por investidor e aplicação financeira

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Leitura

URL base de cada host: Ambientes (Hosts).

ENDPOINT

/quota/investor/INVESTOR_KEY/financial_application/FINANCIAL_APPLICATION_KEY/financial_application_closings

MÉTODO

GET

STATUS

200

Query Params

Parâmetro	Descrição
last_financial_application_closing	Booleano. Quando true, retorna apenas o último fechamento da aplicação (default false)
limit	Itens por página (default 50, máximo 500)
page	Página, a partir de 0 (default 0)

Response

Caso 01: Consulta bem-sucedida

{
    "data": [
        {
            "financial_application": {
                "financial_application_key": "UUID",
                "share_capital": 1000.0,
                "status": "quoted",
                "financial_application_type": "primary_market",
                "payment_method": "regular",
                "quotation_date": "2025-01-10",
                "investor": {
                    "investor_key": "UUID",
                    "name": "INVESTIDOR EXEMPLO",
                    "person_type": "natural_person"
                },
                "issuance_serie": {
                    "issuance_serie_key": "UUID"
                }
            },
            "total_value": 1012.35,
            "number_of_quotas": 998.12345678,
            "principal_value": 1000.0,
            "acquisition_cost": 1000.0,
            "yield_value": 12.35,
            "ir_value": 2.78,
            "iof_value": 0.0,
            "taxable_yield_value": 12.35,
            "accounting_date": "2025-01-31"
        }
    ],
    "limit": 75,
    "page": 0,
    "is_last_page": true
}

Campo	Tipo	Descrição
data	array	Lista de objetos Financial Application Closing
limit	int	Itens por página
page	int	Página retornada
is_last_page	boolean	true quando não há mais páginas

Financial Application Closing

Campo	Tipo	Descrição
financial_application	object	Aplicação financeira completa, no formato de Consultar Aplicação Financeira por chave
total_value	float	Valor total da aplicação no fechamento
number_of_quotas	float	Número de cotas no fechamento
principal_value	float	Valor principal no fechamento
acquisition_cost	float	Custo de aquisição das cotas no fechamento
yield_value	float	Rendimento bruto
ir_value	float	IR
iof_value	float	IOF
taxable_yield_value	float	Rendimento tributável
accounting_date	string	Data contábil do fechamento

Erros

Status	Código	Quando acontece
400	QTA000026	Consulta por classe sem accounting_date nem o par from_date/to_date
400	QIT000001	Parâmetro inválido ou desconhecido, limit acima de 75, ou accounting_date junto com from_date/to_date
400	QIT000004	O fundo não é da gestora
404	QTA000020	Investidor não encontrado (a API responde com o erro de distribuidor não encontrado)
404	QTA000023	Aplicação financeira não encontrada para o investidor

Erros de autenticação, permissão e host: veja Erros da API.