BINANCE SAPI · C2C

API de Lista de Anuncios con Paginación

Consulta y filtra anuncios peer-to-peer (C2C/P2P) de usuarios y comercios con soporte de paginación flexible, estados, intervalos de fechas y parámetros de ordenamiento.

ENDPOINT

POST /sapi/v1/c2c/ads/listWithPagination

Autenticación NONE (PÚBLICA)

Grupo API C2C / Ads

Método POST

Respuesta JSON

Descripción General

Este endpoint proporciona un listado paginado de anuncios de la plataforma peer-to-peer (C2C/P2P) de Binance. Permite a los desarrolladores y a los sistemas de gestión para comercios obtener y buscar publicaciones filtradas por activo cripto, moneda fiat local, sentido de la operación (BUY/SELL), estado de la publicación y ventanas de fechas puntuales.

Plataformas de trading P2P, sistemas de creación de mercado automatizados y paneles de administración de comerciantes integran este endpoint para construir tablas interactivas de avisos, supervisar la liquidez remanente y rastrear el historial de publicaciones activas.

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 petición (por ejemplo, `WEB` o `APP`).
`page`	Body	INT	Opcional	Número de página a consultar para la paginación (inicia en `1`).
`rows`	Body	INT	Opcional	Cantidad de registros devueltos por página (ej. `10`, `20`).
`asset`	Body	STRING	Opcional	Filtro por símbolo del criptoactivo (por ejemplo, `USDT`, `BTC`).
`fiatUnit`	Body	STRING	Opcional	Filtro por moneda fiat local (por ejemplo, `USD`, `VES`, `COP`, `ARS`).
`tradeType`	Body	STRING	Opcional	Filtro por sentido del anuncio: `BUY` (compra) o `SELL` (venta).
`advStatus`	Body	INT	Opcional	Código numérico para filtrar según el estado del anuncio.
`advNo`	Body	STRING	Opcional	Número de anuncio específico para buscar una publicación puntual.
`startDate`	Body	STRING	Opcional	Marca de fecha inicial en formato ISO-8601, ej. `2026-08-01T00:00:00Z`.
`endDate`	Body	STRING	Opcional	Marca de fecha final en formato ISO-8601, ej. `2026-08-13T23:59:59Z`.
`sort`	Body	STRING	Opcional	Identificador del campo utilizado para ordenar los resultados.
`order`	Body	STRING	Opcional	Dirección del ordenamiento: `ASC` (ascendente) o `DESC` (descendente).

Buenas prácticas de paginación

Al consultar catálogos con alto volumen de avisos, define siempre los parámetros page y rows para garantizar una transferencia de datos ágil y evitar sobrecargar la respuesta JSON.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL con parámetros de paginación y filtros.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/ads/listWithPagination' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "page": 1,
  "rows": 10,
  "asset": "USDT",
  "fiatUnit": "USD",
  "tradeType": "BUY"
}'

Respuesta

Ejemplo de respuesta devuelta tras una consulta exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "total": 1,
        "page": 1,
        "rows": 10,
        "list": [
            {
                "advNo": "1122334455667788",
                "tradeType": "BUY",
                "asset": "USDT",
                "fiatUnit": "USD",
                "price": "1.00",
                "surplusAmount": "5000.00",
                "advStatus": 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.total`	INT	Cantidad total de anuncios que coinciden con los criterios de búsqueda.
`data.page`	INT	Número de la página devuelta en la respuesta actual.
`data.rows`	INT	Cantidad de filas por página configuradas para el resultado.
`data.list`	ARRAY	Arreglo con los objetos de detalle de cada anuncio encontrado.

Cómo Funciona

Flujo de trabajo para consultar registros de anuncios paginados.

01 Fijar Criterios Define criptomoneda, fiat y tradeType en el payload.

02 Configurar Paginación Indica número de página y cantidad de filas.

03 Enviar Solicitud Envía el POST con el header clientType requerido.

04 Procesar Resultados Renderiza los anuncios en tablas o listas interactivas.

Casos de Uso Comunes

Tablas en Paneles de Comerciante

Construye vistas web interactivas con control de páginas para que los comerciantes P2P supervisen sus avisos activos e históricos.

Sincronización de Inventario

Consulta periódicamente los anuncios vigentes de la cuenta para mantener sincronizada tu base de datos interna.

Búsquedas Segmentadas

Localiza anuncios rápidamente aplicando filtros por advNo, estados operativos o rangos de fechas específicos.