Se você quer ler dados de mercado do IQ Option com Python, o método get_candles da biblioteca não oficial iqoptionapi é o ponto de partida mais comum. Ele permite baixar velas (candles) históricas de qualquer ativo e timeframe — base para backtests, indicadores e robôs. Neste guia direto mostramos a sintaxe correta, os parâmetros que costumam confundir (timestamp e tamanho da vela), um exemplo funcional e os riscos reais de usar uma API que não é oficial.

Quer o passo a passo completo da API do IQ Option em Python, com exemplos de conexão, candles e execução?

Ver guia da API IQ Option em Python →

O que é o get_candles?

A iqoptionapi é uma biblioteca mantida pela comunidade (não oficial) que se conecta ao IQ Option pelos mesmos canais WebSocket usados pelo navegador. O método get_candles solicita um lote de velas terminando em um determinado instante de tempo, retornando uma lista de dicionários com abertura, máxima, mínima, fechamento, volume e os timestamps de cada vela.

Antes de tudo: instale a biblioteca e conecte na conta demo (modo PRACTICE). Nunca teste código novo direto na conta real.

Sintaxe e parâmetros

A assinatura usual é get_candles(ativo, intervalo, quantidade, fim_em):

ativo — par, ex.: “EURUSD”
intervalo — tamanho da vela em segundos (60 = 1 min, 300 = 5 min)
quantidade — número de velas a retornar
fim_em — timestamp Unix da vela mais recente desejada (geralmente time.time())

Exemplo funcional

import time from iqoptionapi.stable_api import IQ_Option api = IQ_Option(“seu@email.com”, “sua_senha”) api.connect() api.change_balance(“PRACTICE”) # sempre demo para testar ativo = “EURUSD” intervalo = 60 # velas de 1 minuto quantidade = 100 # últimas 100 velas fim = time.time() # até agora velas = api.get_candles(ativo, intervalo, quantidade, fim) for v in velas[-3:]: # mostra as 3 últimas print(“abertura:”, v[“open”], “fechamento:”, v[“close”], “max:”, v[“max”], “min:”, v[“min”])

Cada item da lista traz as chaves open, close, max, min, volume e os tempos from/to. Para velas em “tempo real”, basta chamar get_candles em loop com fim = time.time(), ou usar os streams contínuos (start_candles_stream / get_realtime_candles) quando quiser atualizações sem repolling.

Erros comuns

Lista vazia: geralmente o ativo está fechado (fim de semana/horário) ou o nome está errado. Confira ativos abertos com get_all_open_time().

Timestamp invertido: fim_em deve ser o final do período, não o início. Para histórico antigo, subtraia quantidade × intervalo.

Desconexão: a API não oficial cai com frequência — implemente reconexão e verifique api.check_connect() antes de cada chamada.

Riscos de usar uma API não oficial

O IQ Option não publica uma API oficial para clientes de varejo. A iqoptionapi faz engenharia sobre o protocolo do site, o que significa: pode parar de funcionar a qualquer atualização da plataforma, pode violar os termos de uso e, em casos de uso intenso/automatizado, a conta pode ser limitada. Use para estudo e backtest com responsabilidade, e jamais confie cegamente em sinais gerados por código não auditado.

FAQ

get_candles pega dados em tempo real?
Ele puxa um lote terminando no instante que você indicar. Para atualizações contínuas, use os streams (start_candles_stream / get_realtime_candles).

Qual o intervalo mínimo de vela?
Normalmente 60 segundos (1 minuto). Valores como 5, 10 e 15 segundos dependem do ativo e da disponibilidade na plataforma.

A iqoptionapi é oficial?
Não. É um projeto de comunidade, sem suporte do IQ Option, e pode quebrar a qualquer momento.

Posso fazer backtest com esses dados?
Sim, baixando velas históricas em lotes. Atenção a lacunas e ao fuso dos timestamps (Unix/UTC).

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 e técnico, não constitui recomendação de investimento, oferta ou aconselhamento financeiro. APIs não oficiais podem violar os termos de uso da corretora e parar de funcionar sem aviso. Teste sempre em conta demo antes de operar com dinheiro real e nunca arrisque valores que você não pode perder.