Autenticación API Polymarket: primero la tarea

Por PredictionToolkit · Actualizado el 2026-10-05

No hay una clave universal de Polymarket para todas las operaciones. Esta guía basada en fuentes ayuda a elegir la interfaz e identificar los requisitos de acceso privado; no presenta una prueba de integración autenticada.

Antes de empezar

• Define datos de lectura o acción privada CLOB concreta.
• Usa documentación oficial actual; cartera controlada por operador solo si necesitas acceso privado.
• Mantén secretos fuera del directorio, registros públicos e incidencias.

Elige API sin crear credenciales

Gamma proporciona metadatos públicos de mercado sin una clave de trading. Data API gestiona posiciones y actividad; CLOB gestiona libros de órdenes y, por separado, la gestión de órdenes privadas. Anota el host elegido y comprueba si la acción exacta es pública antes de generar credenciales. Esta selección es una decisión basada en documentación, no una solicitud API ejecutada con éxito.

Identifica L1

Para el acceso privado a CLOB, el proveedor describe una firma de cartera EIP-712 ClobAuth controlada por el operador para crear o derivar credenciales API. Lee los requisitos de dirección del firmante, marca temporal actual, nonce y firma. El resultado de este paso es una lista de requisitos, no un mensaje firmado ni una credencial. Leer la especificación no establece elegibilidad.

Planifica firma L2

La segunda capa documentada usa credenciales API para firmar solicitudes privadas con HMAC-SHA256. Identifica los cinco encabezados obligatorios y la serialización exacta del cuerpo en la documentación oficial actual. Enviar una orden requiere además una firma de cartera que la autorice: la autenticación de solicitudes L2 no la sustituye. Planifica el almacenamiento y la revocación fuera de este sitio.

Comprueba resultado

• Nombra la superficie API pública o privada y explica por qué se necesitan o no credenciales.
• Distingue la creación de credenciales L1, los encabezados de solicitud L2 y la orden firmada por separado.
• Obtén instrucciones del proveedor sobre elegibilidad, almacenamiento seguro y revocación antes de crear cualquier credencial real.

Límites de la guía

Para esta guía no se firmó ningún mensaje, no se crearon, rotaron ni revocaron credenciales, no se envió ninguna solicitud autenticada ni se colocó ninguna orden. No se establecieron la elegibilidad de la cuenta ni un procedimiento de rotación. Un endpoint publicado no demuestra disponibilidad, latencia ni permiso de trading. Nunca envíes claves privadas, secretos, frases de contraseña ni firmas al directorio.