API Pública
Chaves de API REST para acesso programático (plano Bot)
A API Pública da Predite permite ler os seus próprios dados de forma programática — seu portfólio ao vivo e os sinais de Expected Value mais recentes — a partir dos seus scripts, planilhas ou ferramentas de trading. É uma API REST somente leitura, protegida por uma chave de API pessoal, disponível no plano Bot.
Você cria e gerencia as chaves pelo dashboard, em Configurações, na página API.
Criando uma chave de API
Dê um rótulo à chave (por exemplo, "importar planilha" ou "script de backtest") e crie-a. Alguns pontos importantes:
- •A chave completa aparece uma única vez, no momento da criação. Ela começa com pdt_live_ seguido de uma sequência aleatória. Copie na hora e guarde em local seguro — ela nunca mais é exibida, porque só um hash dela fica nos nossos servidores.
- •Depois da criação, o dashboard mostra apenas o prefixo curto da chave, para você diferenciar uma da outra.
- •Cada chave é somente leitura e expira em um ano a partir da criação. Você é avisado antes do vencimento.
- •Você pode revogar uma chave a qualquer momento. A revogação vale imediatamente — qualquer script que ainda a use passa a receber 401 Unauthorized.
Autenticação
Envie a chave como Bearer token no header Authorization de toda requisição:
Authorization: Bearer pdt_live_your_key_here
Chave ausente ou inválida retorna HTTP 401. As requisições têm rate limit por cliente — se você enviar muitas rápido demais, recebe HTTP 429 com um header Retry-After informando quantos segundos esperar. Mantenha o polling em poucas requisições por minuto e faça cache do que buscar; nada desses dados muda de segundo em segundo.
Endpoints
Hoje existem dois endpoints GET, ambos retornando JSON.
GET /api/v1/portfolio
Retorna as posições abertas da carteira Polymarket conectada à sua conta, junto com um resumo e um timestamp generated_at. Se você ainda não conectou e verificou uma carteira, o array positions volta vazio com o erro no_wallet_connected — conecte uma primeiro (veja Conectando Sua Carteira).
GET /api/v1/signals
Retorna os principais sinais de Expected Value do momento, ordenados por edge. Dois parâmetros de query opcionais:
- •limit — quantos sinais retornar, de 1 a 100 (padrão 20)
- •min_edge — o edge mínimo em pontos percentuais (padrão 5)
A resposta inclui o array signals, um count, os filtros que você usou e um timestamp generated_at.
Exemplo
Uma requisição mínima com curl, pedindo os dez sinais mais fortes com pelo menos seis pontos de edge:
curl -H "Authorization: Bearer pdt_live_..." "https://predite.io/api/v1/signals?limit=10&min_edge=6"
Vale saber
- •A API é somente leitura — não existem endpoints de trading nem de escrita. Ordens são sempre enviadas pelo app, então uma chave vazada nunca consegue mexer no seu dinheiro.
- •Ainda assim, trate a chave como uma senha. Se ela vazar, revogue e emita outra.
- •Prefere receber os alertas em vez de ficar consultando? Vincule sua conta ao Telegram e deixe os sinais chegarem até você.