Ordena e FILTRA uma coorte por medidas — nível ou variação

O tipo dos objetos que entram na coorte.

Recorte dentro do tipo.

A medida, pelo nome do listFactCatalog.

value ordena por nível; delta pela variação absoluta; pct_change pela relativa.

Data-base da leitura em value; ponta FINAL nas demais. Ausente = o mais recente publicado.

at + since é a JANELA. at é o teto e since é o piso da data-base aceita, e os dois juntos recortam um período: at=2024-12-31&since=2024-01-01 devolve o que tem competência EM 2024 — 4.178 ofertas, medido. Sem since, um objeto que parou de reportar em 2020 entra com a competência dele e disputa o topo; sem at, entra o que veio depois. meta.as_of_range devolve a faixa efetiva da página, e ela é a conferência: min e max distantes dizem que a lista mistura competências.

Ponta INICIAL. Obrigatória em delta e pct_change.

Piso da data-base aceita na ponta INICIAL — o que since faz pela ponta final.

Sem ele a janela que você pediu não é a janela que você recebe. Objeto cuja última publicação antes de from é de anos atrás entra com aquele valor: medido em 20/08/2026, um FIDC subiu a 7º numa lista de 'maior piora no ÚLTIMO ANO' com ponta inicial em 2022-10-31 — e nos doze meses pedidos ele tinha MELHORADO 19 pp. Sinal trocado, sem erro nenhum. meta.as_of_from_range é o alarme: min distante de max diz que a lista mistura janelas.

asc primeiro os menores — é assim que se pede 'a maior QUEDA' com delta.

Traz, em CADA linha, os objetos ligados por este verbo — com id, nome e a CHAVE pela qual um humano os chama. kind=offering&expand=issued responde 'as maiores ofertas E quem emitiu cada uma' numa chamada; sem ele são N chamadas de listObjectLinks, medido em 5 de 12 numa sondagem de 20/08/2026. No máximo 3 vizinhos por linha: para a lista inteira de UM objeto, listObjectLinks pagina e declara o total.

De que lado da aresta está o vizinho. in (default) é quem APONTA para a linha, e é o caso da oferta: a aresta é company --issued--> offering, então o emissor entra por aí.

Restringe a coorte a quem tem esta relação com rel_to. Sem ela, a coorte é o tipo inteiro.

O outro lado da relação — o índice, o fundo, a empresa.

Onde a COORTE está na aresta — não onde rel_to está. in (default) é o caso comum: rel_to aponta para os membros (o índice CONTÉM os papéis). out = os membros apontam para rel_to (os cedentes ATRIBUÍDOS a um fundo).

Data-base MÍNIMA aceita na ponta final. Objeto que PAROU de reportar carrega o último valor para sempre: sem since, um FIDC cujo último informe é de 2023 disputa o topo com quem reportou este mês, e a resposta compara competências a três anos de distância. Cada linha declara seu as_of justamente para isso ser visível — since é como se pede que não aconteça.

Tira da ordenação os valores fora da faixa plausível DA MEDIDA ORDENADA. Ordenar por variação traz o denominador colapsado para o TOPO — margem de empresa com receita residual, concentração de fundo com patrimônio perto de zero. meta.excluded_out_of_prior diz quantos saíram, porque 'nenhum implausível em 12' e 'nenhum em 3.000' não são a mesma afirmação — e vem null quando não houve medição (filtro não pedido, ou medida sem faixa declarada). Zero significa 'apliquei e não derrubei ninguém'.

O QUE ELE NÃO ENXERGA: o denominador. A faixa é da medida ORDENADA, e uma razão limitada a 0–1 é sempre plausível — mesmo num fundo cuja carteira é R$ 66,77. Medido em 20/08/2026: ranqueando piora de inadimplência, fundos com carteira de sessenta e seis reais e de ZERO entraram no top-16 com out_of_prior: false, porque 0,89 é um valor perfeitamente normal. O implausível estava no denominador, que este parâmetro não olha. Para isso use where sobre a medida de tamanho — where=fidc_portfolio>50000000 — que é o corte que a pergunta realmente pedia. meta.filterable_facts lista o que cabe ali.

CONDIÇÕES SOBRE OUTRAS MEDIDAS, na mesma coorte e na mesma janela do ranking. Formato <medida><operador><número>, várias separadas por vírgula — fidc_impaired_ratio<0.05,fidc_portfolio>1000000. Operadores: <, <=, >, >=.

NÍVEL ou VARIAÇÃO. x<5 compara o valor na data-base; delta(x)>0.02 compara a VARIAÇÃO entre from e at, e pct_change(x)>10 a variação relativa em %. Metade da triagem é sobre mudança e não sobre nível — inadimplência de 5% é normal em quem sempre esteve em 5% e é alarme em quem estava em 3%. Condição de variação exige from, e usa a MESMA janela do ranking.

Confira a ESCALA da medida antes de escrever o número. fidc_impaired_ratio é fração (0,05 é 5%) e fii_dy_12m é percentual (5 é 5%): o mesmo <5 corta em 500% numa e em 5% na outra, e as duas respondem 200 com uma lista plausível. meta.applied_where devolve a unidade contra a qual cada número foi comparado.

Objeto SEM valor na medida do filtro não passa — ausência não é zero, e não dá para afirmar que quem não publicou inadimplência está abaixo do corte. meta.filtered_out diz quantos o corte derrubou.

CORTE POR PALAVRA, no mesmo parâmetro: <propriedade>=<valor> e !=. As propriedades e os valores possíveis de cada tipo vêm em meta.filterable_properties desta mesma resposta, e são os mesmos de getObjectProperties — situation=Em Liquidação, area_type=country, is_critical=true.

| é OU dentro do mesmo campo: sector=Bancos|Seguros. Duas condições separadas por vírgula são E, então sem o pipe "as financeiras" não teria como ser pedido.

ASPAS quando o valor tem vírgula — sector="Construção Civil, Mat. Constr. e Decoração". São 471 companhias assim; sem aspas a vírgula parte a condição e a requisição é RECUSADA, nunca cortada pela metade.

Caixa e acento são ignorados no casamento, e meta.applied_property_where devolve o valor CANÔNICO que casou — é onde este corte engana. Em !=, objeto que não declara a propriedade PASSA: "não está em liquidação" inclui quem não declarou situação nenhuma.