BINANCE SAPI · C2C

API de Detalles de Anuncios por Número de Comerciante

Consulta los detalles de anuncios y las configuraciones de oferta específicas para el comercio peer-to-peer (C2C/P2P) mediante el identificador único del comerciante.

ENDPOINT

GET /sapi/v1/c2c/merchant/getAdDetails

Autenticación NONE (PÚBLICA)

Grupo API C2C / Merchant

Método GET

Respuesta JSON

Descripción General

Este endpoint obtiene las especificaciones de los anuncios peer-to-peer asociados a un perfil de comerciante específico mediante su identificador único (merchantNo). Permite a aplicaciones cliente, bots de trading algorítmico y paneles de control examinar los anuncios activos, métodos de pago vinculados y términos de transacción configurados directamente en la cuenta del anunciante.

Dado que se procesa a través de una petición HTTP GET sin requerir firmas criptográficas HMAC ni credenciales de API, es la solución óptima para mostrar vitrinas comerciales públicas, renderizar perfiles de comerciantes en interfaces web y hacer seguimiento de la oferta de la competencia.

Parámetros de la Solicitud

Parámetros aceptados en la URL (Query string) 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`, `APP` o `WEB_MOBILE`).
`merchantNo`	Query	STRING	Opcional	Número de identificación único del comerciante cuyos anuncios se desean consultar.
`x-gray-env`	Header	STRING	Opcional	Identificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing).
`x-trace-id`	Header	STRING	Opcional	Identificador de trazabilidad generado por el cliente para el seguimiento y depuración de la solicitud.
`x-user-id`	Header	STRING	Opcional	Identificador de usuario objetivo para consultas específicas de contexto.

Solicitud GET con Parámetro de Consulta

Envía el parámetro merchantNo como parte de la cadena de consulta en la URL (por ejemplo, ?merchantNo=M12345678), manteniendo la cabecera obligatoria clientType dentro de los encabezados HTTP de la petición.

Ejemplo de Solicitud

Ejemplo de solicitud GET mediante cURL.

cURL BASH

curl -X GET \
'https://api.binance.com/sapi/v1/c2c/merchant/getAdDetails?merchantNo=M12345678' \
-H 'clientType: WEB'

Respuesta

Ejemplo de respuesta devuelta tras una consulta exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "merchantNo": "M12345678",
        "nickName": "FastMerchant",
        "adsDetailList": [
            {
                "advNo": "1122334455667788",
                "asset": "USDT",
                "fiatUnit": "USD",
                "tradeType": "SELL",
                "price": "1.01",
                "surplusAmount": "2500.00",
                "minSingleTransAmount": "50.00",
                "maxSingleTransAmount": "1000.00",
                "advStatus": 1
            }
        ]
    },
    "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.merchantNo`	STRING	Identificador del perfil de comerciante consultado.
`data.nickName`	STRING	Apodo público visible del comerciante.
`data.adsDetailList`	ARRAY	Lista de objetos con los anuncios activos gestionados por el comerciante indicado.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para consultar anuncios por número de comerciante.

01 Fijar Comerciante Agrega el identificador merchantNo como parámetro de consulta en la URL.

02 Enviar Solicitud Llama mediante GET público al endpoint /sapi/v1/c2c/merchant/getAdDetails.

03 Procesar Anuncios Extrae los números de anuncio, condiciones de precio y montos disponibles.

04 Mostrar Ofertas Renderiza los anuncios en la vitrina del comerciante o en bots de monitoreo.

Casos de Uso Comunes

Vitrinas de Comerciante en el Frontend

Construye páginas de perfil dedicadas que listen todas las ofertas activas de compra y venta publicadas por un comerciante específico.

Monitoreo de la Competencia

Rastrea en tiempo real los esquemas de precios, la liquidez remanente y los rangos operativos de comerciantes competidores destacados.

Verificación del Portafolio de Anuncios

Audita las condiciones comerciales y parámetros vigentes de las publicaciones asociadas directamente a un identificador de comerciante.