Dividendos

Finance

Obtenha informações detalhadas sobre dividendos de ações, fundos imobiliários e BDRs listados no Ibovespa.

Você pode obter os dividendos de ações, fundos imobiliários e BDRs listados no Ibovespa.

Requisição

Os dados são obtidos a partir do símbolo, através do parâmetro symbol.

symbol

string

É possível obter vários símbolos nas mesma consulta, desde que sejam separados por vírgula.

GEThttps://api.hgbrasil.com/finance/stock_dividends?symbol=alup4,alzr11,tgar11&key=suachave

curl -X GET "https://api.hgbrasil.com/finance/stock_dividends?symbol=alup4%2Calzr11%2Ctgar11&key=suachave"

const url = new URL("/finance/stock_dividends", "https://api.hgbrasil.com")

url.searchParams.set("symbol", "alup4,alzr11,tgar11")
url.searchParams.set("key", "suachave")

const response = await fetch(url.href)
const data = await response.json()

$url = 'https://api.hgbrasil.com/finance/stock_dividends';

$queryString = http_build_query([
    'symbol' => 'alup4,alzr11,tgar11',
    'key' => 'suachave'
]);

$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);

import requests

url = 'https://api.hgbrasil.com/finance/stock_dividends'

params = {
    'symbol': 'alup4,alzr11,tgar11',
    'key': 'suachave'
}

response = requests.get(url, params=params)
data = response.json()

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.hgbrasil.com/finance/stock_dividends')

uri.query = URI.encode_www_form({
  symbol: 'alup4,alzr11,tgar11',
  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/finance/stock_dividends?symbol=alup4%2Calzr11%2Ctgar11&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/finance/stock_dividends";

var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["symbol"] = "alup4,alzr11,tgar11";
queryParams["key"] = "suachave";

var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);

Resposta

{
  "by": "symbol_dividends",
  "valid_key": true,
  "results": {
    "ALUP4": [
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALUPACNPR5",
        "label": "Dividendo",
        "amount": 0.07,
        "approved_in": "2025-08-07",
        "traded_until": "2025-08-14",
        "payment_date": "9999-12-31"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALUPACNPR5",
        "label": "Dividendo",
        "amount": 0.1,
        "approved_in": "2025-11-06",
        "traded_until": "2025-11-13",
        "payment_date": "9999-12-31"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALUPACNPR5",
        "label": "Dividendo",
        "amount": 0.07,
        "approved_in": "2025-05-08",
        "traded_until": "2025-05-15",
        "payment_date": "2025-07-08"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALUPACNPR5",
        "label": "Dividendo",
        "amount": 0.08,
        "approved_in": "2025-04-16",
        "traded_until": "2025-04-16",
        "payment_date": "2025-06-11"
      }
    ],
    "ALZR11": [
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.08355,
        "approved_in": "2025-12-16",
        "traded_until": "2025-12-16",
        "payment_date": "2025-12-23"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.08355,
        "approved_in": "2025-11-17",
        "traded_until": "2025-11-17",
        "payment_date": "2025-11-25"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.08355,
        "approved_in": "2025-10-17",
        "traded_until": "2025-10-17",
        "payment_date": "2025-10-24"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.08355,
        "approved_in": "2025-09-18",
        "traded_until": "2025-09-18",
        "payment_date": "2025-09-25"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.08255,
        "approved_in": "2025-08-18",
        "traded_until": "2025-08-18",
        "payment_date": "2025-08-25"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.0937,
        "approved_in": "2025-07-18",
        "traded_until": "2025-07-18",
        "payment_date": "2025-07-25"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.08155,
        "approved_in": "2025-06-17",
        "traded_until": "2025-06-17",
        "payment_date": "2025-06-25"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.08155,
        "approved_in": "2025-05-16",
        "traded_until": "2025-05-16",
        "payment_date": "2025-05-23"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.09,
        "approved_in": "2025-04-16",
        "traded_until": "2025-04-16",
        "payment_date": "2025-04-25"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.09,
        "approved_in": "2025-03-18",
        "traded_until": "2025-03-18",
        "payment_date": "2025-03-25"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.09,
        "approved_in": "2025-02-18",
        "traded_until": "2025-02-18",
        "payment_date": "2025-02-25"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.09,
        "approved_in": "2025-01-17",
        "traded_until": "2025-01-17",
        "payment_date": "2025-01-24"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRALZRCTF006",
        "label": "Rendimento",
        "amount": 0.09,
        "approved_in": "2024-12-16",
        "traded_until": "2024-12-16",
        "payment_date": "2024-12-23"
      }
    ],
    "TGAR11": [
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1,
        "approved_in": "2025-11-28",
        "traded_until": "2025-11-28",
        "payment_date": "2025-12-12"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1,
        "approved_in": "2025-10-31",
        "traded_until": "2025-10-31",
        "payment_date": "2025-11-14"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1,
        "approved_in": "2025-09-30",
        "traded_until": "2025-09-30",
        "payment_date": "2025-10-14"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1,
        "approved_in": "2025-08-29",
        "traded_until": "2025-08-29",
        "payment_date": "2025-09-12"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1,
        "approved_in": "2025-07-31",
        "traded_until": "2025-07-31",
        "payment_date": "2025-08-14"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1,
        "approved_in": "2025-06-30",
        "traded_until": "2025-06-30",
        "payment_date": "2025-07-14"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1,
        "approved_in": "2025-05-30",
        "traded_until": "2025-05-30",
        "payment_date": "2025-06-13"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1,
        "approved_in": "2025-04-30",
        "traded_until": "2025-04-30",
        "payment_date": "2025-05-15"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1,
        "approved_in": "2025-03-31",
        "traded_until": "2025-03-31",
        "payment_date": "2025-04-14"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1,
        "approved_in": "2025-02-28",
        "traded_until": "2025-02-28",
        "payment_date": "2025-03-18"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1,
        "approved_in": "2025-01-31",
        "traded_until": "2025-01-31",
        "payment_date": "2025-02-14"
      },
      {
        "kind": "cash",
        "currency": "brl",
        "isin_code": "BRTGARCTF009",
        "label": "Rendimento",
        "amount": 1.1,
        "approved_in": "2024-12-30",
        "traded_until": "2024-12-30",
        "payment_date": "2025-01-15"
      }
    ]
  },
  "execution_time": 0.1,
  "from_cache": false
}

Campos

Os dados dos dividendos retornam no results com os seguintes campos:

Campo	Tipo	Descrição	Exemplo
`kind`	`string`	Tipo do título (`cash` para dinheiro, `stock` para cotas).	cash
`currency`	`string`	Moeda.	BRL
`isin_code`	`string`	Padronização internacional na codificação de títulos financeiros.	BRALUPACNPR0
`label`	`string`	Referência.	JCP
`amount`	`number`	Valor.	0.15
`approved_in`	`string`	Aprovado em.	2023-11-09
`traded_until`	`string`	Para negócios até.	2023-12-13
`payment_date`	`string`	Data do pagamento (pode ser uma data futura).	2023-12-29