Skip to main content
GET
Métricas custom por CUIT

Overview

Retorna métricas densificadas de um lookback calendário: deltas, % de mudança, aceleração (quando há histórico suficiente) e completeness. Uma request cobrável por chamada bem-sucedida quando precificado. Informe lookback (inteiro 1–180) ou um preset window (w_1dw_180d). Se ambos forem enviados, lookback prevalece.

Janela

Exemplo: lookback=4&date=2026-07-142026-07-11 … 2026-07-14. O date está incluído. Dias quietos podem não persistir upstream; em HTTP 200 a série já vem densa (forward-fill: totais anteriores + delta diário 0). Série plana com delta 0 = sem movimento, não “sem dado”. Avalie limiares só se complete === true.

Query

Pelo menos um de lookback ou window é obrigatório.
integer
Dias calendário (1–180). Opcional se houver window.
string
Preset de lookback → dias:
string
Opcional. Fim inclusive (YYYY-MM-DD).

Sucesso (HTTP 200)

Aliases de estoque:
  • cbuCount, cvuCount, totalAccountsúltimo dia densificado (windowEnd / referenceDate)
  • cbuCountAtStart, cvuCountAtStartprimeiro dia densificado (windowStart)
data.metrics: deltas por canal e totais (totalDelta = CBU+CVU, totalPctChange sobre estoque total no início — null se start total = 0), aceleração só se accelerationAvailable. Também totalAccountsStart / totalAccountsEnd. daily[] (quando presente) tem exatamente lookbackDays linhas densas. Como ler: não trate null em % nem HTTP 422 como “mudança 0”. Faça gate com data.complete === true.

Janela incompleta (HTTP 422)

Não foi possível densificar pelo menos um dia (falta piso, dia não complete no corpus, ou sem estado incremental). Não aplicar limiares — é “dado não pronto”, não score 0.

Outros erros

Exemplo

Regras

Use holderIntelligenceLookbackDays na condição. Não é necessário adicionar metrics.complete == true: uma janela incompleta expõe as métricas como null, e o motor as avalia como non-match. Para aceleração, adicione metrics.acceleration_available == true. Em regras transacionais, data padrão: transactedAt (calendário AR). Campos de totais: services.holder_intelligence.metrics.total_delta, total_pct_change, total_acceleration. Ver Condições de regras.