Comece a usar a API da Redentia

Bem-vindo à documentação da Redentia API. Nossa API foi projetada para ser simples, robusta e confiável, permitindo que você integre dados financeiros do mercado brasileiro em suas aplicações com o mínimo de esforço.

Este guia vai te mostrar como fazer sua primeira requisição em minutos.

Teste Agora — Sem Cadastro!

Para facilitar o desenvolvimento e testes, você pode experimentar nossa API imediatamente com estas 4 ações brasileiras populares — sem precisar de token ou cadastro:

"color:#8B92A7"># Cotação simples — funciona sem token
curl "https://api.redentia.com.br/v1/tickers/PETR4"
"color:#8B92A7">
# Múltiplas ações com histórico
curl "https://api.redentia.com.br/v1/tickers/PETR4,VALE3,MGLU3?range=1mo&interval=1d"
"color:#8B92A7">
# Com dados fundamentalistas e dividendos
curl "https://api.redentia.com.br/v1/tickers/ITUB4?fundamental=true&dividends=true"

Essas ações têm acesso completo a todos os recursos da API, incluindo dados históricos, módulos avançados e dividendos!

Faça sua Primeira Requisição

1. 1

   Obtenha sua Chave de API (Token)

   Para testar: Use as 4 ações gratuitas (PETR4, MGLU3, VALE3, ITUB4) sem precisar de token.

   Para produção: Crie sua conta no dashboard para gerar seu token e acessar todos os +4.000 ativos disponíveis.

   Onde encontrar seu token?

   Seu token estará disponível na seção "Chaves de API" do seu Dashboard após o login.

2. 2

   Faça sua Primeira Requisição

   Teste sem token (ações gratuitas):

   Terminal (cURL) — Teste Imediato

   Copiar

   curl "https://api.redentia.com.br/v1/tickers/PETR4"

   Com token (todos os ativos):

   Terminal (cURL) — Produção

   Copiar

   curl --request GET \
     --url 'https://api.redentia.com.br/v1/tickers/PETR4' \
     --header 'Authorization: Bearer SEU_TOKEN'

3. 3

   Receba os Dados

   Pronto! Você receberá uma resposta em formato JSON, estruturada e pronta para ser utilizada.

   Resposta da API (JSON)

   Copiar

   {
     "data": {
       "symbol": "PETR4",
       "name": "PETROBRAS PN",
       "currency": "BRL",
       "market_price": 49.03,
       "change_percent": 0.27,
       "volume": 56706200,
       "market_cap": 647000000000,
       "dividend_yield": 16.33,
       "pe_ratio": 6.18,
       "sector": "Energy",
       "price_at": "2026-04-11"
     }
   }

Autenticação

A autenticação é feita via Bearer Token no header Authorization. Obtenha seu token no Dashboard após se cadastrar.

Authorization: Bearer SEU_TOKEN_AQUI

Principais Conceitos

Explore Nossos Endpoints

A API expõe dados de preços, fundamentos, dividendos, rankings, setores e commentaries. Clique em qualquer endpoint na barra lateral para ver exemplos, parâmetros e código pronto para colar.

Próximos Passos

• Crie sua conta em /api-portal/auth/register para obter seu token.
• Navegue pelos endpoints na barra lateral para ver parâmetros e exemplos em 6 linguagens.
• Leia sobre planos e limites para escolher a assinatura ideal.