DataBolsa docs
Referência da APIPlataformaObjects

Lista eventos associados a um objeto

Retorna eventos do emissor associados por todos os seus tickers, sem duplicar um evento marcado com mais de um papel. A cobertura depende principalmente de ticker; lista vazia para objeto sem ticker não prova ausência de eventos. Use `listMarketEvents` para o ledger inteiro e `listCorporateEvents` para eventos societários. Duas fontes na mesma página, separadas por `type`. `market_event` é o ledger editorial — o único com `score`, detectores, thread e fontes. `renamed` é a TROCA DE CÓDIGO de negociação do papel, com o código anterior e o novo em `details`: ela não é uma ligação porque as duas pontas são o mesmo objeto, então `listObjectLinks(rel=succeeded_by)` responde só as incorporações e a renomeação sai aqui.

GET
/v1/objects/{id}/events
AuthorizationBearer <token>

In: header

Path Parameters

idstring

Identificador canônico do objeto (pub_…). Operações em lote aceitam vários ids separados por vírgula.

Query Parameters

cursor?string

Cursor opaco de meta.next_cursor da página anterior; omita na primeira página.

limit?integer

Itens por página (1–1000, default 100).

Default100
Range1 <= value <= 1000
total?string

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

from?string

Início do período (AAAA-MM-DD, inclusive).

Match^\d{4}-\d{2}-\d{2}$
to?string

Fim do período (AAAA-MM-DD, inclusive).

Match^\d{4}-\d{2}-\d{2}$
layer?string

estrutural, setorial ou corporativa.

category?string

macro, politica, internacional, commodities, corporate, fii, cripto, mercado ou outros.

type?string

market_event (ledger editorial) ou renamed (troca de código de negociação). Ausente = os dois.

Value in"market_event" | "renamed"
resolve?string

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.

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&type=market_event&resolve=auto"
{
  "data": [
    {
      "event_id": 0,
      "event_key": "string",
      "type": "string",
      "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"
        }
      ],
      "details": {
        "from": "string",
        "to": "string"
      }
    }
  ],
  "meta": {
    "next_cursor": "string",
    "count": 0,
    "total": 0,
    "subject": {
      "property1": "string",
      "property2": "string"
    }
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "details": {
    "property1": null,
    "property2": null
  }
}