BINANCE SAPI · C2C

API para Buscar Anuncios con Condiciones

Busca, filtra y explora anuncios activos peer-to-peer (C2C/P2P) según criterios específicos como moneda fiat, criptoactivo, canales de pago, monto de la operación y tipo de comerciante.

ENDPOINT

POST /sapi/v1/c2c/ads/search

Autenticación NONE (PÚBLICA)

Grupo API C2C / Ads

Método POST

Respuesta JSON

Descripción General

Este endpoint público ejecuta búsquedas en tiempo real dentro del libro de órdenes del mercado peer-to-peer (C2C/P2P) de Binance. Permite a plataformas de intercambio, bots de arbitraje automatizado y aplicaciones cliente consultar anuncios activos de compra o venta filtrados por moneda fiat local, criptomoneda, métodos de pago admitidos, nivel de verificación del comerciante y montos específicos de transacción.

Al tratarse de una petición pública y no autenticada, no exige firmas criptográficas HMAC ni credenciales de API, lo que la convierte en la opción ideal para escanear liquidez en el libro, vigilar precios de mercado en tiempo real y alimentar interfaces de órdenes P2P.

Parámetros de la Solicitud

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 consulta (por ejemplo, `WEB` o `APP`).
`asset`	Body	STRING	Requerido	Símbolo del criptoactivo a buscar (por ejemplo, `USDT`, `BTC`).
`fiat`	Body	STRING	Requerido	Símbolo de la moneda fiat local de liquidación (por ejemplo, `USD`, `VES`, `COP`, `ARS`).
`tradeType`	Body	STRING	Requerido	Sentido de la operación en el libro: `BUY` (compra) o `SELL` (venta).
`page`	Body	INT	Opcional	Número de página para la paginación de resultados (inicia en `1`).
`rows`	Body	INT	Opcional	Cantidad de registros devueltos por página (por defecto `10`, máximo `20`).
`payTypes`	Body	ARRAY	Opcional	Lista de identificadores de métodos de pago (por ejemplo, `["BANK_TRANSFER", "REVOLUT"]`).
`transAmount`	Body	NUMBER	Opcional	Monto exacto en dinero fiat que se desea operar, para filtrar solo anuncios con límites compatibles.
`publisherType`	Body	STRING	Opcional	Filtro de anunciante: `merchant` para comerciantes verificados o `null` para todos los usuarios.
`countries`	Body	ARRAY	Opcional	Arreglo de códigos de país para filtrar anunciantes por región geográfica.

Filtrado por Monto de Operación

Enviar el parámetro transAmount descarta de inmediato los anuncios cuyos límites minSingleTransAmount o maxSingleTransAmount no se ajusten al tamaño de orden que necesitas operar.

Ejemplo de Solicitud

Ejemplo de petición POST con cURL para buscar anuncios de compra de USDT con transferencia bancaria.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/ads/search' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "asset": "USDT",
  "fiat": "USD",
  "tradeType": "BUY",
  "page": 1,
  "rows": 10,
  "payTypes": ["BANK_TRANSFER"],
  "publisherType": "merchant"
}'

Respuesta

Ejemplo de respuesta devuelta tras una búsqueda exitosa de anuncios.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": [
        {
            "adv": {
                "advNo": "1122334455667788",
                "price": "1.00",
                "surplusAmount": "2500.00",
                "minSingleTransAmount": "100.00",
                "maxSingleTransAmount": "1500.00",
                "tradeMethods": [
                    {
                        "identifier": "BANK_TRANSFER",
                        "tradeMethodName": "Bank Transfer"
                    }
                ]
            },
            "advertiser": {
                "userNo": "usr12345678",
                "nickName": "FastTrader",
                "userType": "merchant",
                "monthOrderCount": 450,
                "monthFinishRate": 0.99
            }
        }
    ],
    "total": 1,
    "success": true
}

Campos de la Respuesta

Campo	Tipo	Descripción
`code`	STRING	Código de estado estándar de respuesta de Binance (`"000000"` indica éxito).
`data`	ARRAY	Lista de anuncios que coinciden con los filtros aplicados junto con el perfil del anunciante.
`data[].adv.advNo`	STRING	Identificador único del anuncio C2C.
`data[].adv.price`	STRING	Precio de oferta actual por unidad de criptomoneda en el anuncio.
`data[].adv.surplusAmount`	STRING	Cantidad de criptomoneda remanente disponible para ser negociada.
`data[].advertiser.nickName`	STRING	Apodo público visible del comerciante o usuario anunciante.
`data[].advertiser.monthFinishRate`	NUMBER	Tasa porcentual de órdenes completadas exitosamente por el comerciante en los últimos 30 días.

Cómo Funciona

Flujo de trabajo para buscar y evaluar anuncios de mercado C2C.

01 Fijar Criterios Define criptoactivo, moneda fiat, canales de pago y volumen.

02 Enviar Búsqueda Realiza el POST público hacia /sapi/v1/c2c/ads/search.

03 Analizar Resultados Compara precios, tasa de finalización y saldo remanente.

04 Elegir Mejor Oferta Selecciona el anuncio óptimo para operar o ejecutar arbitraje.

Casos de Uso Comunes

Interfaz de Libro de Órdenes P2P

Construye paneles en tiempo real que muestren las mejores ofertas de compra y venta del mercado peer-to-peer.

Rastreo de Oportunidades de Arbitraje

Consulta continuamente los anuncios activos para detectar diferenciales de precio rentables entre pasarelas de pago y mercados spot.

Localización del Mejor Tipo de Cambio

Filtra anuncios por volumen específico y cuentas bancarias locales para encontrar siempre la tasa de cambio más favorable.