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.
- 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. - 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).
- 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.
- 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:
- 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.
- Faça bridge ou envie apenas o bankroll de trading pretendido em USDC na Polygon. Para suas primeiras semanas, $20–$100 é mais que suficiente.
- 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:
- 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.
- 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.
- 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.
- 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:
- Faça login em kalshi.com e conclua o KYC, caso ainda não tenha feito.
- 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.
- 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.