Objetos e contexto

O DataBolsa organiza o mercado como objetos conectados. Um ticker é uma porta de entrada, não o limite da análise: o papel pode levar à empresa emissora, aos documentos publicados, aos fundos que o detêm, aos eventos que o afetaram e às medidas observadas ao longo do tempo.

O que um objeto reúne

• Identidade: nomes e identificadores como ticker, CNPJ, ISIN ou código da série.
• Fatos: medidas com valor, data de referência, unidade e procedência.
• Histórico: a evolução temporal de uma ou mais medidas.
• Propriedades: características descritivas do objeto.
• Relações: conexões explícitas com outros objetos, como emite, detém, administra ou compõe.
• Evidências e eventos: documentos e acontecimentos associados ao sujeito.

Nem todo objeto possui todos os capítulos. Ausência de dado não vira zero e uma relação só é apresentada quando existe uma afirmação sustentada pela fonte.

Comece pelo que você conhece

No produto, pesquise pelo nome ou identificador. Na API, resolva primeiro a identidade e depois peça apenas o capítulo necessário:

databolsa resolveObject PETR4 --kind equity_security --json
databolsa getObjectFacts <entity_id> --facts close,dy_12m --json
databolsa getObjectHistory <entity_id> --facts close --from 2025-01-01 --json
databolsa listObjectLinks <entity_id> --relation issued_by --json

Operações especializadas continuam disponíveis quando preservam um cálculo ou uma estrutura de domínio útil. Para integrações novas, prefira a superfície de objetos e descubra as capacidades aplicáveis ao sujeito em vez de codificar uma lista fixa de endpoints.

Veja os handles tipados em SDK TypeScript e a referência completa em API · Objetos.