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

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.

GET
/v1/events/anomalies
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
series?string

Série acompanhada; omitir = todas.

Value in"IBOV" | "IFIX" | "USDBRL" | "BRENT" | "VIX" | "SP500" | "NASDAQ"
min_z?number

Corte de |z-score| (default 4).

Default4
Range3 <= value <= 20
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}$

Response Body

curl -X GET "https://api.databolsa.com/v1/events/anomalies?cursor=string&limit=100&series=IBOV&min_z=4&from=string&to=string"
{
  "data": [
    {
      "day": "string",
      "series_code": "string",
      "return_pct": 0,
      "zscore": 0,
      "direction": "string",
      "factor_model": "string",
      "local_return_pct": 0,
      "local_zscore": 0,
      "explained_by": {
        "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
  }
}