Heartbeat - 4casters API

El heartbeat mantiene viva tu sesión. Envía un heartbeat con un requestTimeout (en segundos): si el servidor no recibe otro heartbeat antes de que expire ese tiempo, todas tus órdenes abiertas se cancelan automáticamente. Normalmente envías heartbeats en un intervalo recurrente (p. ej. cada 5 s con un timeout de 10 s) durante toda la vida de la conexión.

Solicitud

[
  "heartbeat",
  {
    "requestID": "YOUR_REQUEST_ID",
    "requestTimeout": 10
  }
]

string

Un identificador generado por el cliente; se devuelve en la respuesta. Si se omite, el servidor genera uno.

number

requerido

Número de segundos que el servidor debe esperar el siguiente heartbeat antes de cancelar todas tus órdenes abiertas. Debe ser mayor que 0.

Respuesta

El servidor responde con un heartbeatAck que incluye el reloj del servidor y el timeout activo.

{
  "requestID": "YOUR_REQUEST_ID",
  "data": {
    "type": "heartbeatAck",
    "serverTime": "2026-04-22T15:30:00.123456789Z",
    "timeoutSec": 10
  }
}

string

Siempre heartbeatAck.

string

Hora actual del servidor en RFC 3339 con precisión de nanosegundos.

number

Eco del requestTimeout que enviaste.

Errores

Si requestTimeout falta o es <= 0, el servidor devuelve:

{
  "requestID": "YOUR_REQUEST_ID",
  "error": "Invalid heartbeat timeout"
}

​Solicitud

​Respuesta

​Errores

Solicitud

Respuesta

Errores