BINANCE SAPI · C2C

API de Detalle de Anuncio

Obtén especificaciones completas, parámetros de precio, límites operativos y métodos de pago admitidos para un anuncio C2C específico mediante su identificador único.

ENDPOINT

POST /sapi/v1/c2c/ads/getDetailByNo

Autenticación NONE (PÚBLICA)

Grupo API C2C / Ads

Método POST

Respuesta JSON

Descripción General

Este endpoint permite consultar los metadatos completos de un anuncio peer-to-peer (C2C/P2P) de Binance utilizando su número identificador (adsNo). Devuelve las condiciones operativas vigentes en tiempo real, tales como precio unitario, cantidad de activo remanente disponible, límites mínimo y máximo por orden, métodos de pago aceptados y condiciones impuestas por el comerciante.

Bots de trading y herramientas de monitoreo de mercado utilizan este endpoint para auditar anuncios activos antes de colocar órdenes de compra o venta en el libro P2P.

Parámetros de la Solicitud

Parámetros aceptados por el endpoint mediante Query y encabezados HTTP.

Parámetro	Ubicación	Tipo	Requerido	Descripción
`adsNo`	Query	STRING	Requerido	Número de anuncio único de Binance C2C a consultar.
`clientType`	Header	STRING	Requerido	Tipo de dispositivo o cliente que realiza la petición (por ejemplo, `WEB` o `APP`).
`x-gray-env`	Header	STRING	Opcional	Identificador de entorno utilizado para entornos de prueba internos o staging.
`x-trace-id`	Header	STRING	Opcional	Identificador de trazabilidad generado por el cliente para monitoreo y depuración.
`x-user-id`	Header	STRING	Opcional	ID del usuario objetivo cuando se comprueban permisos de acceso o elegibilidad específica para el anuncio.

Solicitud HTTP POST con parámetros en URL

Ten presente que, aunque el método HTTP es POST, el parámetro obligatorio adsNo se envía en la query string de la URL, mientras que clientType debe enviarse en los encabezados HTTP.

Ejemplo de Solicitud

Ejemplo de petición utilizando cURL.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/ads/getDetailByNo?adsNo=1122334455667788' \
-H 'clientType: WEB'

Respuesta

Ejemplo de respuesta devuelta tras una consulta exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "advNo": "1122334455667788",
        "tradeType": "BUY",
        "asset": "USDT",
        "fiatUnit": "USD",
        "price": "1.00",
        "surplusAmount": "5000.00",
        "minSingleTransAmount": "100.00",
        "maxSingleTransAmount": "2000.00",
        "tradeMethods": [
            {
                "identifier": "BANK_TRANSFER",
                "tradeMethodName": "Bank Transfer"
            }
        ],
        "status": 1
    },
    "success": true
}

Campos de la Respuesta

Campo	Tipo	Descripción
`advNo`	STRING	Identificador único del anuncio C2C en Binance.
`tradeType`	STRING	Tipo de operación del anuncio: `BUY` (compra) o `SELL` (venta).
`asset`	STRING	Criptomoneda comercializada en el anuncio (ej. `USDT`, `BTC`).
`fiatUnit`	STRING	Moneda fiat local de liquidación (ej. `USD`, `VES`, `COP`, `ARS`).
`price`	STRING	Precio unitario fijado en el anuncio.
`surplusAmount`	STRING	Cantidad de criptomoneda restante disponible para operar en el anuncio.
`minSingleTransAmount`	STRING	Límite mínimo de dinero fiat admitido por orden individual.
`maxSingleTransAmount`	STRING	Límite máximo de dinero fiat admitido por orden individual.
`tradeMethods`	ARRAY	Lista de métodos de pago configurados y admitidos por el anunciante.

Cómo Funciona

Flujo de trabajo para consultar las especificaciones de un anuncio C2C.

01 Obtener Número Toma el identificador adsNo del mercado o aviso.

02 Enviar Petición Realiza el POST con parámetro en URL y header clientType.

03 Validar Parámetros Revisa liquidez restante, precio y métodos de pago.

04 Iniciar Operación Procede a colocar la orden si las condiciones coinciden.

Casos de Uso Comunes

Auditoría de Anuncios en Tiempo Real

Comprueba si un anuncio sigue activo y con suficiente liquidez antes de disparar órdenes de compra o venta automatizadas.

Monitoreo de Precios Competidores

Rastrea las variaciones de precio y volumen disponible en los anuncios de la competencia de manera continua.

Validación de Métodos de Pago

Asegura que el anuncio acepte canales de pago y bancos compatibles con tus cuentas de liquidación locales.