Se você procura a API da IQ Option em Python, a primeira verdade honesta é esta: a IQ Option não tem API pública oficial para automação de contas de varejo. Tudo o que circula em GitHub — incluindo a popular biblioteca pyiqoptionapi (fork mantido do antigo iqoptionapi) — é engenharia reversa do canal WebSocket usado pelo site. Funciona, mas vive em zona cinzenta e pode quebrar a qualquer atualização da corretora. Este guia mostra os métodos reais, com exemplos, e onde estão os riscos.

Quer automatizar sem brigar com biblioteca não-oficial que cai toda semana? Veja a alternativa pronta:

▶ Ver bot e integração IQ Option em Python

A IQ Option tem API oficial?

Não para o trader comum. A IQ Option oferece integrações via parceria/afiliados em alguns casos corporativos, mas não publica documentação de API de trading para contas individuais. Por isso toda automação depende de bibliotecas que imitam o navegador, conectando-se ao endpoint WebSocket wss://iqoption.com/echo/websocket e enviando os mesmos comandos que o site enviaria.

Consequência prática: como nada é oficial, a corretora pode mudar o protocolo, exigir captcha, ou bloquear a conta por uso automatizado. Use sempre conta demo primeiro e nunca arrisque dinheiro que não pode perder.

Instalação da biblioteca

O fork mais ativo costuma ser o pyiqoptionapi. A instalação típica:

pip install pyiqoptionapi # alternativa direta do repositório: pip install git+https://github.com/iqoptionapi/iqoptionapi.git

Conexão e login

O ponto de entrada é a classe principal. O método connect() retorna uma tupla (status, motivo) — sempre cheque o status antes de continuar:

from iqoptionapi.stable_api import IQ_Option import logging logging.basicConfig(level=logging.INFO) api = IQ_Option(“seu_email”, “sua_senha”) status, reason = api.connect() if status: print(“Conectado!”) else: print(“Falha:”, reason) # Trabalhe SEMPRE em demo durante os testes: api.change_balance(“PRACTICE”) # ou “REAL” print(“Saldo:”, api.get_balance())

Principais métodos que você vai usar

Estes são os métodos mais comuns no dia a dia (os nomes podem variar entre forks — confira a versão instalada):

Conta e saldo: connect(), check_connect(), change_balance("PRACTICE"/"REAL"), get_balance(), reset_practice_balance().
Cotações / velas: get_candles(ativo, intervalo, quantidade, fim), start_candles_stream(), get_realtime_candles(), stop_candles_stream().
Ordens binárias: buy(valor, ativo, direcao, expiracao) retorna (check, id); acompanhe com check_win_v4(id) ou check_win_digital_v2(id) para opções digitais.

Exemplo: ler velas e enviar uma ordem (em DEMO)

ativo = “EURUSD” # 10 velas de 1 minuto até agora import time velas = api.get_candles(ativo, 60, 10, time.time()) ultima = velas[-1] print(“Fechamento:”, ultima[“close”]) # Ordem binária de 1 dólar, CALL, expiração de 1 minuto direcao = “call” # ou “put” valor = 1 expiracao = 1 check, order_id = api.buy(valor, ativo, direcao, expiracao) if check: resultado, lucro = api.check_win_v4(order_id) print(“Resultado:”, resultado, “Lucro/Prejuízo:”, lucro) else: print(“Ordem recusada”)
Dica de robustez: envolva chamadas em try/except e reconecte com check_connect(). WebSocket cai com frequência, e um loop sem reconexão simplesmente trava.

Erros comuns (e por que acontecem)

A maioria dos problemas não é bug no seu código, e sim mudança do lado da corretora:

Login falha mesmo com senha certa → captcha/2FA ou bloqueio anti-bot.
Conexão cai em loops longos → falta de reconexão e keep-alive.
get_candles vazio → ativo fechado no horário ou nome de símbolo incorreto.
Biblioteca para de funcionar do nada → a IQ Option atualizou o protocolo; espere um fork novo.

Vale a pena automatizar a IQ Option?

Para aprender e testar ideias em demo, sim — é um ótimo laboratório. Para operar dinheiro real, pondere: você depende de código não-oficial que pode quebrar, e nenhuma automação transforma opções binárias (jogo de soma negativa pelo payout) em renda garantida. Se o objetivo é estabilidade, considere corretoras com API documentada de verdade, como a Deriv, ou soluções prontas já testadas.

FAQ

A pyiqoptionapi é segura? O código é aberto e auditável, mas você entrega e-mail e senha a ele. Use senha exclusiva e, de preferência, conta demo.

Posso ser banido por usar? Sim. Automação geralmente fere os termos de uso. A corretora pode encerrar a conta.

Funciona com opções digitais? Sim, há métodos específicos (buy_digital_spot, check_win_digital_v2), mas mudam mais entre versões.

Existe alternativa mais estável? A Deriv tem API oficial documentada. Para IQ Option, soluções prontas reduzem o trabalho de manutenção.

Aviso: opções binárias são produtos de altíssimo risco e a maioria dos traders de varejo perde dinheiro. Este conteúdo é educacional, não constitui recomendação de investimento, e bibliotecas não-oficiais podem violar os termos da corretora. Teste sempre em conta demo antes de qualquer operação real.