Guía de Trading API de Mercados de Predicción

Resumen de APIs de Mercados de Predicción

Las APIs de mercados de predicción permiten acceso programático a datos de mercado y gestión de órdenes — las mismas capacidades disponibles a través de la interfaz web de cada plataforma, pero accesibles a sistemas de trading automatizado, dashboards personalizados, pipelines de datos y modelos cuantitativos.

Autenticación y Obtención de Claves API

Autenticación API de Kalshi

Kalshi utiliza autenticación de par de claves RSA. El proceso:

1. Genere un par de claves RSA. Use OpenSSL o cualquier biblioteca criptográfica estándar para generar un par de claves RSA de 4096 bits. Mantenga la clave privada segura — controla su cuenta de trading.
2. Suba su clave pública a Kalshi. En la configuración de su cuenta de Kalshi, navegue a la sección API y suba su clave pública. Kalshi asignará un ID de clave API asociado a este par de claves.
3. Firme las solicitudes con su clave privada. Cada solicitud API debe incluir una firma generada usando su clave privada. El SDK oficial de Python de Kalshi maneja la firma automáticamente.

Autenticación API de Polymarket

La API CLOB de Polymarket utiliza autenticación basada en billetera Ethereum:

1. Conecte una billetera. Genere o use una billetera Ethereum existente. La dirección de la billetera sirve como su identidad en la plataforma.
2. Cree credenciales API. Use la API de Polymarket para derivar credenciales API desde la firma de su billetera.
3. Firme órdenes on-chain. La colocación de órdenes requiere firmas criptográficas que autorizan al contrato inteligente a ejecutar operaciones en su nombre.

Endpoints de Datos de Mercado

Ambas APIs proporcionan acceso completo a datos de mercado. Los endpoints principales:

• Lista de mercados. Enumerar todos los mercados disponibles con sus especificaciones de contrato, estado (abierto/cerrado/liquidado) y metadatos. Filtrable por categoría, estado y tipo de evento.
• Libro de órdenes. El estado actual del libro de órdenes para un mercado específico — todas las órdenes de compra y venta pendientes, organizadas por nivel de precio.
• Operaciones. Datos históricos de operaciones — cada operación ejecutada con marca de tiempo, precio, cantidad y lado (compra/venta). Esencial para backtesting y análisis de volumen.
• Resumen de mercado / ticker. Estadísticas agregadas del mercado: último precio de operación, volumen de 24 horas, interés abierto, precios altos/bajos.

Para datos en tiempo real, ambas plataformas ofrecen feeds WebSocket que envían actualizaciones del libro de órdenes y operaciones a medida que ocurren, sin la latencia y sobrecarga de límites de tasa de consultar endpoints REST. Cualquier sistema de trading automatizado serio debe usar feeds WebSocket para datos de mercado.

Colocación de Órdenes

Ambas APIs soportan tipos de orden estándar:

• Órdenes límite. Especifique un precio y cantidad. La orden descansa en el libro hasta que se ejecuta por una orden coincidente, usted la cancela o el mercado cierra. Las órdenes límite son órdenes maker y típicamente incurren en comisiones más bajas.
• Órdenes de mercado. Se ejecutan inmediatamente al mejor precio disponible. Las órdenes de mercado son órdenes taker e incurren en comisiones más altas. En mercados con poca liquidez, las órdenes de mercado grandes pueden experimentar deslizamiento.

Parámetros clave para colocación de órdenes en Kalshi:

• ticker — el identificador del mercado (p.ej., "FED-26JUN-T4.50")
• side — "yes" o "no"
• action — "buy" o "sell"
• type — "limit" o "market"
• count — número de contratos
• yes_price o no_price — precio en centavos (1–99 para órdenes límite)

Restricciones importantes: las órdenes no pueden exceder su saldo disponible (no hay trading con margen en mercados de predicción). Kalshi aplica un tamaño máximo de posición por mercado, que varía por contrato.

Gestión de Posiciones y Consultas de Cartera

Gestionar posiciones abiertas programáticamente es esencial para el trading automatizado:

• Posiciones abiertas. Consulte todas sus posiciones actuales en todos los mercados — contrato, lado, cantidad, precio promedio de entrada, precio de mercado actual y P&L no realizado.
• Estado de órdenes. Verifique el estado de órdenes enviadas — pendiente, parcialmente ejecutada, completamente ejecutada o cancelada.
• Saldo y liquidación. Consulte saldo de cuenta, liquidaciones pendientes y disponibilidad de retiro.
• Historial de operaciones. Descargue su historial completo de operaciones para backtesting, análisis de rendimiento y declaración fiscal.

Construyendo un Bot Simple: Monitoreo de Probabilidades del Mercado de IPC

Un punto de partida práctico para el trading API es un bot de monitoreo — un sistema que lee datos de mercado y le alerta sobre cambios significativos, sin colocar operaciones automáticamente:

Este bot de monitoreo no requiere acceso a la API de colocación de órdenes — solo lecturas de datos de mercado. Es una forma de bajo riesgo para familiarizarse con la API y desarrollar la infraestructura para estrategias automatizadas más sofisticadas posteriormente.

Límites de Tasa y Mejores Prácticas

Ambas APIs aplican límites de tasa para prevenir abuso y asegurar la estabilidad de la plataforma:

• API REST de Kalshi: Aproximadamente 10 solicitudes por segundo para endpoints de datos de mercado. Los endpoints de colocación de órdenes pueden tener límites más estrictos. Exceder los límites retorna un código de estado 429.
• WebSocket de Kalshi: Soporta múltiples suscripciones de mercado por conexión. Los mensajes de heartbeat mantienen la conexión. La lógica de reconexión es esencial.
• Mejores prácticas generales:
  • Cachear metadatos de mercado localmente y refrescar infrecuentemente (una vez por hora o menos).
  • Usar feeds WebSocket para datos en tiempo real en lugar de consultar endpoints REST.
  • Agrupar operaciones donde sea posible.
  • Implementar circuit breakers que detengan el trading si las tasas de error exceden un umbral.
  • Registrar todas las solicitudes y respuestas API para depuración y auditoría.

Gestión de Riesgo para Trading Automatizado

Los sistemas de trading automatizado requieren gestión de riesgo rigurosa. Los mercados de predicción tienen características de riesgo únicas:

• Riesgo de resultado binario. Cada posición en el mercado de predicción se resuelve en $1 o $0. No hay pérdida parcial. El dimensionamiento de posiciones debe tener en cuenta esta estructura de pago binaria.
• Concentración de riesgo de eventos. Muchos mercados de predicción se resuelven en la misma fecha. Si tiene posiciones en múltiples contratos del mismo evento, su riesgo está concentrado en un solo momento.
• Límites de pérdida máxima. Defina un límite de pérdida diario y semanal máximo antes de comenzar el trading automatizado. Implemente paradas duras en su código que detengan toda actividad de trading si se alcanza el límite.
• Límites de tamaño de posición. Nunca arriesgue más de un pequeño porcentaje de su capital total en un solo contrato. Una regla común: no más del 2-5% del capital de trading en un solo resultado binario.
• Manejo de fallos de API. Su sistema debe manejar interrupciones de API, fallos de red y respuestas inesperadas de manera elegante.

Implicaciones Fiscales del Trading de Alta Frecuencia

El trading automatizado genera un alto volumen de eventos tributables. Consideraciones clave:

• Declaración 1099 de Kalshi. Kalshi emite formularios 1099 para contribuyentes de EE.UU. Cada liquidación de contrato es un evento tributable. Mantenga registros detallados de operaciones desde la API.
• Potencial Sección 1256. Los contratos regulados por la CFTC (Kalshi) pueden calificar para tratamiento de la Sección 1256 — 60% ganancias de capital a largo plazo / 40% a corto plazo, independientemente del período de tenencia. Consulte a un profesional fiscal.
• Consideraciones de wash sale. Si opera el mismo contrato frecuentemente, las reglas de wash sale pueden aplicar, rechazando ciertas pérdidas.
• Complejidad fiscal de Polymarket. Operar en Polymarket implica USDC (una criptomoneda), que puede activar eventos separados de ganancias de capital sobre el activo cripto subyacente además de las ganancias o pérdidas en los contratos del mercado de predicción.