Pular para o conteúdo principal
Cole no ChatGPT/Claude e peça para resumir/gerar SDK.

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.: PRICE_TO_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, menos latest_by_reference_date, que não se aplica aos indicadores de preço.

ParâmetroLocalDescriçãoObrigatório
[fundIdentifier]URLIdentificador do fundo: ticker (ex.: HGLG11), symbol (ex.: HGLG) ou company_id numérico.Obrigatório
idsQueryLista de IDs de indicadores separada por vírgula (ex.: PRICE_TO_NAV). Não diferencia maiúsculas de minúsculas.Opcional
idQueryFiltro por um único ID de indicador (equivalente a ids com um único valor).Opcional
reference_dateQueryISO 8601. Filtra pela data de referência, que é a data do informe usado no cálculo (considera o dia inteiro).Opcional
publish_dateQueryISO 8601. Filtra os pontos com publish_date maior que este valor. A publish_date é o pregão do preço.Opcional
retrieval_dateQueryISO 8601. Filtra documentos coletados após esta data.Opcional
frequencyQueryFrequência dos dados; veja os valores aceitos abaixo.Opcional
limitQueryNúmero de documentos retornados. Mín: 1, máx: 500. Padrão: 500.Opcional
offsetQueryNú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​

frequencySignificado
DAILYDados em frequência diária.
MONTHLYDados em frequência mensal.
QUARTERLYDados em frequência trimestral.
ANNUALDados em frequência anual.
TRIAL_BALANCEDados originados de balancetes.
CDADados originados de documentos CDA (composição e diversificação das aplicações).
Boas práticas
  • Para a série diária, use os pontos na ordem em que vêm: do pregão mais recente para o mais antigo, pela publish_date.
  • Combine ids e frequency para buscar apenas o que a tela precisa (ex.: PRICE_TO_NAV diário).
  • Para históricos longos, pagine com limit e offset em vez de aumentar o payload de uma única requisição.

Datas dos pontos​

As datas seguem a mesma regra dos indicadores de preço de empresas: a publish_date é o dia do preço, e a reference_date é a data do dado contábil.

CampoSignificado
publish_dateFechamento do pregão do preço usado no cálculo, às 22:00 UTC. O ponto de 2026-11-13T22:00:00.000Z usa o fechamento de 13/11/2026. Existe um ponto por pregão.
reference_dateData de referência do informe que deu o valor patrimonial: o último dia do mês do informe mensal (FII, Fiagro) ou o dia do informe diário (ETF). Todos os pregões que usam o mesmo informe têm a mesma reference_date.

Regras do cálculo de cada pregão:

  • Preço. É o fechamento do próprio pregão. Em um dia sem negócio da cota, o ponto existe e usa o último fechamento anterior.
  • Informe. É o último informe publicado até o fechamento do pregão.
  • Proventos. A soma de 12 meses termina no dia do pregão.
  • Fundo sem informe. A reference_date é o dia do pregão.

Resposta​

CódigoDescrição
200Retorna os indicadores de valuation do fundo.
400Parâmetros ausentes ou inválidos.
401Não autorizado.
404Fundo 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.: PRICE_TO_NAV)
  • cada chave interna é a frequência (ex.: DAILY)
  • o valor de cada frequência é uma lista de pontos com os campos abaixo
CampoTipoDescrição
valuenumberValor do indicador para o ponto retornado.
reference_datestring (ISO 8601)Data de referência do informe usado no cálculo.
publish_datestring (ISO 8601)Fechamento do pregão do preço usado no cálculo (22:00 UTC).
retrieval_datestring (ISO 8601)Data/hora em que a Partnr coletou o dado.
sourcesarrayDocumentos fonte que originaram o ponto.

Estrutura de sources[]​

CampoTipoDescrição
visualization_urlstringURL para visualização do documento original na FNET.
download_urlstring | nullURL para download do documento original (quando disponível).
published_atstring (ISO 8601)Data de publicação do documento na fonte.
retrieved_atstring (ISO 8601)Data/hora em que a Partnr coletou o documento.
namestringDescrição resumida do documento fonte (ex.: Monthly Report).

Exemplo​

GET /traded-funds/HGLG11/ratios/valuation?ids=PRICE_TO_NAV

{
"PRICE_TO_NAV": {
"DAILY": [
{
"value": 0.8848369912076335,
"reference_date": "2026-10-31T00:00:00.000Z",
"publish_date": "2026-11-13T22:00:00.000Z",
"retrieval_date": "2026-11-14T12:15:40.836Z",
"sources": [
{
"visualization_url": null,
"download_url": null,
"published_at": "2026-11-13T22:00:00.000Z",
"retrieved_at": "2026-11-14T12:15:40.836Z",
"name": "DAILY_VALUATION"
}
]
},
{
"value": 0.8804264375400658,
"reference_date": "2026-09-30T00:00:00.000Z",
"publish_date": "2026-11-12T22:00:00.000Z",
"retrieval_date": "2026-11-13T12:36:40.357Z",
"sources": [
{
"visualization_url": null,
"download_url": null,
"published_at": "2026-11-12T22:00:00.000Z",
"retrieved_at": "2026-11-13T12:36:40.357Z",
"name": "DAILY_VALUATION"
}
]
}
]
}
}