Recuperando Cotas Públicas

---

Request

ENDPOINT

/public_dash/quota_values

METHOD

GET

STATUS

200

Query Params

Parâmetro	Tipo	Descrição
reference_date	string	Data da cota a ser consultada (YYYY-MM-DD)
start_date	string	Data de início do período a ser consultado (YYYY-MM-DD)
end_date	string	Data do fim do período a ser consultado (YYYY-MM-DD)
issuance_serie_key	string	Chave da série de emissão a ser consultada
internal_code	string	Código único da série de emissão a ser consultada
fund_class_document_number	string	CNPJ (com pontuação) do fundo a ser consultado
limit	int	Limite de objetos recuperados por página
page	int	Número da página recuperada

Informação

O uso do parâmetro reference_date implica na consulta de uma única data específica. Por outro lado, o uso dos parâmetros start_date e end_date implicam na consulta de um intervalo. O uso dos três parâmetros em uma mesma requisição retornará um erro.

Atenção

O valor de cota se encontra a nível de série de emissão (issuance_serie) e portanto o uso do parâmetro fund_class_document_number implica no retorno de todas as séries. Recomenda-se o uso desse filtro apenas para o mapeamento de identificadores únicos das séries de emissão (internal_code e issuance_serie_key).

Response

Response Body

{
   "data": [
      {
         "fund_class_name": "FUNDO DE INVESTIMENTO DE TESTES",
         "sub_class_name": "SÊNIOR",
         "serie_name": "PRIMEIRA",
         "issuance_serie_key": "1de4125b-48c7-40ca-b97b-0b65fb356468",
         "internal_code": "INTERNAL-CODE-2",
         "closed_quota_value": 1000,
         "before_amortization_quota_value": 1000,
         "opening_quota_value": 1000,
         "reference_date": "2024-10-21",
      },
      {
         "fund_class_name": "FUNDO DE INVESTIMENTO DE TESTES",
         "sub_class_name": "SUBORDINADA JÚNIOR",
         "serie_name": "PRIMEIRA",
         "issuance_serie_key": "71f7ee44-388d-4916-b068-647e82fd67c8",
         "internal_code": "INTERNAL-CODE-1",
         "closed_quota_value": 1000,
         "before_amortization_quota_value": 1000,
         "reference_date": "2024-10-21",
      }
   ],
   "page": 0,
   "is_last_page": true
}

Informação

O retorno do campo opening_quota_value não é garantido para todas as séries de emissão, uma vez que esse valor só pode ser obtido em séries subordinadas mezanino e sêniors. Do mesmo modo, não é garantido o retorno dos campos before_amortization_quota_value ou closed_quota_value, uma vez que esses valores são obtidos apenas após o fechamento do dia em questão, o que não necessariamente já ocorreu para séries que possuam cota de abertura.

Response Fields

Campo	Tipo	Descrição
fund_class_name	string	Nome do fundo de investimento consultado
sub_class_name	string	Nome da subclasse do fundo de investimento consultado
serie_name	string	Nome da série de emissão da subclasse consultada
issuance_serie_key	string	Chave que identifica a série de emissão
internal_code	string	Código que identifica a série de emissão
closed_quota_value	float	O valor da cota da série de emissão após o fechamento
before_amortization_quota_value	float	O valor da cota da série de emissão antes de uma amortização
opening_quota_value	float	O valor da cota de abertura da série de emissão
reference_date	string	Data do valor de cota da série de emissão (YYYY-MM-DD)