Skip to main content
← Voltar aos Guias
Iniciante📖 13 min

Conectando Suas Contas: Polymarket e Kalshi, do Início ao Fim

O Predite funciona perfeitamente como ferramenta de pesquisa sem você conectar nada — você pode escanear mercados, ler estimativas de probabilidade da AI e estudar EV o dia inteiro. Mas a plataforma fica drasticamente mais útil no momento em que ela sabe o que você realmente possui. Conecte suas contas e suas posições reais fluem para a página de Portfólio, seu P&L passa a ser ao vivo em vez de hipotético, e o EV Scanner começa a cruzar cada sinal com os mercados aos quais você já está exposto. Este guia leva você passo a passo pela conexão de Polymarket e Kalshi do zero, explica os dois níveis de acesso bem distintos que você pode conceder e cobre exatamente como seus segredos são armazenados. Ele foi escrito para alguém que nunca colou uma private key em nada antes — então vamos com calma e explicar o *porquê* por trás de cada passo.

Dois Tipos de Conexão: Somente Leitura vs. Trading

O conceito mais importante aqui é que existem dois níveis de acesso completamente diferentes, e você deve entender ambos antes de fazer qualquer coisa.

Uma conexão somente leitura permite que o Predite *veja* suas posições, mas nunca as toque. Para a Polymarket, isso significa que você nos dá nada além do endereço público da sua carteira — a mesma string 0x… de 42 caracteres que fica visível para qualquer pessoa em um explorador de blocos. Apenas com esse endereço, o Predite lê suas posições abertas, seus preços médios de entrada e seu valor atual de marcação a mercado diretamente da chain. Sem private key, sem assinatura, sem capacidade de movimentar fundos. Este é o ponto de partida certo para praticamente todo mundo.

Uma conexão de trading é outra história. Para deixar o Predite *enviar ordens* em seu nome — que é o que alimenta os bots automatizados e a interface de Live Trading com um clique — precisamos de credenciais que possam de fato assinar transações. Na Polymarket, isso significa sua private key. Esta é uma concessão séria de poder: quem detém uma private key controla os fundos daquela carteira, ponto final. Vamos cobrir exatamente como fazer isso com segurança, mas a regra principal é simples: nunca conecte sua carteira principal para trading. Use uma carteira de trading dedicada, financiada apenas com o que você pode se dar ao luxo de perder.

Um modelo mental útil: uma conexão somente leitura é como dar a alguém o seu extrato bancário. Uma conexão de trading é como dar a essa pessoa seu cartão de débito e a senha. A maioria das pessoas só precisa mesmo do extrato.

Restrições por plano, de cara

  • Acompanhamento de portfólio somente leitura funciona em todos os planos, incluindo o Starter ($29/mês).
  • Trading ao vivo na Polymarket (a conexão por private key, bots executando ordens reais, a interface de Live Trading) exige o plano Bot ($99/mês) com uma assinatura ativa. Se você tentar se conectar para trading ao vivo no Starter ou no Pro, a API retornará uma mensagem clara de "Bot plan required".
  • Pro ($59/mês) fica no meio do caminho: scanner completo, alertas e portfólio unificado — mas nenhum bot. O Bot Builder é do plano Bot de ponta a ponta, paper incluído.

Parte 1: Conectando a Polymarket (Somente Leitura)

Esta é a versão de cinco minutos que cobre 90% dos usuários. Você está apenas entregando um endereço público.

  1. Abra a Polymarket e encontre o endereço da sua carteira. Clique no seu avatar (canto superior direito) → seu endereço aparece no topo do menu, começando com 0x. Clique para copiá-lo. Ele terá exatamente 42 caracteres.
  2. No Predite, vá em Configurações → Portfólio → Adicionar Carteira (ou cole o endereço no prompt de onboarding do Portfólio Unificado na primeira vez que abrir a página de Portfólio).
  3. Cole o endereço. O Predite valida o formato (precisa ser um endereço EVM válido — 42 caracteres hexadecimais) e rejeita qualquer coisa malformada antes de salvar.
  4. Pronto. Em alguns segundos suas posições aparecem.

Como esses são dados públicos, não há risco nem nada para criptografar. Você pode adicionar múltiplos endereços — útil se você mantém carteiras separadas para mercados de política e de cripto — e até acompanhar carteiras que não são suas (alguns traders monitoram carteiras sabidamente afiadas dessa forma).

Parte 2: Conectando a Polymarket para Trading

Se você está no plano Bot e quer que os bots de fato executem, você fornecerá uma private key. Antes de tocar no formulário, prepare-se corretamente.

Passo 0: Crie uma carteira de trading dedicada

Não pule isto. A carteira que você conecta para trading deve ser uma carteira nova que contenha apenas seu bankroll de trading. Eis o raciocínio em termos concretos: se você tem $8.000 na sua carteira principal e um bug, um site de phishing ou um backup vazado expuserem essa key, todos os $8.000 se vão — não existe estorno em uma blockchain. Se, em vez disso, você financiar uma carteira dedicada com $100, sua perda no pior cenário é $100. Essa assimetria é enorme, e configurar isso não custa nada.

Uma abordagem limpa:

  1. Crie uma carteira totalmente nova no MetaMask (ou Rabby, ou uma carteira de hardware) — uma nova conta, nova seed phrase, nunca usada para mais nada.
  2. Faça bridge ou envie apenas o bankroll de trading pretendido em USDC na Polygon. Para suas primeiras semanas, $20–$100 é mais que suficiente.
  3. Use a private key *dessa* carteira ao se conectar. Trate a seed phrase dela como descartável no sentido de que você limitou o prejuízo — mas ainda assim guarde-a com segurança.

Passo 1: Entenda os três signature types

Esta é a parte que confunde iniciantes, então vamos ser precisos. A Polymarket suporta três arquiteturas de conta, e o Predite precisa saber qual delas você tem. O formulário de conexão as rotula e a API valida que você escolheu uma combinação coerente.

  • Type 0 — EOA (Externally Owned Account). Esta é uma carteira Ethereum padrão: MetaMask, Rabby, Coinbase Wallet ou uma carteira de hardware. Escolha esta se você importou sua própria carteira para a Polymarket usando uma seed phrase ou private key. Para uma EOA, o *funder* (o endereço que detém o dinheiro) é o mesmo que sua carteira de assinatura. O Predite na verdade força isso: se você selecionar o Type 0 e fornecer um funder diferente, o servidor o sobrescreve com o próprio endereço da sua carteira para evitar falhas silenciosas de ordem mais tarde.
  • Type 2 — Gnosis Safe Proxy. Este é o tipo mais comum para quem se cadastrou em polymarket.com usando login social ou e-mail (Google, etc.). A Polymarket provisionou uma carteira "proxy" de smart contract para você nos bastidores. Sua key de assinatura é um endereço, mas seus fundos ficam em uma carteira proxy *separada*. Esse endereço proxy é o seu funder, e você o encontra em polymarket.com/settings.
  • Type 1 — Magic Link Proxy. Escolha este se você faz login na Polymarket via Magic Link (e-mail) e exportou a private key subjacente. Como o Type 2, ele usa um endereço proxy separado como funder.

Uma maneira rápida de se autodiagnosticar: *Eu importei minha própria carteira no estilo MetaMask para a Polymarket?* → Type 0. *Eu apenas me cadastrei com minha conta do Google ou e-mail no site?* → quase certamente Type 2.

Passo 2: Obtenha sua private key

Onde você exporta a key depende da sua carteira:

  • MetaMask: clique nos três pontos ao lado do nome da sua conta → Detalhes da conta → Mostrar private key, digite sua senha e copie a string hexadecimal de 64 caracteres (ela pode ou não começar com 0x — o Predite aceita ambos e a normaliza).
  • Contas proxy Magic Link / e-mail: use a opção "Export Private Key" da Polymarket nas configurações da sua conta.

Enquanto ela estiver na sua área de transferência, trate essa string como uma granada destravada. Não a cole em um chat, em uma nota que sincroniza com a nuvem ou em qualquer site que não seja o formulário de conexão do Predite via HTTPS. Limpe a área de transferência depois.

Passo 3: Encontre seu funder address (apenas Types 1 e 2)

Se você é uma EOA Type 0, pule isto — deixe o campo do funder em branco e o Predite usa o endereço da sua carteira automaticamente. Para os Types 1 e 2, vá em polymarket.com/settings e copie seu endereço de proxy/depósito. Este é o endereço que o Predite valida como seu funder, e ele precisa ser diferente da sua carteira de assinatura. Na verdade, o endpoint de conexão rejeitará a tentativa com uma mensagem explícita se o funder for igual à carteira em um tipo proxy — essa incompatibilidade é o erro de configuração mais comum, e quase sempre significa que você na verdade tem uma EOA e deveria ter escolhido o Type 0.

Passo 4: Execute o assistente de conexão

No Predite, vá em Configurações → Trading API → Polymarket. O assistente conduz você por todo o processo:

  1. Tela de introdução. Ela explica o fluxo e lembra você de usar uma carteira dedicada. Há um guia visual passo a passo opcional que você pode abrir primeiro.
  2. Reconhecimento de risco. Você marcará uma caixa confirmando que entende que o trading ao vivo está em beta, que bugs de software podem causar trades não intencionais, que somente você é responsável pelos fundos na carteira conectada e que o Predite não pode recuperar fundos perdidos. Isso fica registrado.
  3. Formulário de credenciais. Escolha o tipo da sua carteira (signature type 0/1/2), cole sua private key (há um botão de mostrar/ocultar) e informe seu funder address, se necessário.
  4. Conectar. O Predite assina uma mensagem com sua key para derivar suas credenciais da CLOB API da Polymarket (um passo de L2 — nenhuma transação on-chain acontece no momento da conexão, e nada é gasto), criptografa tudo e salva.

As tentativas de conexão são limitadas a 5 a cada 15 minutos para desencorajar força bruta e incentivar acertar os dados de entrada. Se algo estiver errado, você receberá um erro específico — signature type errado e carteiras não registradas são os culpados de sempre.

Passo 5: Teste antes de confiar

Uma vez conectado, a aba da Polymarket exibe um botão "Place Test Order". Use-o. Cole o token_id de um mercado (você o encontra nos detalhes do ativo no scanner ou em clob.polymarket.com), defina um tamanho minúsculo como 5 shares a $0,50 e dispare. Se o trading ao vivo em toda a plataforma ainda estiver desligado, a ordem é registrada como paper trade para que você possa validar todo o pipeline de conectar → assinar → enviar com risco zero. Quando você for ao ar, comece com ordens de $1–$5 nos seus primeiros trades reais.

Algumas coisas que você verá no card conectado: os endereços da sua carteira e do funder, o tipo da sua carteira, um indicador de allowances (aprovações de gasto de USDC, configuradas automaticamente no primeiro trade) e um indicador de gas. Se sua conta participa do programa de relayer/builder da Polymarket, você verá um selo "Gasless" — os trades são roteados pelo relayer da Polymarket e você só precisa de USDC. Caso contrário, você precisará de uma pequena quantia de MATIC na carteira para pagar o gas.

Parte 3: Conectando a Kalshi

A Kalshi não tem nada a ver com a Polymarket em termos de arquitetura. É uma exchange regulada pela CFTC sem blockchain — a autenticação é uma API key mais assinatura RSA de requisições, e exige KYC concluído. Por causa desse design regulado e baseado em assinatura, o trading ao vivo na Kalshi dentro do Predite está no roadmap, ainda não foi lançado. A aba da Kalshi em Configurações exibe um status claro de "em breve".

Aqui está a nuance importante, porém: os dados de mercado, a analítica, a cobertura do scanner e as leituras de portfólio somente leitura da Kalshi funcionam em todo o resto do app neste momento. Os mercados da Kalshi aparecem no EV Scanner, o motor de arbitrage os compara com a Polymarket para spreads entre plataformas e, assim que o conector de leitura estiver ligado à sua conta, suas posições da Kalshi se integram ao Portfólio unificado. Para deixar uma API key da Kalshi pronta para quando as leituras/trading forem expandidos:

  1. Faça login em kalshi.com e conclua o KYC, caso ainda não tenha feito.
  2. Vá em Account → API / Settings e crie uma API key. A Kalshi emite um key ID e permite baixar um arquivo de private key RSA uma única vez — salve-o com segurança; ele não pode ser baixado novamente.
  3. Mantenha ambos seguros. Quando o Predite habilitar a conexão com a Kalshi, você colará o key ID e a key RSA, e elas serão criptografadas exatamente como as credenciais da Polymarket.

Por enquanto, a jogada prática é: apoie-se na Kalshi para *leituras e sinais* por meio do scanner e execute na Kalshi manualmente até que o trading ao vivo chegue.

O Que Se Ativa Quando Você Está Conectado

Esta é a recompensa. Conectar transforma o Predite de um scanner genérico em algo ajustado para *você*:

  • O portfólio ganha vida. A página de Portfólio Unificado agrega posições de todas as plataformas conectadas em uma única visão — valor total, custo base total (shares × preço médio) e detalhamentos por plataforma. Uma tela em vez de três abas do navegador.
  • P&L real, não hipotético. Em vez de adivinhar, você vê ganhos e perdas não realizados de fato por posição, calculados a partir dos seus preços reais de entrada versus os preços de mercado ao vivo. Uma posição que você abriu a $0,40 e agora é negociada a $0,61 mostra um concreto +52,5% em vez de uma abstração.
  • O scanner trabalha contra suas posições. Esta é a discretamente poderosa. O EV Scanner pode sinalizar quando um mercado que você já detém derivou — digamos que seu modelo ainda lê 60% mas o preço alcançou os 60%, ou seja, seu edge acabou e é hora de realocar capital. Ele também pode revelar exposição correlacionada: se três das suas posições se resolvem na mesma decisão do Fed, isso é efetivamente uma única aposta, e vê-las juntas impede você de se concentrar demais.
  • Exportações e relatórios fiscais. Com o histórico real de trades conectado, você pode exportar CSVs e gerar um relatório de P&L/fiscal com totais mensais e custo base FIFO — muito mais fácil no fim do ano do que reconstruir os trades à mão.
  • Automação (plano Bot). Com uma conexão de trading ativa, os bots dimensionam e enviam ordens contra seu bankroll real, e a interface de Live Trading, o kill switch e os controles por trade ficam todos disponíveis.

Segurança: Como Seus Segredos São Armazenados

Você está nos confiando uma private key, então merece saber exatamente o que acontece com ela. A versão honesta e específica:

  • A criptografia é AES-256-GCM, uma cifra autenticada que protege tanto a confidencialidade quanto a integridade (um texto cifrado adulterado falha na descriptografia em vez de retornar lixo silenciosamente).
  • A key é derivada com scrypt, uma função de derivação de chave deliberadamente lenta, usando um salt aleatório de 16 bytes e um novo IV aleatório de 12 bytes para cada criptografia individual. Nenhum par de valores armazenados compartilha os mesmos parâmetros, o que derrota ataques de rainbow-table e de reuso de IV.
  • O texto puro nunca toca o disco. Sua private key chega por HTTPS, é criptografada em memória, e apenas o texto cifrado é gravado no banco de dados. Quando um bot precisa assinar uma ordem, a key é descriptografada em memória apenas pelo instante necessário para assinar e então descartada.
  • Os segredos nunca são registrados em log — nem mesmo parcialmente. O log de auditoria registra que uma conexão aconteceu, a carteira, o funder e o signature type, mas o código exclui explicitamente a private key e o segredo da API de cada linha de log.
  • Desconectar de fato remove as credenciais. Clique em "Disconnect" e uma rotina do servidor anula suas keys armazenadas; quaisquer bots em modo ao vivo param de enviar ordens e você recebe uma notificação — eles não viram bots de paper em silêncio. Para rotacionar uma key, basta desconectar e reconectar com a nova.

Nada disso muda a regra fundamental, que vale repetir uma última vez: a criptografia protege a key *em repouso no nosso sistema*, mas não pode desfazer um trade ruim nem recuperar fundos se a seed phrase da sua própria carteira vazar em outro lugar. O hábito da carteira dedicada é sua verdadeira rede de segurança — o software é a segunda camada, não a primeira.

Agora você tem tudo de que precisa para conectar o Predite ao seu trading. Se você fizer apenas uma coisa hoje, cole o endereço da sua carteira da Polymarket na página de Portfólio e veja suas posições reais e seu P&L ao vivo se preencherem em segundos — é somente leitura, sem risco, e instantaneamente deixa todos os outros recursos mais inteligentes. Quando você estiver pronto para deixar os bots fazerem o trabalho, financie uma carteira nova com uma quantia que você não sentiria falta, execute o assistente de conexão e dispare uma ordem de teste de $1 antes de qualquer coisa maior. Comece pequeno, verifique tudo e escale somente quando os números corresponderem às suas expectativas.