Skip to main content
4casters expone tres APIs que comparten el mismo token de autenticación y el mismo motor subyacente de cuenta / libro de órdenes / liquidación. Elige la que corresponda a lo que estás construyendo, o combínalas: la mayoría de las integraciones usan REST para configuración e historial y un WebSocket para trading en vivo.

​
Elige tu API

API REST

Solicitud / respuesta por HTTPS. Úsala para inicio de sesión, estado de la cuenta, historial, consultas de mercado y colocación / edición / cancelación por lotes.

WebSocket de órdenes

Canal persistente de baja latencia para colocar y cancelar órdenes. Úsalo cuando te importe la latencia de ida y vuelta.

WebSocket de streaming

Feeds push de ticks del libro de órdenes y de cruces / liquidaciones por cuenta. Úsalo para mantener el estado sincronizado sin polling.

​
Cuándo usar cada una

​
Autenticación

No hay claves de API. Te autenticas con el mismo nombre de usuario y contraseña con los que inicias sesión en 4casters.io, y las tres APIs comparten el único token que devuelve el inicio de sesión. Las claves de API están planificadas; consulta Autenticación para conocer el estado actual.
  1. Llama a POST /user/login en la API REST con tu nombre de usuario y contraseña.
  2. Envía el token devuelto en cada solicitud posterior:
    • REST: encabezado Authorization: Bearer <token>.
    • WebSockets: encabezado Authorization: <token> en el handshake.
Los tokens son válidos durante 30 días y después se rotan automáticamente. Consulta Autenticación para la vida útil del token, el manejo de errores y las recomendaciones sobre credenciales, y la referencia de inicio de sesión REST para la forma completa de la respuesta.

​
Convenciones

  • Transporte: solo HTTPS / WSS.
  • Codificación: JSON en todas partes.
  • Envoltorio de respuesta (REST): { "data": <payload> } en éxito; { "error": "<message>" } en errores HTTP.
  • Identificadores: los ids de juego, de participante y de orden son cadenas ObjectID de MongoDB (hex de 24 caracteres).
  • Cuotas: formato americano (negativas para favoritos, positivas para no favoritos) salvo que se indique lo contrario.
  • Tiempo: ISO 8601 con Z (UTC).

​
Una integración típica

La mayoría de los clientes no triviales combinan las tres:
  1. REST — POST /user/login una vez, guarda el token en caché y luego llama a GET /user/getMe y GET /games/v2/leagues para inicializar el estado.
  2. WebSocket de streaming — abre el feed de precios de los mercados que te importan y el feed de usuario para reaccionar a tus propios cruces / liquidaciones.
  3. WebSocket de órdenes — abre una conexión persistente y coloca / cancela órdenes con baja latencia, correlacionando las respuestas por requestID.
  4. REST — recurre a POST /myBets/getMatchedBets, /myBets/getOrdersForGame, etc. para historial y conciliación.

​
¿Necesitas la documentación anterior?

La documentación previa vivía como una colección de Postman. Se conserva como referencia, pero estas docs de Mintlify son ahora la fuente de verdad: la colección de Postman puede quedar atrás en endpoints, parámetros o formas de respuesta nuevos.

4Casters API — colección de Postman

Ver la documentación heredada de Postman