Indicadores de acompanhamento

GET /v1/indicators · header iorq-fund-id · somente leitura

1. O que é um indicador de acompanhamento

Um indicador de acompanhamento é um número da carteira ou do patrimônio do fundo que não tem limite no regulamento: serve para acompanhar a evolução do fundo, não para testar enquadramento. Por isso a resposta não traz limit nem limit_type. Os indicadores com régua no regulamento estão em Covenants.

Como nos covenants, todos os valores são apurados sobre o arquivo mais recente publicado pela administradora (base adm): no melhor caso D-1, e mais antigo se a administradora atrasar. Ver base de apuração.

2. Catálogo

`code`	Nome	Unidade	O que mede
`pl_total`	PL Total	`R$`	Patrimônio líquido do fundo na última posição
`pl_senior`	Participação Sênior no PL	`%`	PL das cotas seniores sobre o PL total
`pl_mezanino`	Participação Mezanino no PL	`%`	PL das cotas mezanino sobre o PL total. Só existe em fundo com classe mezanino
`pl_subordinada`	Participação Subordinada no PL	`%`	PL das cotas subordinadas sobre o PL total
`pl_medio_12m`	PL Médio 12 meses	`R$`	Média dos fechamentos mensais do PL nos últimos 12 meses
`pdd_sobre_pl`	PDD sobre PL	`%`	Provisão para devedores duvidosos sobre o PL
`duration_carteira`	Duration da Carteira	`dias`	Prazo remanescente de cada parcela até o vencimento, ponderado pelo valor presente; parcela vencida entra com prazo zero

O valor em R$ de cada classe não sai separado: multiplique a participação pelo pl_total do mesmo dia.

3. A resposta

curl 'https://investor-api.iorq.com.br/v1/indicators' \
  -H 'Authorization: Bearer eyJraWQiOiJyc2EtMjAyNiIs...' \
  -H 'iorq-fund-id: 6f1c2d3e-4b5a-4c7d-8e9f-0a1b2c3d4e5f'

{
  "fund_id": "6f1c2d3e-4b5a-4c7d-8e9f-0a1b2c3d4e5f",
  "as_of": "2026-10-01",
  "indicators": [
    {
      "code": "pl_total",
      "name": "PL Total",
      "base": "adm",
      "status": "available",
      "date": "2026-10-04",
      "value": 120000000.0,
      "unit": "R$",
      "as_of": "2026-10-01",
      "calculated_at": "2026-10-05T02:50:51Z"
    },
    {
      "code": "pl_mezanino",
      "name": "Participação Mezanino no PL",
      "base": "adm",
      "status": "unavailable",
      "unit": "%"
    }
  ]
}

Campo	Tipo	Descrição
`fund_id`	UUID	O fundo do header `iorq-fund-id`
`as_of`	data	O `as_of` mais antigo entre os indicadores disponíveis. Ausente quando nenhum está disponível
`indicators[].code`	string	Código estável do indicador
`indicators[].name`	string	Nome público, em português
`indicators[].base`	string	Sempre `adm`
`indicators[].status`	string	`available` ou `unavailable`
`indicators[].date`	data	Dia da série a que o ponto pertence
`indicators[].value`	número	Valor apurado, na unidade de `unit`; `%` são pontos percentuais
`indicators[].unit`	string	`%`, `R$` ou `dias`
`indicators[].as_of`	data	Data do dado: a do numerador, senão a do denominador, senão `date`. É a data do arquivo mais recente da administradora quando o ponto foi apurado: no melhor caso o dia útil anterior a `date`, e mais antiga se a administradora atrasar. Sábado e domingo repetem o `as_of` de sexta
`indicators[].calculated_at`	data e hora	Quando a IORQ apurou o ponto

Campo sem valor não sai. A resposta nunca traz null: um campo que não se aplica fica de fora do objeto.

Indicador indisponível. Um indicador sem nenhum ponto na série, ou com ponto fora do contrato, sai só com code, name, base, unit e status: "unavailable". Os demais indicadores continuam saindo normalmente, com 200. Isso é diferente de /v1/covenants, que responde 503 se faltar qualquer covenant.

Último ponto, qualquer que seja a idade. Como nos covenants, a API sempre devolve o último ponto de cada indicador. Confira as_of antes de usar o número.

Erros. 503 só quando a série não responde ou o fundo não está configurado para o painel (FUND_NOT_IN_PANEL, FUND_SERIES_KEY_MISSING), ou quando um ponto lido não pertence ao fundo do header (COVENANT_SERIES_FUND_MISMATCH). Ver os erros.