DataBolsa docs
Referência da APIDados de mercadoEventos de mercado e mundo

Eventos de mercado (ledger point-in-time)

Eventos estruturais, setoriais e corporativos de cada dia, detectados por ato oficial, imprensa e anomalia de preço, com as fontes em `source_refs` e os canais de transmissão a preço. Não cobre eventos societários (`listCorporateEvents`) nem agenda de resultados.

GET
/v1/events

Authorization

AuthorizationBearer <token>

In: header

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
date?string

Atalho: eventos de UM dia (equivale a from=to=date).

Match^\d{4}-\d{2}-\d{2}$
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

Camada do evento: estrutural (macro, política, mundo), setorial ou corporativa.

Value in"estrutural" | "setorial" | "corporativa"
category?string

Categoria do evento.

Value in"macro" | "politica" | "internacional" | "commodities" | "corporate" | "fii" | "cripto" | "mercado" | "outros"
entity?string

Nome de ator/empresa (ex.: 'Banco Central', 'Raizen').

ticker?string

Ticker B3 citado no evento.

thread?string

Slug da thread (ex.: 'mp-1376').

Response Body

curl -X GET "https://api.databolsa.com/v1/events?cursor=string&limit=100&date=string&from=string&to=string&layer=estrutural&category=macro&entity=string&ticker=string&thread=string"
{
  "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
  }
}

Dias anômalos e eventos associados

Retorna movimentos extremos em relação aos 252 pregões anteriores e, quando disponível, o evento associado. Para IBOV e IFIX, `local_zscore` remove fatores globais; nos demais casos, usa o retorno bruto. `min_z` filtra pelo escore efetivo. Anomalia sem evento indica lacuna no ledger, não ausência de causa.

Busca semântica no ledger de eventos de mercado

Busca por significado no histórico de eventos de mercado (decisões do Copom, medidas provisórias, tarifas, geopolítica, eventos corporativos relevantes). Complementa as leituras estruturadas de /v1/events: use quando a pergunta é temática ('renegociação de dívidas do agro', 'escalada no Oriente Médio') e depois aprofunde pelo event_id.