Autenticação API Polymarket: primeiro a tarefa

Por PredictionToolkit · Atualizado em 2026-10-05

Não há uma chave universal do Polymarket para todas as operações. Este guia baseado em fontes ajuda a selecionar a interface e identificar requisitos de acesso privado; não relata um teste de integração autenticada.

Antes de começar

• Defina dados de leitura ou ação privada CLOB específica.
• Use documentação atual; carteira do operador só se acesso privado for necessário.
• Mantenha segredos fora do diretório, logs públicos e relatos de problemas.

Escolha API sem criar credenciais

Gamma fornece metadados públicos de mercado sem uma chave de negociação. Data API trata de posições e atividade; CLOB trata de livros de ofertas e, separadamente, da gestão de ordens privadas. Registre o host escolhido e confira se a ação exata é pública antes de gerar credenciais. Essa seleção é uma decisão documental, não uma solicitação API executada com sucesso.

Identifique L1

Para acesso privado ao CLOB, o provedor descreve uma assinatura de carteira EIP-712 ClobAuth controlada pelo operador para criar ou derivar credenciais API. Leia os requisitos de endereço do signatário, timestamp atual, nonce e assinatura. O resultado desta etapa é uma lista de pré-requisitos, não uma mensagem assinada ou uma credencial. Ler a especificação não estabelece elegibilidade.

Planeje assinatura L2

A segunda camada documentada usa credenciais API para assinar solicitações privadas com HMAC-SHA256. Identifique os cinco cabeçalhos obrigatórios e a serialização exata do corpo na documentação oficial atual. Enviar uma ordem exige também uma assinatura de carteira que a autorize: a autenticação da solicitação L2 não a substitui. Planeje armazenamento e revogação fora deste site.

Confira resultado

• Nomeie a superfície API pública ou privada e explique por que credenciais são ou não necessárias.
• Diferencie a criação de credenciais L1, os cabeçalhos de solicitação L2 e a ordem assinada separadamente.
• Obtenha instruções do provedor sobre elegibilidade, armazenamento seguro e revogação antes de criar qualquer credencial real.

Limites do guia

Para este guia, nenhuma mensagem foi assinada, nenhuma credencial foi criada, rotacionada ou revogada, nenhuma solicitação autenticada foi enviada e nenhuma ordem foi colocada. A elegibilidade da conta e um procedimento de rotação não foram estabelecidos. Um endpoint publicado não prova disponibilidade, latência ou permissão para negociar. Nunca envie chaves privadas, segredos, frases secretas ou assinaturas ao diretório.