DataBolsa docs
Referência da APIDados de mercadoCorporate

Sucessões de código — esta empresa virou aquela

Liga o código antigo ao novo, com a data ex e o `ratio` de conversão. `rename` é troca de código 1:1 (a empresa é a mesma); `incorporation` é M&A e a posição converte pelo ratio. É o que permite reconstruir histórico de posição atravessando a troca de código. `new_ticker` é o PRÓXIMO elo — o que casa com `ex_date` — e `current_ticker` é o código vivo no fim da cadeia. Os dois coincidem em 48 das 51 renomeações; nas outras três a diferença é que VVAR3 virou VIIA3 em 2021 e só chegou a BHIA3 em 2023.

GET
/v1/corporate/successions
AuthorizationBearer <token>

In: header

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.

ticker?string

Sucessões que envolvem este código, como antecessor OU sucessor.

event_type?string

rename = troca de código 1:1; incorporation = M&A, a posição converte pelo ratio.

Value in"rename" | "incorporation"

Response Body

curl -X GET "https://api.databolsa.com/v1/corporate/successions?cursor=string&limit=100&total=string&ticker=string&event_type=rename"
{
  "data": [
    {
      "old_ticker": "string",
      "new_ticker": "string",
      "current_ticker": "string",
      "old_entity_id": "string",
      "new_entity_id": "string",
      "ratio": 0,
      "ex_date": "string",
      "event_type": "rename",
      "source": "string",
      "note": "string"
    }
  ],
  "meta": {
    "next_cursor": "string",
    "count": 0,
    "total": 0,
    "subject": {
      "property1": "string",
      "property2": "string"
    }
  }
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string"
}