Los datos de mercado de Polymarket incluyen varios tipos de registros que no deben tratarse como una única fuente intercambiable de precios. Un libro de órdenes describe ofertas observadas para negociar. Un registro de operación describe una ejecución conforme a la semántica de su fuente. Los metadatos identifican el contrato y sus restricciones. Un gráfico derivado resume observaciones seleccionadas. Cada uno responde a una pregunta diferente.
Un uso fiable comienza conservando esos significados y los tiempos asociados con ellos. Un lector necesita saber a qué resultado se refiere un valor, qué cantidad cubre y si la observación es lo bastante actual para la tarea prevista. Un decimal preciso todavía puede ser inutilizable cuando su fuente o sus tiempos son inciertos.
Esta guía se refiere al contexto de datos de Polymarket International. Polymarket US tiene interfaces y sistemas de cuentas separados. Todos los libros, marcas de tiempo y cálculos siguientes son hipotéticos. Ilustran la gestión de datos en lugar de afirmar que un precio cotizado está disponible actualmente o que un conjunto de datos demuestra una ventaja de negociación.
Comienza los datos de mercado de Polymarket con una identidad estable
Un registro de datos de mercado debe conectar sus identificadores con un contrato y un resultado legibles para una persona. Un precio sin esa correspondencia puede vincularse al evento, lado o plazo equivocados. Los títulos similares hacen esto especialmente importante cuando varios contratos se refieren al mismo tema general.
Conserva el identificador del mercado, el del token de resultado y la versión relevante de los metadatos. No dependas de un símbolo o una posición en pantalla que puedan ser ambiguos fuera de la interfaz original. El consumidor de datos debe poder verificar qué instrumento describe un libro o registro de operación.
La guía anterior de la API de trading de Polymarket separa las interfaces de descubrimiento, negociación y cuenta. Esa estructura también es útil para el diseño de datos. El descubrimiento establece el significado, el libro describe las condiciones observadas de negociación y los registros privados de la cuenta establecen los efectos propios del usuario. Combinarlos requiere uniones explícitas en lugar de supuestos basados en nombres similares.
Distingue un libro de una operación
Un libro de órdenes muestra cantidades disponibles a precios cotizados en un momento observado, sujetas a cambios posteriores. Una operación muestra que ocurrió una ejecución según el registro de origen. Que desaparezca una cotización no demuestra por sí solo que una operación la consumiera; la cancelación o sustitución también pueden cambiar el libro.
Supongamos que un nivel inventado de venta baja de treinta y dos participaciones a doce. La reducción de veinte participaciones es una observación del libro. Sin pruebas adicionales, el analista no debe etiquetarla como veinte participaciones compradas por un participante informado. El cambio podría reflejar varias acciones de órdenes diferentes.
La documentación de datos en tiempo real de Polymarket proporciona tipos de eventos de mercado separados. Un consumidor debe conservar sus funciones documentadas en lugar de convertir cada actualización de precio o tamaño en una operación. Esta distinción importa para los cálculos de volumen, la investigación de señales y cualquier intento de deducir el comportamiento de los participantes.
Conserva la instantánea del libro de Polymarket
Una instantánea del libro de Polymarket debe conservar ambos lados, las cantidades, la identidad del token, la hora de origen cuando se suministre y la hora local de recepción. Las restricciones relevantes, como el tamaño del incremento de precio, deben asociarse a su versión actual. La instantánea es un registro del estado observado, no una promesa sobre una orden posterior.
Guarda suficiente información en bruto para reproducir los mejores precios derivados y los cálculos de profundidad. Un conjunto de datos que solo contiene el punto medio no puede revelar después cuánto estaba disponible en la oferta de venta o si un lado estaba vacío. Elige qué conservar según las preguntas futuras que los datos deban respaldar.
La guía anterior del extractor del libro de órdenes de Polymarket explica la recopilación fiable. Un lector que utilice una exportación de terceros puede aplicar el mismo criterio preguntando qué partes del libro original se conservaron y cuáles se descartaron. La profundidad ausente no puede recrearse a partir de un gráfico de líneas solo mediante cálculos.
Aplica las actualizaciones según su significado
Las actualizaciones incrementales deben interpretarse utilizando la especificación vigente de la fuente. Un campo de tamaño puede describir una cantidad nueva del nivel en lugar de un importe que se deba añadir, y los distintos tipos de eventos pueden tener semánticas diferentes. El consumidor no debe deducir el comportamiento solo por el nombre de un campo.
Mantén explícita la relación entre la instantánea y las actualizaciones. Si el proceso no puede establecer que su estado actual incluye las actualizaciones necesarias, marca el libro reconstruido como incierto y recupéralo mediante el método documentado. No supongas una garantía de secuencia ni un comportamiento de suma de comprobación salvo que la fuente realmente los proporcione y defina.
Prueba la lógica de actualización con ejemplos conocidos, incluida la eliminación de un nivel, los mensajes repetidos y las restricciones modificadas. El resultado esperado debe ser un estado concreto del libro. Un analizador que lee correctamente cada mensaje todavía puede reconstruir el libro equivocado si aplica los valores con un significado incorrecto.
Trata los huecos como huecos
Un flujo desconectado crea un intervalo de cobertura incierta. Volver a conectar no restaura automáticamente el historial que falta. El proceso debe obtener un estado actual válido y distinguir ese estado recuperado de cualquier hueco histórico sin resolver.
Un registro de actualidad de cotizaciones puede identificar cuándo volvió el libro a ser fiable, qué fuentes se utilizaron y si el periodo intermedio está completo. Esa información permite a las herramientas posteriores decidir si los datos son adecuados para una estimación actual de costes, una simulación histórica o únicamente un gráfico descriptivo.
No interpoles un hueco y trates después la trayectoria inventada como liquidez observada. La interpolación puede ser una técnica de visualización claramente etiquetada, pero no puede demostrar qué cantidad estaba disponible para ejecutar durante el intervalo ausente. La investigación que depende de esos momentos debe conservar la limitación o excluirlos conforme a una regla documentada.
Audita el significado de cada marca de tiempo
Una auditoría de marcas de tiempo de datos de mercado debe identificar si una hora se refiere a la creación del evento, el procesamiento en origen, la publicación, la recepción local o el almacenamiento. Pueden diferir. Un único campo llamado timestamp no basta para establecer cuándo podía utilizar la observación un proceso de negociación.
En un registro inventado, la hora de origen es 10:00:00.100, la recepción local es 10:00:00.350 y el almacenamiento persistente es 10:00:00.380. Si los relojes son comparables, el intervalo entre origen y recepción es de 250 milisegundos y el de recepción a almacenamiento es de 30 milisegundos. El total es de 280 milisegundos.
El primer intervalo no es necesariamente latencia pura de red; puede incluir procesamiento previo y serialización. Si la alineación de los relojes es incierta, indica esa limitación en lugar de informar de un retraso exacto de transmisión. La hora local de recepción sigue aportando pruebas útiles de cuándo este proceso concreto tuvo por primera vez el mensaje.
Conserva las unidades y los tiempos ausentes
Las unidades de las marcas de tiempo deben ser explícitas. En las API pueden aparecer segundos y milisegundos, y un analizador que suponga una convención puede situar las observaciones lejos de su hora real. Conserva el valor en bruto, el valor interpretado y la definición del campo de origen cuando sea práctico.
Una marca de tiempo de origen ausente debe seguir ausente. Sustituirla por cero o por la hora local actual crea una afirmación falsa sobre el registro. El consumidor puede utilizar una hora de recepción separada para una finalidad adecuada sin fingir que procede de la fuente.
El mismo principio se aplica a las unidades de precio y tamaño. Un precio por participación, un número de participaciones y un valor total de transacción son cantidades distintas aunque se representen como cadenas decimales. Los tipos y las etiquetas claros impiden que un número técnicamente válido adquiera un significado económico equivocado en las fases posteriores.
Ordena los registros sin inventar causalidad
Que dos mensajes lleguen en un orden no demuestra necesariamente que los eventos subyacentes ocurrieran en ese orden. Las distintas vías, los búferes y la precisión del reloj pueden afectar a la llegada. Un consumidor debe seguir la información documentada de ordenación y conservar la incertidumbre cuando la fuente no establezca una secuencia total.
Si una operación y una actualización de cotización comparten una marca de tiempo de poca precisión, evita afirmar que una causó la otra solo por su orden en pantalla. Los datos pueden respaldar una asociación sin identificar la secuencia precisa. Esta limitación importa en la investigación sobre la respuesta inmediata del precio o el comportamiento de los participantes.
La guía de datos de Polymarket analiza la construcción de conjuntos de datos de investigación. Conserva el orden original de llegada y los campos de origen para que el análisis posterior pueda elegir un método adecuado de ordenación. Un conjunto de datos depurado no debe fabricar silenciosamente una precisión causal que los registros originales nunca contuvieron.
Deriva los mejores precios de forma transparente
La mejor oferta de compra es la oferta observada más alta con cantidad disponible válida, y la mejor oferta de venta es la observada más baja con cantidad disponible válida. Un punto medio derivado requiere ambos lados y una convención claramente indicada. Un lado vacío no debe convertirse en una cotización sintética de precio cero.
Para una oferta de compra inventada de $0.25 y una de venta de $0.27, el diferencial es $0.02 y el punto medio es $0.26. Esos cálculos son sencillos, pero siguen dependiendo de un libro válido y actual. Si un lado está antiguo, el resultado ordenado puede representar mal el mercado.
La explicación de precios y libro de órdenes de Polymarket distingue los valores mostrados de las cotizaciones ejecutables. Un producto de datos debe documentar su propia convención de resumen y evitar suponer que todos los gráficos de plataformas utilizan la misma medida en todo momento. Las comparaciones requieren definiciones compatibles además de tiempos coincidentes.
Recomienda y gana USDC
Recomienda y gana USDCNuestro programa de afiliados paga en tiempo real.
Calcula la profundidad para una cantidad definida
Un cálculo de profundidad debe recorrer el lado relevante del libro observado y mostrar el coste para una cantidad especificada. Debe detenerse cuando la profundidad sea insuficiente en lugar de inventar una continuación más allá de los niveles disponibles. El resultado es una estimación fechada, no una ejecución garantizada.
Supongamos que se ofrecen treinta y dos participaciones a $0.27 y dieciocho a $0.30. Comprar cincuenta costaría $8.64 más $5.40, es decir, $14.04 antes de comisiones. El promedio es $0.2808. Una herramienta que multiplique las cincuenta por la mejor oferta de venta informaría de solo $13.50 y subestimaría este coste observado en $0.54.
Conserva los niveles utilizados en el cálculo y cualquier supuesto de comisiones añadido después. Si cambia la cantidad prevista, recalcula en lugar de ampliar el promedio anterior a una profundidad desconocida. El libro disponible forma parte de las pruebas que respaldan el cálculo, no es simplemente una fuente de un precio cómodo.
Mantén reproducibles los resúmenes de operaciones
Un resumen de operaciones debe identificar sus reglas de inclusión, ventana temporal y método de ponderación. Un promedio sencillo de precios de operaciones difiere de un promedio ponderado por cantidad. Una medida de última operación difiere de ambos. Estas distinciones pueden cambiar un análisis aunque todos utilicen los mismos registros subyacentes.
En una muestra inventada, se negocian cinco participaciones a $0.20 y quince a $0.30. El valor total es $1 más $4.50, es decir, $5.50, entre veinte participaciones. El promedio ponderado por cantidad es $0.275. El promedio no ponderado de los dos precios es $0.25 y responde a una pregunta diferente.
La guía anterior de analítica de mercados de predicción explica cómo interpretar esas medidas. Un producto de datos fiable debe conservar suficiente detalle para que otro lector reproduzca el resumen y comprenda si se incluyeron registros duplicados, corregidos o incompletos. Una etiqueta de gráfico por sí sola no puede establecer esas elecciones.
No sustituyas las ejecuciones de la cuenta por operaciones públicas
La actividad pública del mercado y los registros privados de ejecución de una cuenta tienen funciones diferentes. Una operación pública cerca de la hora de una solicitud no demuestra que la cuenta recibiera esa ejecución. La cuenta necesita pruebas oficiales de órdenes y operaciones asociadas a su propia acción autorizada.
Por tanto, un recopilador de datos de mercado debe evitar escribir observaciones públicas directamente en un registro privado de posiciones. Puede aportar contexto para el análisis de ejecución, pero la unión debe basarse en identificadores fiables y relaciones documentadas, no en una coincidencia temporal.
Esta separación también protege la investigación. Una cuenta puede tener una ejecución parcial, un resto cancelado o un envío sin resolver que sea invisible en una serie pública de precios. La vista de datos de mercado no debe afirmar que la cuenta no tiene exposición o está totalmente invertida solo porque se haya observado o no un evento público concreto.
Registra las restricciones del mercado como datos
El tamaño del incremento de precio, la cantidad mínima y otras restricciones del mercado pueden afectar a la construcción válida de órdenes. Deben tratarse como metadatos variables en el tiempo donde la plataforma admita cambios, no como constantes permanentes copiadas de un ejemplo inicial. El registro de datos necesita mostrar qué restricciones se conocían en un momento de decisión.
La guía de precios y libros de órdenes de Polymarket proporciona la referencia actual para la interfaz de datos relevante. Un cliente debe verificar la interfaz instalada y conservar la versión de la fuente utilizada para su interpretación. La documentación y la salida del SDK pueden evolucionar juntas o en momentos distintos.
Para las simulaciones históricas, aplicar las restricciones de hoy a todas las observaciones pasadas puede representar mal lo que era válido entonces. Si no se dispone de datos históricos de restricciones, indica la limitación. Una prueba histórica no debe afirmar un comportamiento ejecutable exacto cuando carece de las reglas de mercado necesarias para construir la orden en ese momento.
Define la actualidad según la tarea del consumidor
Un libro adecuado para un gráfico histórico general puede ser demasiado antiguo para una propuesta de orden. Un registro de metadatos puede seguir siendo útil hasta que cambie una regla o restricción. Un documento de fuente puede ser relevante para la investigación mucho después de que haya caducado una cotización basada en él.
Define los requisitos de actualidad en la tarea consumidora en lugar de asignar un único tiempo de vida universal a todos los registros. La capa de datos debe exponer la antigüedad y la calidad de la observación para que el proceso de decisión aplique su propia regla documentada. No debe renovar silenciosamente las marcas de tiempo para hacer que valores antiguos parezcan utilizables.
La guía de una estrategia de Kalshi muestra por qué una rutina repetible de investigación necesita un horizonte definido. El mismo principio se aplica a la selección de datos entre plataformas: utiliza registros adecuados para la pregunta y el momento de decisión, conservando los identificadores, las unidades y la semántica de cuenta propios de la plataforma.
Distingue los datos sin actividad de una recopilación averiada
Un periodo sin operaciones observadas puede ser un mercado tranquilo, una suscripción incompleta o un recopilador que ha fallado. El producto de datos debe conservar pruebas operativas que ayuden a distinguir estas explicaciones. El funcionamiento de la conexión por sí solo no siempre basta para demostrar la cobertura de cada token suscrito.
Supervisa las suscripciones esperadas, los mensajes válidos recientes y las actualizaciones satisfactorias del estado según el comportamiento documentado de la fuente. Si la cobertura se vuelve incierta, expón ese estado a las herramientas posteriores. Un último valor sin cambios no debe servir simultáneamente como observación del mercado y como prueba de que la recopilación funciona bien.
Revisa los huecos por instrumento y tipo de datos. El libro puede estar actualizado mientras la recuperación del historial de operaciones está incompleta, o los metadatos pueden estar disponibles mientras se interrumpe un flujo. Los registros de calidad específicos de cada capacidad son más útiles que un solo indicador verde que oculta qué pruebas puede confiar realmente el consumidor.
Compara datos entre plataformas sin borrar el significado
Un modelo común de datos puede respaldar el análisis entre plataformas, pero la normalización debe conservar los campos y las convenciones originales. Un precio expresado como porcentaje no establece que dos contratos tengan fuentes, plazos o pagos equivalentes. La correspondencia entre instrumentos sigue siendo una tarea de investigación separada.
La guía de datos de mercado de Kalshi proporciona una comparación de los registros de libros, operaciones y ciclo de vida de otra plataforma. Utiliza esa comparación para identificar qué conceptos se transfieren y cuáles requieren un adaptador específico de plataforma. No copies la transformación de lado o precio de una interfaz a otra sin verificarla.
Un registro normalizado debe conservar la identidad de la plataforma, el endpoint o flujo de origen, la versión del esquema y el historial de transformaciones. Esto permite a un revisor investigar discrepancias aparentes antes de interpretarlas como una oportunidad económica. Una buena normalización hace las diferencias lo bastante explícitas para compararlas, en lugar de ocultarlas detrás de nombres de columnas idénticos.
Prueba los datos con secuencias conocidas
Crea secuencias pequeñas e inventadas cuyo resultado correcto sea fácil de calcular. Comienza con un libro, sustituye la cantidad de un nivel, elimina un nivel, repite una actualización e introduce un hueco. Verifica que el estado reconstruido y los indicadores de calidad coincidan con el resultado esperado.
Añade pruebas de marcas de tiempo para valores ausentes, unidades diferentes y llegada retrasada. Añade pruebas de operaciones para observaciones repetidas y resúmenes ponderados por cantidad. Estos ejercicios deben verificar un comportamiento significativo en lugar de limitarse a confirmar que el analizador acepta la misma estructura para la que fue escrito.
Un resultado útil de aceptación indica qué garantías puede ofrecer la cadena de datos. Puede establecer un libro actual verificado y reconocer una cobertura histórica incompleta. Esa afirmación más limitada es más valiosa que una etiqueta general de tiempo real sin respaldo en el proceso de recopilación y recuperación.
Mantén los datos de mercado de Polymarket honestos sobre sus límites
Un registro fiable de datos de mercado identifica el instrumento, el tipo de observación, las unidades, los tiempos y la cobertura. Conserva suficientes pruebas en bruto para reproducir las medidas derivadas y marca los huecos o el orden incierto en lugar de suavizarlos hasta crear una precisión falsa.
Utiliza los libros para las condiciones observadas de negociación, las operaciones para las ejecuciones documentadas y los registros privados de la cuenta para las posiciones propias del usuario. Aplica la semántica actual del esquema y expón la actualidad a la tarea que consume los datos. Mantén visibles las limitaciones históricas al evaluar una estrategia.
El resultado son datos que respaldan preguntas cuidadosas en lugar de respuestas que no pueden justificar. Un lector puede estimar un coste, inspeccionar un cambio de precio o comparar un pronóstico comprendiendo qué se observó realmente. Esa claridad es la base de una analítica útil, interfaces fiables y cualquier flujo posterior autorizado de negociación.