Como usar API de Dividendos e JCP

Esta informação requer um plano premium. Veja nossos planos para ter acesso sem limitações.

Sobre estes dados

Os dados disponíveis são de origem da B3. Retorna os Proventos em Dinheiro (Ex: Dividendos, JCP, Rendimentos…) de determinada empresa listada. Veja aqui um exemplo completo de json retornado.

Modos de Acessar

Utilize qualquer linguagem de programação ou excel. Veja aqui exemplo em Python, R e PowerBI.

Proventos Históricos

Para buscar os dados históricos, acesse o seguinte link  (Método GET)

https://www.okanebox.com.br/api/acoes/proventos/<simbolo_pregao>/

  • <simbolo_pregao> é o código de pregão da ação.

Exemplo:

https://www.okanebox.com.br/api/acoes/proventos/PETR3/

Dados Retornados pela API

Veja aqui um exemplo completo de json retornado.

[
   {
        "COD_NEG": "PETR3",
        "DATA_APROVACAO": "2023-04-27T00:00:00",
        "DATA_COM": "2023-04-27T00:00:00",
        "TIPO_PROVENTO": "DIVIDENDO",
        "VALOR": 0.49806828,
        "DATA_PAGAMENTO": "2023-12-27T00:00:00",
        "INFO": "Anual/2022",
        "OBSERVACOES": ""
    }
]