Obtém as medidas mais recentes de um ou vários objetos
Retorna as medidas mais recentes de até 50 objetos; `facts` pode selecionar até 10 medidas. Cada linha traz `entity_id`, e `meta.subjects` informa ids inexistentes, divididos ou sem dados sem reduzir o lote em silêncio. Confira `unit`, escala e `as_of` de cada medida: frequências e datas-base podem diferir na mesma resposta. `series` identifica o recorte da medida — a classe do papel, ou o escopo contábil da demonstração (`consolidado` por default, `individual` quando pedido em `series`). Para a série temporal, use `getObjectHistory`. Com `at`, medidas com `availability=filed` respeitam data-base e publicação; quando `availability=unknown`, o corte considera apenas a data-base e não constitui um point-in-time completo.
In: header
Path Parameters
Identificador canônico do objeto (pub_…). Operações em lote aceitam vários ids separados por vírgula.
Query Parameters
Corte point-in-time (AAAA-MM-DD): o último valor já público naquele dia.
^\d{4}-\d{2}-\d{2}$Nomes de medida separados por vírgula (até 10), como margem_ebit,roe. Sem ele, todas.
Qualificador da medida dentro do objeto: a classe de ação (PETR4), quando a medida é por papel, ou o escopo contábil da demonstração (consolidado | individual). Sem ele, a demonstração responde o consolidado, que é o que o contrato promete.
Como interpretar o id: auto segue fusões e, em cisões, responde 409 com os sucessores; exact lê literalmente o objeto desse id. Use exact para acessar o ramo de uma cisão que preservou o identificador original ou para desativar o redirecionamento automático.
"auto""auto" | "exact"Response Body
curl -X GET "https://api.databolsa.com/v1/objects/string/facts?at=string&facts=string&series=string&resolve=auto"{
"data": [
{
"name": "string",
"label": "string",
"series": "string",
"value": 0,
"unit": "brl",
"as_of": "string",
"statement_date": "string",
"available_at": "string",
"availability": "filed",
"cadence": "daily",
"grain": "object",
"source": "string",
"lineage": "string",
"provenance": {
"adjust_type": "string",
"adjust_quality": "string"
},
"description": "string",
"out_of_prior": true,
"axes": {
"dimension": "string",
"scale": "string",
"period": "string",
"seasonal_adjustment": "string",
"expected_range": {
"min": 0,
"max": 0
},
"concept": "string",
"aggregation": "string"
},
"entity_id": "string"
}
],
"meta": {
"next_cursor": "string",
"count": 0,
"total": 0,
"subject": {
"property1": "string",
"property2": "string"
},
"subjects": [
{
"id": "string",
"resolved_id": "string",
"redirected_from": "string",
"status": "ok",
"reason": "string",
"successors": [
"string"
]
}
]
}
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"details": {
"property1": null,
"property2": null
}
}Lista trechos de documentos que sustentam o objeto
Retorna trechos de documentos associados ao objeto, com protocolo, fonte e páginas. `excerpt` preserva o texto do documento. A associação prova que o documento pertence ao objeto; não prova, sozinha, uma relação ou medida específica. Para relações, consulte `source` na própria aresta. Os resultados seguem a ordem de entrada no acervo, do mais recente para o mais antigo, e podem ser recortados por `from`/`to`. Resposta vazia significa que não há evidência indexada para o recorte, não que a afirmação investigada seja falsa.
Obtém séries de medidas de um ou vários objetos
Aceita até 50 IDs e 10 medidas separados por vírgula; retorna uma série por par objeto-medida. `meta.subjects` informa IDs ausentes ou sem dados, e uma medida incompatível retorna `error`, não série vazia. `series` escolhe o recorte — a classe do papel, ou o escopo contábil da demonstração (`consolidado` | `individual`); sem ela, `meta.series` informa a usada. `limit` seleciona os pontos mais recentes. O limite total é 100 séries e 100.000 pontos; excesso responde 422. `transform` calcula acumulados (`compound_12m`, `sum_12m`, `ytd`), médias e variações sobre a série, guardado pela classe `axes.aggregation` que a série declara; `transform.served_from` diz quando a resposta é a série que a fonte já publica.