Grupamentos e Desdobramentos
Finance
Consulte grupamentos e desdobramentos de ações, fundos imobiliários e BDRs negociados na B3 (Ibovespa).
Acesse o histórico completo de grupamentos e desdobramentos de ativos negociados na B3. Eventos corporativos que alteram a quantidade de ações em circulação — tudo em um único endpoint!
Tipos de Eventos
A API retorna dois tipos de eventos corporativos:
| Tipo | Título | Descrição |
|---|---|---|
split | Desdobramento | Divisão de ações (ex.: 1 → 4). |
reverse_split | Grupamento | Consolidação de ações (ex.: 10 → 1). |
Requisição
Informe o ticker no formato {fonte}:{símbolo}.
GEThttps://api.hgbrasil.com/v2/finance/splits?tickers=B3:TIMS3&key=suachave
curl -X GET "https://api.hgbrasil.com/v2/finance/splits?tickers=B3%3ATIMS3&key=suachave"
const url = new URL("/v2/finance/splits", "https://api.hgbrasil.com")
url.searchParams.set("tickers", "B3:TIMS3")
url.searchParams.set("key", "suachave")
const response = await fetch(url.href)
const data = await response.json()
$url = 'https://api.hgbrasil.com/v2/finance/splits';
$queryString = http_build_query([
'tickers' => 'B3:TIMS3',
'key' => 'suachave'
]);
$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);
import requests
url = 'https://api.hgbrasil.com/v2/finance/splits'
params = {
'tickers': 'B3:TIMS3',
'key': 'suachave'
}
response = requests.get(url, params=params)
data = response.json()
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.hgbrasil.com/v2/finance/splits')
uri.query = URI.encode_www_form({
tickers: 'B3:TIMS3',
key: 'suachave'
})
response = Net::HTTP.get(uri)
data = JSON.parse(response, symbolize_names: true)
import java.net.URI;
import java.net.http.*;
var url = "https://api.hgbrasil.com/v2/finance/splits?tickers=B3%3ATIMS3&key=suachave";
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
var data = response.body();
using System.Net.Http;
using System.Text.Json;
using System.Web;
var client = new HttpClient();
var baseUrl = "https://api.hgbrasil.com/v2/finance/splits";
var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["tickers"] = "B3:TIMS3";
queryParams["key"] = "suachave";
var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);
Parâmetros
tickers
string required
Ticker do ativo no formato
{fonte}:{símbolo}. Para múltiplos ativos, separe por vírgula: B3:TIMS3,B3:VALE3.start_date
string
Data inicial para filtrar eventos (
yyyy-mm-dd). Filtra pelo campo ex_date.end_date
string
Data final para filtrar eventos (
yyyy-mm-dd). Filtra pelo campo ex_date.date
string
Data específica para consultar eventos de um único dia (
yyyy-mm-dd).days_ago
number
Número de dias atrás a partir de hoje. Use
0 para eventos do dia atual.Resposta
{
"metadata": {
"key_status": "valid",
"cached": false,
"response_time_ms": 48.5,
"language": "pt-br"
},
"results": [
{
"ticker": "B3:TIMS3",
"symbol": "TIMS3",
"name": "TIM S.A.",
"full_name": "Tim S.A.",
"events": [
{
"type": "reverse_split",
"factor_from": 0.01,
"factor_to": 1,
"ratio": 100,
"com_date": "2025-07-02",
"effective_date": "2025-06-02",
"status": "confirmed"
}
],
"source": {
"symbol": "B3",
"name": "B3",
"full_name": "B3 S.A. - Brasil, Bolsa, Balcão",
"url": "https://www.b3.com.br",
"location": {
"timezone": "America/Sao_Paulo"
}
}
}
]
}
Campos
Os dados de cada ativo retornam no array results:
Ativo
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
ticker | string | Ticker completo no formato {fonte}:{símbolo}. | B3:TIMS3 |
symbol | string | Código de negociação do ativo. | TIMS3 |
name | string | Nome simplificado da empresa. | TIM |
full_name | string | Razão social completa da empresa. | TIM S.A. |
Eventos
Cada item do array events representa um evento de grupamento ou desdobramento:
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
type | string | Tipo do evento: split (desdobramento) ou reverse_split (grupamento). | split |
factor_from | number | Quantidade de ações antes do evento. | 1 |
factor_to | number | Quantidade de ações após o evento. | 4 |
ratio | number | Fator multiplicador do evento (factor_to / factor_from). | 4.0 |
com_date | string | Data de corte (última data em que o ativo será negociado com o preço vigente). | 2025-06-20T00:00:00-03:00 |
effective_date | string | Data efetiva do evento (quando as ações são efetivamente convertidas). | 2025-06-10T00:00:00-03:00 |
status | string | Status: pending (pendente) ou confirmed (confirmado). | confirmed |
Entendendo o ratio: Para desdobramentos (
split), o ratio será maior que 1 (ex: 4.0 significa que cada ação virou 4). Para grupamentos (reverse_split), o ratio será menor que 1 (ex: 0.1 significa que cada 10 ações viraram 1).Datas com valor
null indicam que a data ainda não foi definida.Fonte
O objeto source contém informações sobre a bolsa de valores:
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
source.symbol | string | Código da bolsa. | B3 |
source.name | string | Nome da bolsa. | B3 - Brasil, Bolsa, Balcão |
source.full_name | string | Nome completo da bolsa. | B3 S.A. - Brasil, Bolsa, Balcão |
source.url | string | Site oficial da bolsa. | https://www.b3.com.br/ |
source.location.timezone | string | Fuso horário da bolsa. | America/Sao_Paulo |