Indicadores fundamentalistas (snapshot TTM)
In: header
Path Parameters
^[A-Z][A-Z0-9]{3}[0-9]{0,2}$Query Parameters
Lista separada por vírgula de indicadores a retornar (omitir = todos). Ex.: 'pl,roe,dy'. Nomes válidos (abreviações SEM underscore — use 'pl', não 'p_l'): pl, pvp, psr, ev_ebitda, ev_ebit, lpa, vpa, roe, roa, roic, margem_bruta, margem_ebit, margem_liquida, div_liq_ebitda, div_liq_pl, dy, payout, market_cap, price; e dinâmicos: free_float, beta, volatilidade, retorno_12m, volume_medio_2m.
Snapshot point-in-time SEM lookahead: retorna a última demonstração já PUBLICADA (filed_at, data de entrega à CVM) até esta data — não a de período contábil mais recente. O indicador price passa a refletir o fechamento do pregão mais próximo <= at. Demonstrações sem filed_at conhecido caem no corte por período contábil (ver meta.filed_at). Indicadores de preço (beta, volatilidade, retorno_12m, volume_medio_2m) não têm série histórica: sob at anterior à janela corrente saem como null com reason explícito, nunca o valor atual. free_float vem do cadastro ATUAL (FRE, sem data): sob QUALQUER at sai null com reason.
^\d{4}-\d{2}-\d{2}$Response Body
curl -X GET "https://api.databolsa.com/v1/stocks/string/indicators?names=string&at=string"{
"data": [
{
"name": "string",
"label": "string",
"value": 0,
"unit": "ratio",
"reason": "string",
"reference_date": "string",
"ttm": true,
"lineage": {
"source": "string",
"reference": "string",
"url": "string"
},
"methodology_url": "string"
}
],
"meta": {
"next_cursor": "string",
"count": 0,
"total": 0,
"subject": {
"property1": "string",
"property2": "string"
},
"ticker": "string",
"reference_date": "string",
"statement_date": "string",
"filed_at": "string",
"is_financial": true
}
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"details": {
"property1": null,
"property2": null
}
}Histórico de um indicador (trimestral)
Série trimestral do indicador. Segue a MESMA política do snapshot (/stocks/{ticker}/indicators): indicadores que não se aplicam a instituições financeiras (margem_bruta, margem_ebit, margem_liquida, psr, p_ebit, p_fcf, ev_ebit, ev_ebitda, ebit_ativos, giro_ativos) vêm com os pontos em null e o motivo em `reason`, em vez de expor a série completa.
Eventos societários (desdobramentos, grupamentos, bonificações)
Os eventos MECÂNICOS que mudam a quantidade de ações/cotas e ajustam o preço, com o `factor` de conversão por data-ex. O papel é resolvido pelo grafo de identidade: pedir por um código vigente devolve também os eventos gravados sob os códigos antigos do mesmo papel (BHIA3 traz a era VVAR3/VIIA3), cada linha dizendo sob qual `ticker` foi gravada. NÃO confundir com `getObjectEvents`, que é o ledger editorial de eventos de mercado (notícias, detecções, score) — nem com `listCorporateSuccessions`, que cobre M&A e renomeação de código.