Guia Completo para Integrar com a API Smart da Angel One: Passo a Passo para Começar a Operar
- O que é a API Smart da Angel One?
- Como gerar sua chave API privada na Angel One?
- Como configurar o TOTP para segurança adicional?
- Como funciona a integração via OAuth (SMART_API_M)?
- Problemas comuns e soluções
- Perguntas Frequentes sobre a API Angel One
Este guia detalhado explica como integrar sua conta da Angel Broking (agora Angel One) usando a Smart API, cobrindo desde a geração da chave API até a configuração do TOTP. Com instruções claras e exemplos práticos, você aprenderá a configurar tanto a plataforma recomendada (SMART_API) quanto a alternativa OAuth (SMART_API_M). Incluímos screenshots, dicas de solução de problemas e melhores práticas para garantir uma integração suave.
O que é a API Smart da Angel One?
A API Smart da Angel One (anteriormente Angel Broking) é uma interface que permite aos desenvolvedores e traders automatizar suas estratégias de investimento. Ela oferece acesso direto ao mercado de ações, dados em tempo real e execução de ordens. A plataforma é amplamente utilizada por traders algorítmicos e sistemas de automação devido à sua confiabilidade e recursos avançados.
Existem duas formas principais de integração:
1. SMART_API - O método recomendado, que utiliza autenticação por chave API e TOTP
2. SMART_API_M - Uma alternativa baseada em OAuth que requer login manual diário
Como gerar sua chave API privada na Angel One?
O processo de geração da chave API é fundamental para começar a usar a Smart API. Veja o passo a passo detalhado:
1. Acesse https://smartapi.angelbroking.com/ e faça seu cadastro
2. Não esqueça de adicionar seu Client ID da Angel One (veja o screenshot abaixo)
3. Faça login no portal Smart API com suas novas credenciais
4. Clique no botão "Create An App" (veja o screenshot abaixo)
5. Selecione o tipo de API como "Trading API"
6. Nome do App: StocksDeveloper (sem espaços)
7. URL de redirecionamento: https://webx.stocksdeveloper.in/
8. Adicione seu Client ID da Angel
9. Clique em "Create App" para gerar sua chave API privada
Fonte: StocksDeveloper
Como configurar o TOTP para segurança adicional?
A autenticação em duas etapas via TOTP é essencial para proteger sua conta. Siga estas instruções:
1. Instale o aplicativo Google Authenticator no seu smartphone
2. Acesse https://smartapi.angelbroking.com/enable-totp
3. Insira o OTP recebido por SMS/e-mail
4. Você verá um QR Code e uma Chave Secreta (veja screenshot abaixo)
5. Escaneie o QR Code no Google Authenticator
6. Salve a Chave Secreta ou mantenha esta página aberta
7. No AutoTrader Web, vá para Configurações > Contas de Trading
8. Clique no seu login Angel para editar
9. Cole a Chave Secreta TOTP no campo correspondente
10. Clique em Validar e Salvar
Fonte: StocksDeveloper
Como funciona a integração via OAuth (SMART_API_M)?
A plataforma SMART_API_M oferece uma alternativa para quem prefere não compartilhar credenciais diretamente:
1. Não requer configuração de TOTP
2. Utiliza fluxo OAuth para autenticação
3. Requer login manual uma vez ao dia
4. Ideal para quem prioriza conveniência sobre automação total
Para configurar:
1. Vá para Configurações > Contas de Trading
2. Clique em Criar
3. Selecione Broker: Angel
4. Plataforma: SMART_API_M
5. Adicione sua chave API
6. Clique em Validar
7. Você será redirecionado para o site da Angel One para login
Problemas comuns e soluções
AB1007: Seu user ID ou senha está inválido - Verifique suas credenciais e tente novamente
Erros de conexão: Verifique sua internet e firewall
Chave API expirada: Gere uma nova chave se necessário
Problemas com TOTP: Certifique-se que o horário do seu dispositivo está sincronizado
Fonte: StocksDeveloper
Perguntas Frequentes sobre a API Angel One
Qual é a diferença entre SMART_API e SMART_API_M?
A SMART_API é a integração recomendada que usa autenticação direta com chave API e TOTP, enquanto a SMART_API_M utiliza OAuth e requer login manual diário.
Preciso configurar o TOTP para ambas as plataformas?
Não, o TOTP é necessário apenas para a plataforma SMART_API. A SMART_API_M utiliza OAuth e não requer configuração de TOTP.
Posso usar a mesma chave API para múltiplas contas?
Não, cada conta da Angel One requer sua própria chave API única. Você precisará repetir o processo de registro para cada conta.
Quanto tempo leva para configurar a integração?
O processo completo (incluindo TOTP) pode levar cerca de 15-20 minutos, mas é uma configuração única que não precisa ser repetida diariamente.
O que fazer se minha chave API parar de funcionar?
Verifique se a chave não expirou e se você está usando a versão correta. Se necessário, gere uma nova chave API e atualize suas configurações.
