Ler o saldo da conta é uma das primeiras coisas que todo mundo tenta fazer ao automatizar a Quotex com Python — e também onde muita gente trava, porque a pyquotex é assíncrona e exige conexão ativa antes de qualquer leitura. Neste guia honesto de 2026 você vai ver como usar get_balance(), como alternar entre conta demo (PRACTICE) e real com change_account(), e como evitar os erros que fazem o saldo voltar como None ou zero.

O que é a pyquotex (e por que ela é assíncrona)

A pyquotex é uma biblioteca não oficial, mantida pela comunidade, que se comunica com a Quotex via WebSocket. Como toda a troca de mensagens acontece de forma assíncrona, quase todos os métodos são async e precisam ser chamados com await dentro de uma função async. Ignorar isso é o motivo mais comum de o saldo “não vir”.

Passo 1 — Conectar à conta

Você cria o cliente com e-mail e senha e chama connect(). Ele retorna uma tupla (check, mensagem) indicando se a conexão deu certo:

import asyncio
from pyquotex.stable_api import Quotex

client = Quotex(email="seu_email", password="sua_senha")

async def main():
    check, mensagem = await client.connect()
    print("Conectado?", check, mensagem)

asyncio.run(main())

Passo 2 — Ler o saldo com get_balance()

Com a conexão ativa, get_balance() devolve o saldo da conta atualmente selecionada. Sempre confirme o check da conexão antes de chamar:

async def ver_saldo():
    check, _ = await client.connect()
    if not check:
        print("Não conectou — verifique login/sessão")
        return

    saldo = await client.get_balance()
    print("Saldo atual:", saldo)

asyncio.run(ver_saldo())

Passo 3 — Alternar entre demo e real com change_account()

A Quotex tem conta de prática e conta real, e o saldo retornado depende de qual está ativa. Use change_account() para escolher — e, para qualquer teste, fique na "PRACTICE":

async def saldos():
    await client.connect()

    client.change_account("PRACTICE")   # conta demo
    print("Demo:", await client.get_balance())

    client.change_account("REAL")       # conta real
    print("Real:", await client.get_balance())

asyncio.run(saldos())

Repare como é fácil ler o saldo da conta real sem perceber. Em scripts de estudo, deixe a chamada para "REAL" de fora e trabalhe só na demo.

Recarregar o saldo após uma operação

O saldo não se atualiza sozinho a cada instante; depois de uma ordem, chame get_balance() novamente para ler o valor já liquidado. Se precisar forçar uma atualização, alguns fluxos usam um pequeno await asyncio.sleep() antes de reler, dando tempo de o servidor processar:

saldo_antes = await client.get_balance()
# ... envia uma ordem em conta demo ...
await asyncio.sleep(2)
saldo_depois = await client.get_balance()
print("Variação:", saldo_depois - saldo_antes)

FAQ

get_balance() precisa de await? Sim. É um método assíncrono; chamá-lo sem await devolve uma corrotina, não o número.

Por que o saldo volta como None? Conexão não concluída, sessão expirada ou conta errada selecionada. Confirme o check do connect() primeiro.

A pyquotex é oficial? Não. É um projeto da comunidade, sem suporte da Quotex, e pode parar de funcionar quando a plataforma muda algo.

Consigo automatizar lucro lendo o saldo? Não. Ler o saldo é só monitoramento; não altera o risco estrutural das opções binárias.

Aviso: opções binárias são produtos de altíssimo risco e a maioria dos investidores de varejo perde dinheiro. Este conteúdo é educacional e técnico, não constitui recomendação de investimento, oferta ou promessa de retorno. Bibliotecas não oficiais podem violar os termos de uso da plataforma e parar de funcionar sem aviso. Teste sempre em conta demo antes de qualquer uso com dinheiro real.