Actualiza de forma masiva el estado operativo de múltiples anuncios peer-to-peer (C2C/P2P) simultáneamente, permitiendo a los comerciantes publicar, pausar o cerrar ofertas por lotes.
/sapi/v1/c2c/ads/updateStatusEste endpoint ejecuta actualizaciones masivas de estado sobre múltiples anuncios C2C (P2P) en una única solicitud. Comerciantes y bots de trading automatizado recurren a esta operación para alternar rápidamente la visibilidad de su catálogo: publicar avisos que estaban fuera de línea, pausar anuncios activos fuera del horario laboral o cerrar definitivamente ofertas cuya liquidez fue agotada.
Al aceptar una lista de identificadores (advNos), los desarrolladores pueden gestionar simultáneamente portafolios enteros de anuncios sin incurrir en llamadas individuales repetitivas contra la API.
01
Parámetros aceptados en el cuerpo (Body) y encabezados HTTP.
| Parámetro | Ubicación | Tipo | Requerido | Descripción |
|---|---|---|---|---|
clientType | Header | STRING | Requerido | Tipo de dispositivo o cliente que realiza la petición (por ejemplo, WEB o APP). |
advNos | Body | ARRAY | Requerido | Arreglo de números de anuncios C2C (en formato string) cuyo estado se desea actualizar. |
advStatus | Body | INT | Requerido | Código de estado objetivo: 1 Publicado / En línea, 2 Pausado / Fuera de línea, 3 Cerrado / Eliminado. |
x-gray-env | Header | STRING | Opcional | Identificador de entorno utilizado para pruebas internas o staging. |
x-trace-id | Header | STRING | Opcional | Identificador de trazabilidad generado por el cliente para el monitoreo de la petición. |
x-user-id | Header | STRING | Opcional | Identificador de usuario objetivo cuando se ejecutan comprobaciones a nivel de cuenta. |
Rendimiento en Procesamiento por Lotes
Las actualizaciones masivas reducen la latencia de red y optimizan el consumo de los límites de tasa (rate limits) en comparación con peticiones individuales. Revisa siempre la lista failedList en la respuesta para confirmar si algún anuncio específico no pudo actualizarse.
02
Ejemplo de solicitud POST mediante cURL para pausar múltiples anuncios P2P en una sola llamada.
curl -X POST \
'https://api.binance.com/sapi/v1/c2c/ads/updateStatus' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
"advNos": [
"1122334455667788",
"9988776655443322"
],
"advStatus": 2
}'03
Ejemplo de respuesta devuelta tras la actualización masiva de estados.
{
"code": "000000",
"message": "success",
"data": {
"successList": [
"1122334455667788",
"9988776655443322"
],
"failedList": []
},
"success": true
}| Campo | Tipo | Descripción |
|---|---|---|
code | STRING | Código de estado estándar de respuesta de Binance ("000000" indica éxito). |
data.successList | ARRAY | Arreglo con los números de anuncio que cambiaron exitosamente al estado solicitado. |
data.failedList | ARRAY | Arreglo con los números de anuncio que fallaron durante la actualización de estado. |
success | BOOLEAN | Indica el resultado general de la ejecución de la petición. |
04
Flujo de trabajo para actualizar de forma masiva el estado de anuncios C2C.
advNos a modificar.successList.Botón de Apagado de Emergencia (Kill-Switch)
Retira de inmediato todos los anuncios activos del comerciante ante caídas bancarias repentinas o volatilidad extrema del mercado.
Automatización de Horarios Comerciales
Publica anuncios al iniciar la jornada comercial y pásalos a estado fuera de línea durante la noche mediante tareas cron en tu servidor.
Limpieza Masiva de Publicaciones
Cierra y descarta anuncios obsoletos, desactualizados o agotados en una sola llamada a la API sin iterar uno a uno.