BINANCE SAPI · C2C

API de Estadísticas de la Contraparte de la Orden

Consulta las estadísticas históricas de trading, tasas de finalización y tiempos promedio de liberación de la contraparte vinculada a una orden específica peer-to-peer (C2C/P2P).

ENDPOINT

POST /sapi/v1/c2c/orderMatch/queryCounterPartyOrderStatistic

Autenticación USER_DATA / SIGNED

Grupo API C2C / Order Match

Método POST

Respuesta JSON

Descripción General

Este endpoint permite a compradores, vendedores o sistemas automatizados de control de riesgo inspeccionar el perfil de desempeño histórico de la contraparte asignada a una orden C2C (P2P) activa o completada. Proporciona métricas clave de confianza, tales como el total acumulado de operaciones concretadas, recuento de órdenes en los últimos 30 días, tiempo promedio de pago y porcentaje histórico de finalización.

Mesas de trading automatizado y daemons de mitigación de fraude ejecutan esta consulta inmediatamente después de la creación de la orden para evaluar la fiabilidad de la contraparte antes de proceder con transferencias bancarias o con la liberación de activos en custodia.

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`, `APP` o `WEB_MOBILE`).
`orderNumber`	Body	STRING	Requerido	Número identificador único de la orden C2C para consultar las estadísticas de su contraparte.
`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 si se requiere validar el contexto de la cuenta.

Disparador de Evaluación de Riesgo

Ejecuta esta consulta inmediatamente después de la creación de la orden (placeOrder) para detectar de forma dinámica cuentas con baja tasa de finalización o perfiles de alto riesgo antes de procesar pagos fiduciarios.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para consultar las métricas de la contraparte.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/orderMatch/queryCounterPartyOrderStatistic' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "orderNumber": "202608161234567890"
}'

Respuesta

Ejemplo de respuesta devuelta tras una consulta exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "completedOrderNum": 620,
        "finishRate": 0.994,
        "avgPayTime": 140,
        "avgReleaseTime": 95,
        "monthOrderCount": 180,
        "monthFinishRate": 0.991,
        "registeredDays": 410
    },
    "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.completedOrderNum`	INT	Cantidad total histórica de órdenes ejecutadas con éxito por la contraparte.
`data.finishRate`	DOUBLE	Tasa histórica general de finalización de órdenes expresada en ratio decimal (por ejemplo, `0.994` equivale al 99.4%).
`data.avgPayTime`	INT	Tiempo promedio histórico de confirmación y emisión de pagos medido en segundos.
`data.avgReleaseTime`	INT	Tiempo promedio histórico de liberación de criptomonedas medido en segundos.
`data.monthOrderCount`	INT	Total de órdenes completadas por la contraparte en los últimos 30 días móviles.
`data.monthFinishRate`	DOUBLE	Tasa porcentual o ratio de órdenes completadas exitosamente en la ventana de los últimos 30 días.
`data.registeredDays`	INT	Número total de días transcurridos desde que la contraparte registró su cuenta en la plataforma.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para evaluar el historial de trading de la contraparte.

01 Identificar Orden Adjunta el orderNumber activo en el cuerpo JSON.

02 Enviar Solicitud Emite el POST a /sapi/v1/c2c/orderMatch/queryCounterPartyOrderStatistic.

03 Evaluar Métricas Verifica tasa de éxito, órdenes totales y antigüedad de registro.

04 Proceder con la Orden Ejecuta la liquidación automática o solicita revisión manual al operador.

Casos de Uso Comunes

Scoring de Riesgo y Antifraude Automatizado

Retén o rechaza pagos automáticos si la tasa de finalización de la contraparte cae por debajo de umbrales seguros (por ejemplo, menor al 90%).

Protección Contra Cuentas Nuevas

Comprueba registeredDays para aplicar validaciones de identidad adicionales a cuentas de reciente creación antes de procesar órdenes de alto volumen.

Panel de Confianza en Interfaces de Comerciante

Renderiza insignias de reputación y promedios de velocidad operativa en consolas de gestión y chats comerciales P2P.