Obtén URLs de conexión WebSocket en tiempo real, tokens de autenticación y listenKeys de sesión para establecer flujos de chat bidireccionales en órdenes peer-to-peer (C2C/P2P).
/sapi/v1/c2c/chat/retrieveChatCredentialEste endpoint suministra credenciales dinámicas de conexión para el servicio WebSocket de chat en tiempo real en Binance C2C (P2P). Devuelve la dirección URI segura de destino (wssUrl), credenciales temporales de autenticación (token) y la clave de transmisión de sesión del usuario (listenKey).
Bots automatizados de atención al cliente, servicios de notificaciones instantáneas y terminales de trading en vivo consultan este endpoint antes de iniciar el socket WebSocket para recibir y emitir mensajes de chat entre comprador y vendedor con latencias de submilisegundos.
01
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. |
Configuración de Conexión WebSocket
Utiliza la dirección devuelta en wssUrl junto con el token / listenKey autorizados para abrir flujos de socket persistentes. Reconecta y renueva las credenciales periódicamente o al recibir tramas de cierre de conexión.
02
Ejemplo de solicitud GET mediante cURL para obtener las credenciales de chat en tiempo real.
curl -X GET \
'https://api.binance.com/sapi/v1/c2c/chat/retrieveChatCredential' \
-H 'clientType: WEB'03
Ejemplo de respuesta devuelta tras la consulta exitosa de credenciales.
{
"code": "000000",
"message": "success",
"data": {
"wssUrl": "wss://c2c-chat-ws.binance.com/ws",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"listenKey": "d34db33f987654321abcdef123456789",
"expireTime": 1786957200000
},
"success": true
}| 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.wssUrl | STRING | Dirección del host WebSocket de destino para iniciar conexiones de socket de chat en vivo. |
data.token | STRING | Token portador de autenticación (Bearer token) enviado en el protocolo de enlace (handshake) del WebSocket. |
data.listenKey | STRING | Identificador único de sesión (listenKey) que representa el flujo autenticado del usuario. |
data.expireTime | LONG | Marca de tiempo en milisegundos Unix que indica el vencimiento de validez de las credenciales. |
success | BOOLEAN | Indica el resultado general de la ejecución de la petición. |
04
Flujo de trabajo para inicializar la transmisión en tiempo real de chat C2C vía WebSocket.
wssUrl devuelta.Chatbots de Atención en Tiempo Real
Conecta agentes conversacionales automatizados para atender consultas de pago de compradores inmediatamente sin retrasos por sondeo continuo (polling).
Notificaciones Push Instantáneas
Escucha los mensajes del chat en tiempo real para disparar alertas inmediatas hacia Telegram, Discord o SMS cuando la contraparte escribe.
Widgets de Chat en Paneles de Operador
Incrusta consolas de chat bidireccionales de alto rendimiento directamente dentro de interfaces de usuario para operadores de mesas de cambio.