BINANCE SAPI · C2C

API para Conectar Comerciante

Cambia la presencia operativa del comerciante al modo en línea (online), indicando disponibilidad activa para procesar órdenes en los listados peer-to-peer (C2C/P2P).

ENDPOINT

POST /sapi/v1/c2c/merchant/getOnline

Autenticación USER_DATA / SIGNED

Grupo API C2C / Merchant

Método POST

Respuesta JSON

Descripción General

Este endpoint actualiza el estado de presencia de un comerciante a en línea (online) en el mercado Binance C2C (P2P). Activar la presencia en línea muestra un indicador activo junto al perfil comercial, lo que brinda confianza a las contrapartes de que sus intercambios recibirán atención inmediata y una liberación expedita de los fondos.

Sistemas de trading algorítmico, bots automatizados y terminales de escritorio ejecutan este endpoint durante el arranque inicial de sus servicios, al iniciar turnos laborales o al restablecer la conexión tras desconexiones imprevistas de red.

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 evalúa el contexto específico del comerciante.

Petición HTTP POST sin Cuerpo (Body)

No se requiere enviar una carga útil JSON en el cuerpo. Únicamente debes especificar el encabezado obligatorio clientType dentro de las cabeceras HTTP de la petición.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para establecer la presencia del comerciante en línea.

cURL BASH

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

Respuesta

Ejemplo de respuesta devuelta tras la ejecución exitosa de la solicitud.

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 cuando el comerciante pasa exitosamente al modo en línea.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para activar la presencia del comerciante en línea.

01 Fijar Encabezado Incluye clientType (por ejemplo, WEB o APP) en la cabecera.

02 Emitir Solicitud Llama al endpoint /sapi/v1/c2c/merchant/getOnline.

03 Verificar Respuesta Confirma que la respuesta retorne code: "000000".

04 Presencia en Línea El perfil del comerciante se actualiza a activo en los listados P2P.

Casos de Uso Comunes

Inicialización de Bots al Arrancar

Asegura que tus bots marquen automáticamente la cuenta como conectada tras verificar saldo y completar chequeos previos.

Apertura de Turno de Atención

Notifica de inmediato la disponibilidad del comerciante a los compradores al iniciar el horario comercial.

Reanudación Tras Desconexión

Restablece el estado activo de forma automática una vez recuperado el enlace de red o superada una falla del servidor.