BINANCE SAPI · C2C

API de Precio de Referencia de Anuncios

Consulta los precios de referencia del mercado peer-to-peer (C2C/P2P) según criptoactivos, moneda fiat, sentido de la operación y métodos de pago.

ENDPOINT

POST /sapi/v1/c2c/ads/getReferencePrice

Autenticación NONE (PÚBLICA)

Grupo API C2C / Ads

Método POST

Respuesta JSON

Descripción General

Este endpoint proporciona cotizaciones dinámicas de referencia para el comercio de criptomonedas en el mercado C2C (P2P). Permite a comerciantes, bots algorítmicos y motores de fijación de precios consultar tasas base promedio ponderadas entre monedas fiat seleccionadas, criptoactivos (como USDT o BTC), canales de pago y sentido del intercambio (BUY/SELL).

Los bots de arbitraje y creadores de mercado (market makers) dependen de este precio de referencia para ajustar márgenes de spread óptimos y mantener anuncios competitivos frente a la oferta y demanda del mercado local en tiempo real.

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`).
`assets`	Body	ARRAY	Requerido	Lista de criptomonedas a cotizar, ej. `["USDT", "BTC"]`.
`fiatCurrency`	Body	STRING	Requerido	Código de la moneda fiat local objetivo (por ejemplo, `USD`, `VES`, `COP`, `ARS`).
`tradeType`	Body	STRING	Requerido	Sentido de la operación a evaluar: `BUY` (compra) o `SELL` (venta).
`fromUserRole`	Body	STRING	Opcional	Rol del usuario en la plataforma, por ejemplo `MERCHANT` (comerciante verificado) o `USER`.
`payType`	Body	STRING	Opcional	Código del método de pago específico si se requiere filtrar el precio de referencia por canal bancario.
`x-gray-env`	Header	STRING	Opcional	Identificador de entorno utilizado para pruebas internas de Binance (gray testing).
`x-trace-id`	Header	STRING	Opcional	Identificador de trazabilidad generado por el cliente para monitoreo de la petición.

Estructura requerida en formato JSON

Asegúrate de enviar una carga útil JSON válida en el cuerpo de la solicitud con assets, fiatCurrency y tradeType, junto con el encabezado obligatorio clientType y la cabecera Content-Type: application/json.

Ejemplo de Solicitud

Ejemplo de petición POST utilizando cURL.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/ads/getReferencePrice' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "assets": ["USDT"],
  "fiatCurrency": "USD",
  "tradeType": "BUY",
  "fromUserRole": "MERCHANT"
}'

Respuesta

Ejemplo de respuesta devuelta por la API tras una solicitud exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": [
        {
            "asset": "USDT",
            "fiatCurrency": "USD",
            "referencePrice": "1.002",
            "priceScale": 3
        }
    ],
    "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 objetos con los precios de referencia calculados para los activos solicitados.
`data[].asset`	STRING	Símbolo del criptoactivo evaluado.
`data[].fiatCurrency`	STRING	Moneda fiat de referencia para la cotización.
`data[].referencePrice`	STRING	Precio base de referencia calculado por Binance para el par cripto/fiat solicitado.
`data[].priceScale`	INT	Precisión decimal correspondiente para el cálculo del precio de cotización.

Cómo Funciona

Flujo de trabajo para consultar cotizaciones base de mercado P2P.

01 Definir Criterios Elige activos, moneda fiat y sentido de operación.

02 Enviar JSON Emite el POST al endpoint con el header clientType.

03 Leer Cotización Extrae la tasa base calculada en referencePrice.

04 Fijar Anuncios Ajusta el margen de beneficio en tus órdenes de mercado.

Casos de Uso Comunes

Reprecificación Dinámica

Ajusta automáticamente los precios de tus anuncios activos en Binance P2P manteniéndolos alineados a la referencia del mercado.

Bots de Arbitraje P2P

Detecta brechas de precio entre las tasas del libro spot y los valores de liquidación local en moneda fiduciaria.

Análisis de Margen de Comerciante

Evalúa el diferencial entre compra y venta (spread) antes de publicar anuncios para métodos de pago específicos.