Indicadores de preço de fundos listados
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â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.: PRICE_TO_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, que é a data do informe usado no cálculo (considera o dia inteiro). | Opcional |
publish_date | Query | ISO 8601. Filtra os pontos com publish_date maior que este valor. A publish_date é o pregão do preço. | 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 |
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 |
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). |
- 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
idsefrequencypara buscar apenas o que a tela precisa (ex.:PRICE_TO_NAVdiário). - Para históricos longos, pagine com
limiteoffsetem 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.
| Campo | Significado |
|---|---|
publish_date | Fechamento 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_date | Data 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ó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
iddo 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
| Campo | Tipo | Descrição |
|---|---|---|
value | number | Valor do indicador para o ponto retornado. |
reference_date | string (ISO 8601) | Data de referência do informe usado no cálculo. |
publish_date | string (ISO 8601) | Fechamento do pregão do preço usado no cálculo (22:00 UTC). |
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
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"
}
]
}
]
}
}