BINANCE SAPI · C2C

API de Categorías de Anuncios Disponibles

Consulta todas las categorías de anuncios peer-to-peer (C2C/P2P) admitidas según el tipo de cliente o plataforma que realiza la petición.

ENDPOINT

GET /sapi/v1/c2c/ads/getAvailableAdsCategory

Autenticación NONE (PÚBLICA)

Grupo API C2C / Ads

Método GET

Respuesta JSON

Descripción General

Este endpoint devuelve la lista de categorías de anuncios C2C (P2P) habilitadas por Binance. Es utilizado por plataformas de comerciantes, bots de trading P2P y aplicaciones cliente móviles para determinar de forma dinámica qué secciones de publicación están activas para publicar o consultar anuncios.

Al tratarse de una consulta abierta que no requiere firmas criptográficas, funciona como una validación pública y liviana. Los parámetros contextuales obligatorios (como clientType) deben enviarse directamente en los encabezados HTTP (headers) de la solicitud.

Parámetros de la Solicitud

Encabezados (headers) aceptados por el endpoint.

Header	Tipo	Requerido	Descripción
`clientType`	STRING	Requerido	Tipo de dispositivo o cliente que realiza la petición (por ejemplo, `WEB`, `APP`, `WEB_MOBILE`).
`x-gray-env`	STRING	Opcional	Identificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing).
`x-trace-id`	STRING	Opcional	Identificador de trazabilidad generado por el cliente para auditoría y depuración en el ciclo de vida de la petición.
`x-user-id`	STRING	Opcional	Identificador de usuario objetivo cuando se evalúan permisos de publicación específicos por cuenta.

Enviar parámetros en los encabezados

A diferencia de los endpoints convencionales donde los parámetros van en la URL, el parámetro obligatorio clientType debe enviarse dentro de los encabezados HTTP de la petición.

Ejemplo de Solicitud

Ejemplo de consulta mediante cURL enviando encabezados HTTP.

cURL BASH

curl -X GET \
'https://api.binance.com/sapi/v1/c2c/ads/getAvailableAdsCategory' \
-H 'clientType: WEB'

Respuesta

Ejemplo de respuesta devuelta tras una solicitud exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": [
        {
            "category": "BUY",
            "name": "Buy Crypto",
            "enabled": true
        },
        {
            "category": "SELL",
            "name": "Sell Crypto",
            "enabled": true
        }
    ],
    "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).
`message`	STRING	Mensaje descriptivo del resultado de la solicitud.
`data`	ARRAY	Lista de objetos correspondientes a las categorías de anuncios disponibles.
`data[].category`	STRING	Identificador interno de la categoría (por ejemplo, `BUY`, `SELL`).
`data[].name`	STRING	Título visible de la categoría para interfaces de usuario y paneles.
`data[].enabled`	BOOLEAN	Indica si la categoría está activa para la publicación de nuevos anuncios en ese momento.

Cómo Funciona

Flujo de trabajo para consultar categorías de anuncios C2C disponibles.

01 Definir Header Envía clientType (WEB o APP) en la cabecera HTTP.

02 Emitir Solicitud Envía el GET público a Binance C2C SAPI.

03 Procesar Respuesta Extrae las categorías marcadas como enabled: true.

04 Cargar Opciones Habilita los selectores correspondientes en el panel P2P.

Casos de Uso Comunes

Formularios Dinámicos

Carga dinámicamente en el frontend las categorías de anuncios activas según el dispositivo del comerciante.

Automatización de Comerciantes P2P

Valida la disponibilidad de la categoría antes de lanzar scripts que publiquen avisos de compra o venta en el libro P2P.

Control de Compatibilidad

Comprueba qué funcionalidades o modalidades de anuncio están habilitadas para usuarios Web frente a la aplicación móvil.