O que ACONTECEU com este objeto — o ledger lido pelo grafo

O ledger de eventos existe desde antes do spine e não sabia de quem era: para pegar os eventos da Petrobras era preciso escolher entre PETR3 e PETR4 pelo `listMarketEvents`, e perder o que estivesse marcado só com o outro papel. Aqui o objeto entrega TODOS os apelidos de uma vez. **Evento é do EMISSOR, não da classe.** Um fato da companhia vem marcado ora com um papel, ora com o outro, ora com os dois — e vir marcado com os dois não o conta duas vezes aqui. Somar as consultas por ticker faria exatamente isso. **A cobertura vem do TICKER.** Há também um casamento por nome canônico exato, mas ele rende pouco e isso está medido: o ledger grava nomes curtos e às vezes truncados (`Allos`, `Anima`, `Lojas`, `Petróleo`), então só 3 de 60 casam com a razão social. Ele fica porque é seguro e pega os poucos casos de nome curto (BRAVA, BRB, HAPVIDA); afrouxar para prefixo casaria `Rio` com dezenas de empresas, e errado com confiança é pior que ausente. Na prática: **objeto sem ticker tende a devolver lista vazia**, e isso é limite conhecido, não ausência de evento. Para o ledger inteiro sem partir de um objeto, use `listMarketEvents`. Estes NÃO são eventos societários (grupamento, bonificação) — esses vivem em `listCorporateEvents`.

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

idstring

Query Parameters

cursor?string

limit?integer

Default100

Range1 <= value <= 1000

total?string

true = inclui meta.total (contagem do universo filtrado). Custa uma consulta a mais.

from?string

Match^\d{4}-\d{2}-\d{2}$

to?string

Match^\d{4}-\d{2}-\d{2}$

layer?string

estrutural, setorial ou corporativa.

category?string

resolve?string

Como interpretar o id recebido.

auto (default) — como REFERÊNCIA publicada: id fundido resolve sozinho para o sucessor (com redirected_from preenchido) e id cindido responde 409 com a lista.
exact — como o id do objeto que existe HOJE: nenhum histórico é consultado, e o id ou responde ou é 404.

Quando você precisa de exact: numa cisão, um dos sucessores é o PRÓPRIO id pedido — o ramo que ficou com a chave de nascimento herda o identificador. O 409 manda consultar cada sucessor, e consultar esse cairia no mesmo 409. exact é o endereço dele. Serve também para desligar o redirect automático de fusão quando você quer saber se o id que guardou ainda é o id de alguma coisa.

Default"auto"

Value in"auto" | "exact"

Response Body

curl -X GET "https://api.databolsa.com/v1/objects/string/events?cursor=string&limit=100&total=string&from=string&to=string&layer=string&category=string&resolve=auto"

curl -X GET "https://api.databolsa.com/v1/objects/string/events?cursor=string&limit=100&total=string&from=string&to=string&layer=string&category=string&resolve=auto"

{
  "data": [
    {
      "event_id": 0,
      "day": "string",
      "layer": "string",
      "category": "string",
      "title": "string",
      "summary": "string",
      "entities": [
        "string"
      ],
      "tickers": [
        "string"
      ],
      "transmission_channels": [
        "string"
      ],
      "score": 0,
      "detectors": [
        "string"
      ],
      "thread_slug": "string",
      "source_refs": [
        {
          "kind": "string",
          "id": "string",
          "url": "string",
          "title": "string"
        }
      ]
    }
  ],
  "meta": {
    "next_cursor": "string",
    "count": 0,
    "total": 0,
    "subject": {
      "property1": "string",
      "property2": "string"
    }
  }
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}

O que ACONTECEU com este objeto — o ledger lido pelo grafo

Authorization

Path Parameters

Query Parameters

Response Body

200

default