BINANCE SAPI · C2C

API para Actualizar Anuncios

Actualiza y modifica los parámetros de anuncios peer-to-peer (C2C/P2P) existentes, incluyendo precios de oferta, límites por transacción, condiciones de contraparte, mensajes de respuesta automática y métodos de pago vinculados.

ENDPOINT

POST /sapi/v1/c2c/ads/update

Autenticación USER_DATA / 2FA SIGNED

Grupo API C2C / Ads

Método POST

Respuesta JSON

Descripción General

Este endpoint modifica la configuración de un anuncio C2C (P2P) existente identificado mediante su advNo único. Comerciantes y bots de arbitraje o creación de mercado pueden ajustar los precios de oferta, actualizar las reservas de liquidez cripto asignadas, cambiar los límites mínimos y máximos por orden o renovar los requisitos de elegibilidad para compradores y vendedores.

Dado que la alteración de las condiciones de un anuncio incide directamente en los compromisos de fondos y en las reglas de seguridad operativa, cada solicitud requiere un código válido de autenticación de dos factores (2FA) transmitido dentro del cuerpo de la petición.

📖 Consulta también: Cómo cambiar el precio de un anuncio en Binance usando Python: Guía paso a paso

Parámetros de la Solicitud

Parámetros principales 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`, `APP`).
`advNo`	Body	STRING	Requerido	Número identificador único del anuncio C2C que se desea modificar.
`price`	Body	NUMBER	Opcional	Precio unitario de oferta actualizado por cada unidad cripto.
`priceType`	Body	INT	Opcional	Esquema de fijación de precio: `1` Precio Fijo, `2` Precio Flotante.
`initAmount`	Body	NUMBER	Opcional	Cantidad total de liquidez en criptomoneda asignada al anuncio.
`minSingleTransAmount`	Body	NUMBER	Opcional	Monto mínimo en divisa fiat permitido por cada orden individual.
`maxSingleTransAmount`	Body	NUMBER	Opcional	Monto máximo en divisa fiat permitido por cada orden individual.
`tradeMethods`	Body	ARRAY	Opcional	Arreglo con los métodos de pago actualizados que estarán vinculados al anuncio.
`updateMode`	Body	STRING	Opcional	Indicador del modo de actualización para definir cambios parciales o totales de parámetros.
`authType`	Body	STRING	Opcional	Método de autenticación de dos factores empleado (por ejemplo, `GOOGLE`, `SMS`, `FIDO2`).

Requisitos de Autenticación de Dos Factores

Cualquier modificación sobre anuncios activos exige adjuntar un token de verificación 2FA vigente (como googleVerifyCode o código SMS) dentro de la carga JSON enviada al servidor.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para actualizar el precio y límites de un anuncio.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/ads/update' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "advNo": "1122334455667788",
  "price": 1.03,
  "minSingleTransAmount": 100,
  "maxSingleTransAmount": 2000,
  "authType": "GOOGLE",
  "googleVerifyCode": "123456"
}'

Respuesta

Ejemplo de respuesta devuelta tras la actualización exitosa del anuncio.

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` si los cambios solicitados en el anuncio se aplicaron correctamente.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para actualizar las condiciones de un anuncio C2C existente.

01 Identificar Anuncio Indica el advNo objetivo que se desea modificar.

02 Definir Condiciones Envía nuevos precios, límites de volumen o métodos de pago.

03 Adjuntar Token 2FA Incluye el código de verificación del autenticador en el JSON.

04 Aplicar Cambios Ejecuta la llamada para actualizar el libro de órdenes C2C en vivo.

Casos de Uso Comunes

Reposicionamiento Dinámico de Precios

Reajusta las tasas de oferta en tiempo real siguiendo los movimientos del mercado para conservar los primeros puestos del libro de órdenes.

Rebalanceo de Inventario y Límites

Modifica los saldos asignados o los umbrales de compra mínima y máxima sin necesidad de cerrar y republicar la oferta.

Rotación de Cuentas de Cobro

Actualiza las cuentas bancarias o billeteras receptoras vinculadas al anuncio para distribuir el volumen operativo entre distintos canales.