BINANCE SAPI · C2C

API para Iniciar Operaciones de Comerciante

Abre o reanuda las operaciones comerciales completas peer-to-peer (C2C/P2P) de un comerciante, activando la visibilidad pública de su vitrina y permitiendo la recepción de nuevas órdenes.

ENDPOINT

POST /sapi/v1/c2c/merchant/startBusiness

Autenticación USER_DATA / SIGNED

Grupo API C2C / Merchant

Método POST

Respuesta JSON

Descripción General

Este endpoint cambia el estado operativo general del comerciante de cerrado o en descanso a totalmente activo. Al ejecutarse, la vitrina del comerciante se reabre dentro de la plataforma Binance C2C (P2P), restableciendo la visibilidad de sus anuncios en el libro de órdenes público y permitiendo que los usuarios coloquen nuevas solicitudes de intercambio.

Bots de trading algorítmico, sistemas ERP comerciales y escritorios automatizados invocan este endpoint al comenzar turnos comerciales activos o inmediatamente después de finalizar procedimientos de rebalanceo de liquidez.

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úan permisos específicos de 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 iniciar operaciones comerciales.

cURL BASH

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

Respuesta

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

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": true,
    "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`	BOOLEAN	Devuelve `true` cuando las operaciones comerciales se abren exitosamente y pasan a estar activas.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para iniciar las operaciones comerciales del comerciante.

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

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

03 Verificar Respuesta Confirma que el campo devuelto sea data: true.

04 Vitrina Abierta La tienda comercial se activa y comienza a recibir órdenes entrantes.

Casos de Uso Comunes

Apertura Comercial Diaria

Inicia automáticamente las operaciones del comerciante al comienzo de la jornada laboral mediante tareas cron programadas en el servidor.

Reanudación Post Rebalanceo

Reabre la recepción de órdenes al instante luego de completar conciliaciones bancarias o depósitos de fondos fiduciarios.

Inicialización de Bots de Trading

Permite que las mesas de dinero y bots reactiven de forma programática el estado comercial durante su secuencia de encendido.