Consulta estadísticas agregadas de trading, métricas de órdenes en curso y resúmenes históricos de finalización para la cuenta autenticada en peer-to-peer (C2C/P2P).
/sapi/v1/c2c/orderMatch/getUserOrderSummaryEste endpoint proporciona una visión global de la actividad comercial de un usuario en el mercado peer-to-peer (P2P) de Binance. Devuelve resúmenes estadísticos consolidados que incluyen el recuento de órdenes en proceso, volúmenes de intercambio activos, totales acumulados a 30 días y métricas generales de efectividad operativa.
Mesas de dinero automatizadas, paneles de administración para comerciantes y sistemas de analítica recurren a este endpoint para supervisar en tiempo real la carga operativa, evitar cuellos de botella por concurrencia y rastrear los indicadores clave de rendimiento (KPIs).
01
Parámetros de encabezado (Header) aceptados por el endpoint.
| Encabezado | Tipo | Requerido | Descripción |
|---|---|---|---|
clientType | STRING | Requerido | Tipo de dispositivo o cliente que realiza la petición (por ejemplo, WEB, APP o 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 el seguimiento y depuración de la solicitud. |
x-user-id | STRING | Opcional | Identificador de usuario objetivo si se requiere validar el contexto de la cuenta. |
Consulta HTTP GET sin Parámetros de URL
Este es un endpoint GET sin parámetros obligatorios en la cadena de consulta (query string). Únicamente debes especificar el encabezado obligatorio clientType dentro de las cabeceras HTTP de la petición.
02
Ejemplo de solicitud GET mediante cURL para consultar las estadísticas de órdenes.
curl -X GET \
'https://api.binance.com/sapi/v1/c2c/orderMatch/getUserOrderSummary' \
-H 'clientType: WEB'03
Ejemplo de respuesta devuelta tras una consulta exitosa.
{
"code": "000000",
"message": "success",
"data": {
"processingOrderNum": 2,
"completedOrderNum": 450,
"finishRate": 0.985,
"avgReleaseTime": 120,
"avgPayTime": 180,
"monthOrderCount": 125,
"monthFinishRate": 0.992
},
"success": true
}| Campo | Tipo | Descripción |
|---|---|---|
code | STRING | Código de respuesta estándar de Binance ("000000" indica éxito). |
data.processingOrderNum | INT | Cantidad de órdenes P2P abiertas actualmente en proceso (en espera de pago o de liberación de custodia). |
data.completedOrderNum | INT | Número total histórico de órdenes finalizadas con éxito desde la creación de la cuenta. |
data.finishRate | DOUBLE | Tasa histórica general de finalización de órdenes expresada en ratio decimal (por ejemplo, 0.985 equivale al 98.5%). |
data.avgReleaseTime | INT | Tiempo promedio histórico de liberación de criptomonedas medido en segundos. |
data.avgPayTime | INT | Tiempo promedio histórico de confirmación y emisión de pagos medido en segundos. |
data.monthOrderCount | INT | Cantidad total de órdenes ejecutadas durante los últimos 30 días móviles. |
data.monthFinishRate | DOUBLE | Porcentaje o ratio de órdenes completadas exitosamente durante la ventana de los últimos 30 días. |
04
Flujo de trabajo para consultar las métricas comerciales de la cuenta.
Control de Límite de Concurrencia
Inspecciona processingOrderNum para pausar automáticamente la captación de órdenes cuando se alcanza el límite operativo simultáneo del bot.
Monitoreo de KPIs de Comerciante
Supervisa la tasa de finalización mensual y los tiempos promedio de liberación para conservar el estatus de comerciante verificado o VIP.
Paneles de Desempeño y Auditoría
Visualiza estadísticas de rendimiento en tiempo real y velocidades operativas dentro de paneles de control internos.