QuantBrasil
Documentação

quantbrasil assets dividends

Consulta os proventos de uma ação, unit ou BDR

Sintaxe

quantbrasil assets dividends <ticker>

Esta é uma operação de leitura. Modos de saída: json, human.

Argumentos e opções

NomeTipoObrigatórioDescriçãoPadrão
tickerArgumentoSimTicker do ativo, por exemplo VALE3 ou TAEE11—
--jsonOpçãoNãoExibe saída JSON—

Exemplos

quantbrasil assets dividends VALE3
quantbrasil assets dividends TAEE11 --json

Saída (--json)

Estrutura da resposta retornada com --json:

export interface AssetDividendsResponse {
  ticker: string;
  company: string | null;
  as_of: string;
  upcoming: DividendEvent[];
  paid_this_year: DividendsPaidThisYear;
  events: DividendEvent[];
  coverage_from: string | null;
  source_url: string | null;
}

export interface DividendEvent {
  kind: "dividend" | "jcp" | "other";
  label: string;
  value_per_share: number;
  data_com: string;
  payment_date: string | null;
  approved_on: string | null;
  related_to: string | null;
}

export interface DividendsPaidThisYear {
  year: number;
  total: number;
  dividends: number;
  jcp: number;
  other: number;
  payments: number;
}

Exemplo de resposta

{
  "ticker": "PETR4",
  "company": "PETROBRAS",
  "as_of": "2026-11-16",
  "upcoming": [
    {
      "kind": "jcp",
      "label": "JRS CAP PROPRIO",
      "value_per_share": 0.67407131,
      "data_com": "2026-08-21",
      "payment_date": "2026-11-23",
      "approved_on": "2026-08-06",
      "related_to": "Anual/2026"
    },
    {
      "kind": "dividend",
      "label": "DIVIDENDO",
      "value_per_share": 0.47156696,
      "data_com": "2026-08-21",
      "payment_date": "2026-12-21",
      "approved_on": "2026-08-06",
      "related_to": "Anual/2026"
    }
  ],
  "paid_this_year": {
    "year": 2026,
    "total": 2.30728336,
    "dividends": 0.29642144,
    "jcp": 1.97398791,
    "other": 0.03687401,
    "payments": 9
  },
  "events": [
    {
      "kind": "jcp",
      "label": "JRS CAP PROPRIO",
      "value_per_share": 0.67407131,
      "data_com": "2026-08-21",
      "payment_date": "2026-11-23",
      "approved_on": "2026-08-06",
      "related_to": "Anual/2026"
    },
    {
      "kind": "jcp",
      "label": "JRS CAP PROPRIO",
      "value_per_share": 0.35048636,
      "data_com": "2026-06-01",
      "payment_date": "2026-09-21",
      "approved_on": "2026-05-11",
      "related_to": "Anual/2026"
    }
  ],
  "coverage_from": "2025-12-22",
  "source_url": "https://sistemaswebb3-listados.b3.com.br/listedCompaniesPage/main/9512/PETR/corporate-actions?language=pt-br"
}