Ações e índices

Proventos e eventos de um ativo

Dividendos, JCP, rendimentos, desdobramentos, grupamentos e bonificações de um ativo, com data-ex, data de pagamento e valor por ação.

GEThttps://api.fintay.com.br/v1/b3/{ticker}/events

Autorização

X-API-Keystringheaderobrigatório

Chave de API criada em API Keys. Veja Chaves e limites.

Parâmetros de rota

tickerstringobrigatório

Ticker do ativo (ex.: PETR4, HGLG11).

Parâmetros de consulta

event_typestring

Filtra por tipo: dividendo, jcp, rendimento, desdobramento, grupamento, bonificacao, subscricao.

date_fromstring · date

Data-ex inicial.

date_tostring · date

Data-ex final.

limitintegerpadrão: 1000mín. 1 · máx. 5000

Máximo de eventos.

Resposta

Envelope { success, data, meta }. Campos de data.items[]:

event_idstring

Exemplo: 093eedb5-9f9b-4e73-b80b-083199422a48

tickerstring

Exemplo: PETR4

series_idstring

Exemplo: 34f27cc6-1076-46c0-aeb7-b5e85499b799

event_typestring

Exemplo: jcp

label_originalstring

Exemplo: JCP

approval_datestring

Exemplo: 2026-08-06

last_date_priorstring

Exemplo: 2026-08-21

ex_datestring

Exemplo: 2026-08-24

ex_date_sourcestring

Exemplo: 2026-08-24

payment_datestring

Exemplo: 2026-12-21

value_per_sharenumber

Exemplo: 0.20250435

factornull

factor_labelnull

isinstring

Exemplo: BRPETRACNPR6

GETProventos e eventos de um ativo

curl "https://api.fintay.com.br/v1/b3/PETR4/events?limit=3" \
  -H "X-API-Key: SUA_CHAVE"

Resposta

{
  "success": true,
  "data": {
    "ticker": "PETR4",
    "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
    "items": [
      {
        "event_id": "093eedb5-9f9b-4e73-b80b-083199422a48",
        "ticker": "PETR4",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
        "event_type": "jcp",
        "label_original": "JCP",
        "approval_date": "2026-08-06",
        "last_date_prior": "2026-08-21",
        "ex_date": "2026-08-24",
        "ex_date_source": "2026-08-24",
        "payment_date": "2026-12-21",
        "value_per_share": 0.20250435,
        "factor": null,
        "factor_label": null,
        "isin": "BRPETRACNPR6"
      },
      {
        "event_id": "6fcaecd4-97bb-4170-bd74-42e568f2da8e",
        "ticker": "PETR4",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
        "event_type": "dividendo",
        "label_original": "DIVIDENDO",
        "approval_date": "2026-08-06",
        "last_date_prior": "2026-08-21",
        "ex_date": "2026-08-24",
        "ex_date_source": "2026-08-24",
        "payment_date": "2026-12-21",
        "value_per_share": 0.47156696,
        "factor": null,
        "factor_label": null,
        "isin": "BRPETRACNPR6"
      },
      {
        "event_id": "d944692c-a778-4e02-aa62-490facd89662",
        "ticker": "PETR4",
        "series_id": "34f27cc6-1076-46c0-aeb7-b5e85499b799",
        "event_type": "jcp",
        "label_original": "JCP",
        "approval_date": "2026-08-06",
        "last_date_prior": "2026-08-21",
        "ex_date": "2026-08-24",
        "ex_date_source": "2026-08-24",
        "payment_date": "2026-11-23",
        "value_per_share": 0.67407131,
        "factor": null,
        "factor_label": null,
        "isin": "BRPETRACNPR6"
      }
    ],
    "total": 3,
    "by_year": [
      {
        "year": 1996,
        "total": 5.1471,
        "count": 1
      },
      {
        "year": 1997,
        "total": 4.1263,
        "count": 2
      },
      {
        "year": 1998,
        "total": 6.1523,
        "count": 4
      }
    ],
    "dividend_yield_12m": 5.34,
    "dividend_yield_source": 0.07,
    "latest_close": 56,
    "latest_close_date": "2026-10-09"
  },
  "error": null,
  "meta": {
    "request_id": null,
    "format": "json"
  }
}