SHARKRULE / GUIAS

API Polymarket: automação, permissões e recuperação de ordens

Automatizar pela API da Polymarket reúne descoberta de mercados, leitura de dados, regras e envio autorizado de ordens. Separe essas etapas. Conseguir uma resposta de dados não comprova que uma ordem seja permitida, aceita, executada ou liquidada.

Revisado em 12 de setembro de 2026

Cada etapa precisa do identificador certo

Um evento agrupa mercados; cada mercado apresenta uma pergunta; cada resultado tem um identificador de token. Preserve essa relação. Títulos podem ser traduzidos, abreviados ou repetidos e não são uma referência suficiente para execução.

Consulte a documentação oficial atual para descoberta, detalhes, preços e operações autenticadas. APIs e SDKs mudam. Este guia descreve o projeto do fluxo, sem publicar uma receita de assinatura baseada em um cliente antigo.

Organize cinco responsabilidades

Antes de enviar, grave um identificador persistente para a intenção, relacionando regra, observação e ordem resultante. Trata-se de prevenção de duplicação no aplicativo; não significa que todo endpoint aceite uma chave de idempotência.

  • Descobrir: identificar mercado, resultado, regras, estado e restrições aplicáveis.
  • Observar: obter uma fotografia atual e acompanhar atualizações com horários e saúde da conexão.
  • Decidir: avaliar a versão da regra sobre entradas registradas e propor ação ou abstenção.
  • Autorizar: verificar elegibilidade, assinatura, aprovações, orçamento e limites da ordem.
  • Conciliar: comparar intenção com ordens abertas, execuções e posições reais.

Sem resposta não significa sem ordem

Um tempo de espera esgotado deixa o resultado desconhecido. Suspenda reenvios dessa intenção e consulte ordens e negócios. A primeira solicitação pode ter sido aceita; repetir sem conferir pode dobrar a exposição. Preserve a incerteza mesmo quando o processo reiniciar.

Em uma ordem hipotética de dez cotas com três executadas, registre a posição de três e mantenha reserva para as sete abertas. Cancelar o restante não desfaz a parte executada. Confirme o cancelamento e atualize o estado antes da próxima decisão.

Lista de recuperação para quem desenvolve

Teste com um serviço simulado e entradas gravadas, sem credenciais. Um protótipo de somente leitura valida o mapeamento. Uma integração real exige conferir separadamente o contrato atual da API.

  • Rejeição: guardar o motivo e corrigir a condição, sem repetir às cegas.
  • Desconexão: suspender decisões que exigem dados recentes e refazer o estado atual ao reconectar.
  • Limite de requisições: respeitar a política vigente e distribuir os reintentos entre processos.
  • Envio incerto: conciliar antes de repetir e manter um estado pendente explícito.
  • Reinício: recuperar posições, ordens, permissões e reservas antes de liberar ações.
  • Acesso revogado: parar novas assinaturas e revisar ordens abertas separadamente.

A leitura não precisa carregar segredos

Separe o componente que observa daquele que pode assinar. Não coloque segredos em registros, código enviado ao navegador, repositórios ou capturas de diagnóstico. Confira vencimento e revogação de permissões na prática.

O SharkRule se baseia nas regras e permissões do usuário. Este texto não é documentação de uma API própria do SharkRule nem promete SDK ou integração disponível. O cadastro de acesso antecipado permite acompanhar as capacidades do produto.

Custódia, permissões e elegibilidade

Sem custódia significa que os fundos ficam em uma carteira controlada pelo usuário; isso não elimina permissões de negociação, riscos de contratos inteligentes ou possíveis perdas. O SharkRule é independente da Polymarket, sem afiliação ou endosso implícitos. Este conteúdo ensina sobre software, não oferece aconselhamento financeiro ou de investimento. A elegibilidade para negociar segue as restrições geográficas atuais da Polymarket.

Consultar restrições geográficas atuais

Perguntas frequentes

Preciso de credenciais de negociação para explorar dados?

Leitura e negociação autenticada são fluxos diferentes. Consulte a documentação do endpoint e não dê autoridade de assinatura a um protótipo de leitura.

Posso repetir toda requisição que falhar?

Não. A falta de resposta pode esconder um envio aceito. Confira o estado antes de criar outra ordem.

Ordem enviada significa operação concluída?

Não. Envio, aceitação, execução parcial ou total e liquidação são estados distintos.

Fontes e outras leituras