Recuperando Cotas Públicas

Retorna os valores de cota aprovados e públicos das séries de emissão, por data de referência. É uma consulta pública: não exige chave de API nem assinatura da requisição.

Disponível em

Perfil	Host	Permissão exigida
Público	api.qidtvm.com.br	Nenhuma (não exige chave de API)

O host público atende apenas produção. URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/public_dash/mark_to_market/fund_quota/mark_to_markets

MÉTODO

GET

STATUS

200

Query Params

Parâmetro	Tipo	Descrição
internal_codes	list	Lista de códigos internos da série de emissão (separados por vírgula ou com o parâmetro repetido)
from_reference_date	string	Data de início do período a ser consultado (YYYY-MM-DD)
to_reference_date	string	Data do fim do período a ser consultado (YYYY-MM-DD)
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	Itens por página: de 1 a 400 (default 10)
page	int	Página, a partir de 0 (default 0)

Só são retornados valores de cota com status aprovado e marcados como públicos.

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": [
      {
         "issuance_serie_key": "1de4125b-48c7-40ca-b97b-0b65fb356468",
         "internal_code": "INTERNAL-CODE-2",
         "fund_class_document_number": "11.222.333/0001-81",
         "fund_class_name": "FUNDO DE INVESTIMENTO DE TESTES",
         "marks_to_market": [
            {
               "reference_date": "2025-09-05",
               "before_amortization_unit_price": 1000,
               "unit_price": 1000
            }
         ]
      },
      {
         "issuance_serie_key": "71f7ee44-388d-4916-b068-647e82fd67c8",
         "internal_code": "INTERNAL-CODE-1",
         "fund_class_document_number": "11.222.333/0001-81",
         "fund_class_name": "FUNDO DE INVESTIMENTO DE TESTES",
         "marks_to_market": [
            {
               "reference_date": "2025-09-04",
               "before_amortization_unit_price": 1000,
               "unit_price": 1000
            }
         ]
      }
   ],
   "limit": 5,
   "page": 0,
   "is_last_page": true
}

Issuance Serie

Campo	Tipo	Descrição
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 internamente
fund_class_document_number	string	CNPJ do fundo de investimento consultado
fund_class_name	string	Nome do fundo de investimento consultado
marks_to_market	array	Lista de objetos de Marks To Market

Marks To Market

Campo	Tipo	Descrição
reference_date	string	Data do valor de cota da série de emissão (YYYY-MM-DD)
before_amortization_unit_price	float	O valor da cota da série de emissão antes de uma amortização
unit_price	float	O valor da cota da série de emissão após o fechamento

Erros

Status	Código	Quando acontece
400	—	limit fora do intervalo de 1 a 400, page negativo ou data em formato inválido

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