BINANCE SAPI · C2C

API para Marcar Mensajes como Leídos por Usuario

Confirma la lectura de todos los mensajes de chat peer-to-peer (C2C/P2P) no leídos y limpia las notificaciones globales en todas las órdenes activas de la cuenta autenticada.

ENDPOINT

POST /sapi/v1/c2c/chat/markUserMessagesAsRead

Autenticación USER_DATA / SIGNED

Grupo API C2C / Chat

Método POST

Respuesta JSON

Descripción General

A diferencia de la confirmación de lectura por orden individual, este endpoint actúa de forma global sobre todo el portafolio comercial peer-to-peer (P2P) del usuario. Al ejecutar esta llamada, se marcan como leídos de manera instantánea todos los mensajes entrantes en todas las órdenes activas e históricas de la cuenta.

Mesas de ayuda para comerciantes, paneles de soporte masivo y consolas de trading automatizado emplean este endpoint para implementar la acción "Marcar todo como leído" y restablecer los contadores generales de mensajes no leídos mediante una única solicitud.

Parámetros de la Solicitud

Parámetros de encabezado (Header) aceptados por el endpoint.

Encabezado	Tipo	Requerido	Descripción
`clientType`	STRING	Requerido	Tipo de dispositivo o cliente que realiza la consulta (por ejemplo, `WEB`, `APP` o `WEB_MOBILE`).
`x-gray-env`	STRING	Opcional	Identificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing).
`x-trace-id`	STRING	Opcional	Identificador de trazabilidad generado por el cliente para el seguimiento y depuración de la solicitud.
`x-user-id`	STRING	Opcional	Identificador de usuario objetivo si se requiere evaluar el contexto de la cuenta.

Alcance Global de la Confirmación

Esta solicitud no requiere cuerpo JSON (Body). Reconoce automáticamente el contexto del usuario autenticado y reinicia las alertas de mensajes no leídos en todos los hilos de conversación de órdenes P2P de forma simultánea.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para limpiar globalmente todos los mensajes no leídos.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/chat/markUserMessagesAsRead' \
-H 'clientType: WEB'

Respuesta

Ejemplo de respuesta devuelta tras la actualización global exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": null,
    "success": true
}

Campos de la Respuesta

Campo	Tipo	Descripción
`code`	STRING	Código de respuesta estándar de Binance (`"000000"` indica éxito).
`message`	STRING	Mensaje descriptivo del resultado o confirmación de la petición.
`data`	NULL / VOID	Carga útil vacía devuelta tras completar con éxito la confirmación de lectura global.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para sincronizar el estado global de lectura de mensajes de chat.

01 Disparar Evento El operador pulsa "Marcar todo como leído" o inicia su sesión.

02 Enviar Solicitud Llama a /sapi/v1/c2c/chat/markUserMessagesAsRead vía POST.

03 Reinicio Global El servidor marca como leídos todos los mensajes de chat pendientes.

04 Actualizar Interfaz Las alertas y contadores globales en la UI se restablecen a 0.

Casos de Uso Comunes

Acción "Marcar Todo como Leído"

Alimenta el botón de lote general en barras laterales de mensajería para descartar notificaciones atrasadas de múltiples órdenes con un solo clic.

Inicio de Turno Operativo

Limpia indicadores pendientes obsoletos cuando los operadores inician turno en mesas de dinero P2P de alto volumen transaccional.

Gestión de Notificaciones en Bots

Previene la saturación visual de alertas en cuentas automatizadas que procesan cientos de microórdenes de alta frecuencia por día.