BINANCE SAPI · C2C

API para Iniciar Descanso de Comerciante

Coloca la cuenta de comerciante peer-to-peer (C2C/P2P) en modo de descanso temporal, pausando la entrada de nuevas órdenes mientras se preservan intactos los anuncios configurados.

ENDPOINT

POST /sapi/v1/c2c/merchant/startRest

Autenticación USER_DATA / SIGNED

Grupo API C2C / Merchant

Método POST

Respuesta JSON

Descripción General

Este endpoint permite a los comerciantes verificados de Binance C2C (P2P) activar el modo de descanso en su perfil comercial. Al ingresar en este estado, se suspende temporalmente el flujo de órdenes entrantes y se actualiza la presencia pública del comerciante sin necesidad de despublicar, pausar individualmente ni eliminar los anuncios configurados en el catálogo.

Mesas de trading automatizado y operadores comerciales recurren a este endpoint para gestionar pausas cortas del personal, mitigar límites transitorios de recepción en pasarelas bancarias o frenar el volumen mientras se realizan conciliaciones breves de inventario.

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 activar el modo descanso del comerciante.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/merchant/startRest' \
-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 el modo descanso del comerciante se activa correctamente.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para colocar las operaciones del comerciante en modo descanso.

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

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

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

04 Descanso Activo El comerciante entra en modo descanso y pausa el ingreso de órdenes.

Casos de Uso Comunes

Pausas Cortas de Operadores

Detén temporalmente la entrada de intercambios mientras el operador se ausenta del escritorio sin dar de baja los anuncios publicados.

Contención por Límites Bancarios

Pausa las operaciones entrantes mientras esperas que se liberen cupos diarios o se acrediten transferencias pendientes en tus bancos.

Rutinas de Descanso Automatizadas

Programa intervalos de descanso periódicos a lo largo de sesiones de alto volumen utilizando tareas cron en segundo plano.