BINANCE SAPI · C2C

API de Mensajes de Chat con Paginación

Consulta registros históricos de chat paginados, conversaciones de texto y URLs de imágenes adjuntas intercambiadas entre contrapartes para una orden específica peer-to-peer (C2C/P2P).

ENDPOINT

GET /sapi/v1/c2c/chat/retrieveChatMessagesWithPagination

Autenticación USER_DATA / SIGNED

Grupo API C2C / Chat

Método GET

Respuesta JSON (Paginado)

Descripción General

Este endpoint permite a aplicaciones cliente, sistemas CRM de comerciantes y herramientas de auditoría de disputas recuperar el historial cronológico de mensajes en órdenes de Binance C2C (P2P). Admite parámetros de consulta en la URL como filtros por tipo de mensaje (chatMessageType: TEXT, IMAGE), límites de paginación (page, rows), seguimiento de cursor mediante identificador de mensaje (id) y opciones de ordenamiento.

Consolas automatizadas de atención al cliente y plataformas de resolución de controversias consultan este endpoint para renderizar hilos de conversación anteriores y auditar comprobantes de pago subidos durante la negociación.

Parámetros de la Solicitud

Parámetros aceptados en la URL (Query String) y encabezados HTTP.

Parámetro	Ubicación	Tipo	Requerido	Descripción
`clientType`	Header	STRING	Requerido	Tipo de dispositivo o cliente que realiza la consulta (por ejemplo, `WEB`, `APP` o `WEB_MOBILE`).
`page`	Query	INT32	Requerido	Número de página a consultar (comienza en `1`).
`rows`	Query	INT32	Requerido	Cantidad de registros de mensajes devueltos por página (recomendado: `20`, máximo: `100`).
`orderNo`	Query	STRING	Opcional	Identificador único de la orden C2C para filtrar los mensajes de chat.
`id`	Query	INT64	Opcional	Condición de cursor basada en ID de mensaje. Devuelve mensajes con ID menor al valor suministrado.
`chatMessageType`	Query	STRING	Opcional	Filtro por tipo de mensaje (por ejemplo, `TEXT`, `IMAGE` o `SYSTEM`).
`sort`	Query	STRING	Opcional	Dirección del ordenamiento: `asc` o `desc`.
`order`	Query	STRING	Opcional	Campo utilizado para ordenar los resultados (por ejemplo, `createTime` o `id`).
`x-gray-env`	Header	STRING	Opcional	Identificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing).
`x-trace-id`	Header	STRING	Opcional	Identificador de trazabilidad generado por el cliente para el seguimiento y depuración de la solicitud.
`x-user-id`	Header	STRING	Opcional	Identificador de usuario objetivo si se requiere evaluar el contexto de la cuenta.

Paginación Tradicional vs Basada en Cursor

Para interfaces de chat con desplazamiento continuo (infinite scroll), combinar page y rows con el parámetro de cursor id permite recorrer fluidamente hacia arriba los mensajes anteriores sin saltos ni duplicados.

Ejemplo de Solicitud

Ejemplo de solicitud GET mediante cURL para consultar los mensajes recientes de una orden.

cURL BASH

curl -X GET \
'https://api.binance.com/sapi/v1/c2c/chat/retrieveChatMessagesWithPagination?orderNo=202608171234567890&page=1&rows=20&sort=desc' \
-H 'clientType: WEB'

Respuesta

Ejemplo de respuesta paginada devuelta tras una consulta exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "total": 12,
        "page": 1,
        "rows": 20,
        "data": [
            {
                "id": 1059483721,
                "orderNo": "202608171234567890",
                "senderUserId": 123456789,
                "senderNickName": "MerchantAlpha",
                "chatMessageType": "TEXT",
                "content": "Pago enviado. Por favor revisa tu cuenta bancaria y libera.",
                "createTime": 1786953600000,
                "status": 1
            },
            {
                "id": 1059483720,
                "orderNo": "202608171234567890",
                "senderUserId": 123456789,
                "senderNickName": "MerchantAlpha",
                "chatMessageType": "IMAGE",
                "content": "https://binance-c2c.s3.amazonaws.com/chat/2026/08/17/img_receipt.jpg",
                "createTime": 1786953580000,
                "status": 1
            }
        ]
    },
    "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.total`	INT	Cantidad total de mensajes de chat disponibles en este hilo de conversación.
`data.page`	INT	Índice de la página actual devuelta.
`data.rows`	INT	Número de registros devueltos por página.
`data.data`	ARRAY	Arreglo de objetos con los registros individuales de mensajes de chat.
`data.data[].id`	INT64	Identificador único del mensaje de chat.
`data.data[].orderNo`	STRING	Número de orden C2C asociado al mensaje.
`data.data[].senderUserId`	INT64	Identificador de usuario del emisor del mensaje.
`data.data[].senderNickName`	STRING	Apodo público visible del emisor del mensaje.
`data.data[].chatMessageType`	STRING	Formato del mensaje (por ejemplo, `TEXT`, `IMAGE` o `SYSTEM`).
`data.data[].content`	STRING	Cuerpo del mensaje en texto plano o URL del recurso multimedia adjunto.
`data.data[].createTime`	LONG	Marca de tiempo en milisegundos Unix en que fue enviado el mensaje.
`data.data[].status`	INT	Estado de entrega o procesamiento del mensaje.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para consultar y visualizar el historial de conversaciones de chat.

01 Fijar Parámetros Indica orderNo, page=1 y rows=20 en la query string de la URL.

02 Enviar Solicitud Llama vía GET a /retrieveChatMessagesWithPagination.

03 Renderizar Mensajes Despliega el diálogo de texto e incrusta imágenes en la interfaz.

04 Paginar o Escuchar Carga páginas anteriores al subir o escucha el WebSocket para nuevos mensajes.

Casos de Uso Comunes

Carga de Conversaciones en Paneles de Usuario

Carga diálogos completos de mensajes cuando un operador o comerciante abre una orden P2P activa o archivada en su terminal.

Evidencia en Disputas y Apelaciones

Extrae transcripciones certificadas de la conversación y URLs de comprobantes de pago para adjuntar como prueba en mediaciones formales.

Archivado Contable y Auditoría CRM

Almacena automáticamente todas las comunicaciones entre comprador y vendedor en bases de datos internas para cumplimiento normativo.