Indicadores de preço de fundos listados

GET

/traded-funds/[fundIdentifier]/ratios/valuation

Retorna os indicadores de valuation de um fundo listado (FII, ETF, Fiagro, FI-Infra etc.), como a relação entre o preço de mercado e o valor patrimonial da cota (ex.: P_NAV), agrupados por indicador e frequência. Suporta filtros por indicador, frequência e datas (referência, publicação e coleta).

Quando usar

• Exibir múltiplos de valuation (ex.: P/VP) na tela de detalhe do fundo
• Comparar preço de mercado e valor patrimonial em dashboards e screeners
• Montar séries históricas de valuation com fonte rastreável via sources
• Criar automações e alertas (ex.: fundo negociando com desconto sobre o patrimônio)

Parâmetros de requisição

Os parâmetros de consulta são os mesmos do endpoint de Indicadores fundamentalistas.

Parâmetro	Local	Descrição	Obrigatório
[fundIdentifier]	URL	Identificador do fundo: ticker (ex.: HGLG11), symbol (ex.: HGLG) ou company_id numérico.	Obrigatório
ids	Query	Lista de IDs de indicadores separada por vírgula (ex.: P_NAV). Não diferencia maiúsculas de minúsculas.	Opcional
id	Query	Filtro por um único ID de indicador (equivalente a ids com um único valor).	Opcional
reference_date	Query	ISO 8601. Filtra pela data de referência (considera o dia inteiro).	Opcional
publish_date	Query	ISO 8601. Filtra documentos publicados após esta data.	Opcional
retrieval_date	Query	ISO 8601. Filtra documentos coletados após esta data.	Opcional
frequency	Query	Frequência dos dados; veja os valores aceitos abaixo.	Opcional
latest_by_reference_date	Query	Se true, retorna apenas o ponto publicado mais recentemente por data de referência, por indicador.	Opcional
limit	Query	Número de documentos retornados. Mín: 1, máx: 500. Padrão: 500.	Opcional
offset	Query	Número de documentos a pular (paginação). Mín: 0. Padrão: 0.	Opcional

Sobre o parâmetro ids (recomendado)

Se ids não for informado, o endpoint pode retornar todos os indicadores de valuation disponíveis para o fundo na(s) frequência(s) solicitada(s). Isso pode gerar um payload muito grande. Para uso em produção, prefira informar ids com os indicadores necessários.

Valores de frequency

frequency	Significado
DAILY	Dados em frequência diária.
MONTHLY	Dados em frequência mensal.
QUARTERLY	Dados em frequência trimestral.
ANNUAL	Dados em frequência anual.
TRIAL_BALANCE	Dados originados de balancetes.
CDA	Dados originados de documentos CDA (composição e diversificação das aplicações).

Boas práticas

• Para séries temporais "limpas" (um ponto por período), use latest_by_reference_date=true.
• Combine ids e frequency para buscar apenas o que a tela precisa (ex.: P_NAV mensal).
• Para históricos longos, pagine com limit e offset em vez de aumentar o payload de uma única requisição.

Resposta

Código	Descrição
200	Retorna os indicadores de valuation do fundo.
400	Parâmetros ausentes ou inválidos.
401	Não autorizado.
404	Fundo não encontrado ou nenhum indicador de valuation encontrado.

Formato da resposta

A resposta é um objeto onde:

• cada chave de primeiro nível é o id do indicador (ex.: P_NAV)
• cada chave interna é a frequência (ex.: MONTHLY)
• o valor de cada frequência é uma lista de pontos com os campos abaixo

Campo	Tipo	Descrição
value	number	Valor do indicador para o ponto retornado.
reference_date	string (ISO 8601)	Data de referência do dado.
publish_date	string (ISO 8601)	Data de publicação do documento fonte.
retrieval_date	string (ISO 8601)	Data/hora em que a Partnr coletou o dado.
sources	array	Documentos fonte que originaram o ponto.

Estrutura de sources[]

Campo	Tipo	Descrição
visualization_url	string	URL para visualização do documento original na FNET.
download_url	string | null	URL para download do documento original (quando disponível).
published_at	string (ISO 8601)	Data de publicação do documento na fonte.
retrieved_at	string (ISO 8601)	Data/hora em que a Partnr coletou o documento.
name	string	Descrição resumida do documento fonte (ex.: Monthly Report).

Exemplo

{
  "P_NAV": {
    "MONTHLY": [
      {
        "value": 0.85,
        "reference_date": "2024-06-30T00:00:00.000Z",
        "publish_date": "2024-07-15T00:00:00.000Z",
        "retrieval_date": "2024-07-16T10:00:00.000Z",
        "sources": [
          {
            "visualization_url": "https://fnet.bmfbovespa.com.br/fnet/publico/exibirDocumento?id=792417&cvm=true",
            "download_url": null,
            "published_at": "2024-07-15T00:00:00.000Z",
            "retrieved_at": "2024-07-16T10:00:00.000Z",
            "name": "Monthly Report"
          }
        ]
      },
      {
        "value": 0.87,
        "reference_date": "2024-05-31T00:00:00.000Z",
        "publish_date": "2024-06-14T00:00:00.000Z",
        "retrieval_date": "2024-06-15T10:00:00.000Z",
        "sources": [
          {
            "visualization_url": "https://fnet.bmfbovespa.com.br/fnet/publico/exibirDocumento?id=781032&cvm=true",
            "download_url": null,
            "published_at": "2024-06-14T00:00:00.000Z",
            "retrieved_at": "2024-06-15T10:00:00.000Z",
            "name": "Monthly Report"
          }
        ]
      }
    ]
  }
}