BINANCE SAPI · C2C

API para Publicar Anuncio

Crea y publica nuevos anuncios de compra o venta peer-to-peer (C2C/P2P) con esquemas de precios personalizados, límites operativos, vinculación de métodos de pago y filtros estrictos de elegibilidad para la contraparte.

ENDPOINT

POST /sapi/v1/c2c/ads/post

Autenticación USER_DATA / 2FA SIGNED

Grupo API C2C / Ads

Método POST

Respuesta JSON

Descripción General

Este endpoint procesa y publica un nuevo anuncio C2C (P2P) en Binance. Permite a comerciantes verificados y bots de creación de mercado configurar fórmulas de precio fijo o flotante, montos iniciales de liquidez en criptomonedas, límites por transacción, mensajes de respuesta automática y métodos de pago locales compatibles.

Para mitigar el riesgo operativo frente a contrapartes desconocidas, el endpoint admite reglas estrictas de control de riesgo, tales como cantidad mínima de órdenes completadas con éxito, tasa mínima de finalización, antigüedad de la cuenta y nivel de verificación KYC requerido para los usuarios que tomen el anuncio.

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` o `APP`).
`asset`	Body	STRING	Requerido	Símbolo del criptoactivo a comercializar (por ejemplo, `USDT`, `BTC`).
`fiatUnit`	Body	STRING	Requerido	Símbolo de la moneda fiat local de liquidación (por ejemplo, `USD`, `VES`, `COP`, `ARS`).
`tradeType`	Body	STRING	Requerido	Sentido del anuncio: `BUY` (compra) o `SELL` (venta).
`priceType`	Body	INT	Requerido	Esquema de fijación de precio: `1` Precio Fijo, `2` Precio Flotante.
`price`	Body	NUMBER	Requerido	Precio unitario de oferta cuando se utiliza `priceType=1`.
`initAmount`	Body	NUMBER	Requerido	Cantidad total de criptomoneda asignada para publicar y respaldar el anuncio.
`minSingleTransAmount`	Body	NUMBER	Requerido	Límite mínimo de dinero fiat por cada orden individual.
`maxSingleTransAmount`	Body	NUMBER	Requerido	Límite máximo de dinero fiat por cada orden individual.
`tradeMethods`	Body	ARRAY	Requerido	Arreglo de métodos de pago configurados, compuesto por objetos con `payType` y `payId`.
`onlineNow`	Body	BOOLEAN	Opcional	Definir en `true` para publicar el anuncio en línea inmediatamente tras su creación.
`authType`	Body	STRING	Opcional	Método de autenticación de dos factores empleado (por ejemplo, `GOOGLE`, `SMS`, `FIDO2`).

Seguridad mediante Autenticación de Dos Factores (2FA)

La creación y publicación de anuncios C2C exige enviar códigos de verificación de dos factores válidos (como googleVerifyCode o mobileVerifyCode) dentro de la carga útil del cuerpo de la petición.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para publicar un anuncio de venta de USDT a precio fijo.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/ads/post' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "asset": "USDT",
  "fiatUnit": "USD",
  "tradeType": "SELL",
  "priceType": 1,
  "price": 1.02,
  "initAmount": 1000,
  "minSingleTransAmount": 50,
  "maxSingleTransAmount": 1000,
  "onlineNow": true,
  "tradeMethods": [
    {
      "payType": "BANK_TRANSFER",
      "payId": 123456
    }
  ],
  "authType": "GOOGLE",
  "googleVerifyCode": "123456"
}'

Respuesta

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

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": "1122334455667788",
    "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 informativo o detalle de ejecución de la solicitud.
`data`	STRING	Identificador único del anuncio recién creado (`adsNo`).
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para configurar y publicar un anuncio en el mercado C2C.

01 Configurar Oferta Define cripto, fiat, fórmula de precio y liquidez total.

02 Vincular Pagos Selecciona métodos de pago activos y cuentas bancarias.

03 Fijar Reglas de Riesgo Establece filtros de tasa de finalización y antigüedad.

04 Validar y Publicar Envía el código 2FA y activa el anuncio en el mercado.

Casos de Uso Comunes

Publicación Automatizada

Lanza avisos de compra o venta de forma programática con esquemas de precios dinámicos según las oscilaciones del mercado.

Provisión de Liquidez para Comerciantes

Publica liquidez P2P personalizada en canales bancarios de alta demanda y liquidación inmediata.

Filtrado Antifraude de Contrapartes

Aplica requisitos estrictos de historial operativo y KYC para evitar disputas y asegurar órdenes fluidas.