Referencia de la API de Chat
6 endpoints para el chat P2P — mensajes, credenciales WebSocket, subida de imágenes y confirmación de lectura. El WebSocket requiere obtener credenciales temporales mediante EP-33 antes de abrir la conexión.
Flujo de Credenciales WebSocket
El chat en tiempo real de Binance C2C usa WebSocket autenticado. No puedes conectarte directamente con tu API key — primero debes obtener credenciales temporales firmadas con HMAC mediante retrieveChatCredential (EP-33), luego usar esas credenciales para autenticar la conexión WebSocket.
- 1
Obtener credencial
GET /sapi/v1/c2c/chat/retrieveChatCredential — retorna token temporal y WSS URL
- 2
Conectar WebSocket
Abrir conexión WSS usando la URL y token retornados en el paso anterior
- 3
Recibir mensajes
El servidor empuja mensajes en tiempo real mientras la sesión esté activa
- 4
Confirmar lectura
Llamar markOrderMessagesAsRead (EP-31) o markUserMessagesAsRead (EP-32) tras procesar
Subida de Imágenes — Flujo en Dos Pasos
Las imágenes en el chat no se envían directamente a la API de Binance. El flujo es:
Obtener pre-signed URL de S3 via fetch_image_upload_url()
PUT de la imagen directamente a S3 usando la URL pre-firmada
Endpoints
Get Chat Image Pre-Signed URL
/sapi/v1/c2c/chat/image/pre-signed-urlMark Order Messages As Read
/sapi/v1/c2c/chat/markOrderMessagesAsReadMark User Messages As Read
/sapi/v1/c2c/chat/markUserMessagesAsReadRetrieve Chat WSS Credential
/sapi/v1/c2c/chat/retrieveChatCredentialRetrieve Chat Messages
/sapi/v1/c2c/chat/retrieveChatMessagesWithPagination