BINANCE SAPI · C2C

API de Detalles de Orden de Usuario

Consulta información detallada de una orden de comercio peer-to-peer (C2C/P2P) específica, incluyendo parámetros de la contraparte, montos operados, estado de ejecución y detalles de configuración del pago.

ENDPOINT

POST /sapi/v1/c2c/orderMatch/getUserOrderDetail

Autenticación USER_DATA / SIGNED

Grupo API C2C / Order Match

Método POST

Respuesta JSON

Descripción General

Este endpoint devuelve el estado integral del ciclo de vida y las propiedades de transacción de una orden C2C (P2P) individual a partir de su número identificador (adOrderNo). Proporciona métricas de emparejamiento, volumen y precios ejecutados, apodos de compradores y vendedores, y las cuentas de pago vinculadas.

Sistemas de trading automatizado, scripts de conciliación contable y servicios receptores de webhooks utilizan este endpoint para confirmar los requisitos de pago entrante, supervisar las acciones de la contraparte y validar la finalización exitosa de las operaciones.

Reglas de Privacidad de Datos de Pago

• Órdenes Completadas (≤ 90 días de antigüedad): Se devuelven el nombre completo del método de pago, los números de cuenta bancaria y los detalles de transferencia sin censura.
• Órdenes Canceladas u Órdenes con > 90 días de antigüedad: Solo se devuelve el nombre del canal de pago; los campos sensibles de la cuenta receptora se enmascaran por seguridad.

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`).
`adOrderNo`	Body	STRING	Requerido	Identificador único del número de orden C2C cuyos detalles se desean consultar.
`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.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para consultar los detalles de la orden.

cURL BASH

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

Respuesta

Ejemplo de respuesta devuelta tras una ejecución exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "orderNumber": "202608161234567890",
        "advNo": "1122334455667788",
        "tradeType": "BUY",
        "asset": "USDT",
        "fiat": "USD",
        "fiatSymbol": "$",
        "amount": "100.00",
        "totalPrice": "101.50",
        "unitPrice": "1.015",
        "orderStatus": "COMPLETED",
        "createTime": 1786953600000,
        "counterPartNickName": "CryptoTraderPro",
        "payMethods": [
            {
                "payId": 123456,
                "payType": "BANK",
                "payMethodName": "Bank Transfer",
                "fields": {
                    "account": "1234567890",
                    "bankName": "Chase Bank"
                }
            }
        ]
    },
    "success": true
}

Campos de la Respuesta

Campo	Tipo	Descripción
`code`	STRING	Código de respuesta estándar de Binance (`"000000"` indica éxito).
`data.orderNumber`	STRING	Identificador único de la orden de intercambio C2C.
`data.advNo`	STRING	Número del anuncio C2C a partir del cual se generó la orden.
`data.tradeType`	STRING	Sentido de la operación desde la perspectiva del usuario (`BUY` o `SELL`).
`data.asset`	STRING	Criptoactivo negociado en la transacción (por ejemplo, `USDT`, `BTC`).
`data.fiat`	STRING	Código ISO de la moneda fiduciaria de pago (por ejemplo, `USD`, `VES`, `COP`).
`data.fiatSymbol`	STRING	Símbolo monetario de la divisa fiat de liquidación (por ejemplo, `$`, `Bs.`).
`data.amount`	STRING	Volumen total de criptomoneda involucrado en la transacción.
`data.totalPrice`	STRING	Monto total en moneda fiduciaria que debe pagarse o recibirse.
`data.unitPrice`	STRING	Precio efectivo pactado por cada unidad de criptoactivo.
`data.orderStatus`	STRING	Estado actual de la orden (por ejemplo, `TRADING`, `BUYER_PAYED`, `COMPLETED`, `CANCELLED`).
`data.createTime`	LONG	Marca de tiempo en milisegundos Unix correspondiente a la creación de la orden.
`data.counterPartNickName`	STRING	Apodo público visible de la contraparte involucrada en el intercambio.
`data.payMethods`	ARRAY	Lista de métodos de pago configurados y admitidos para liquidar la orden.

Cómo Funciona

Flujo de trabajo para consultar los detalles individuales de una orden C2C.

01 Identificar Orden Define el número de orden (adOrderNo) en el payload JSON.

02 Enviar Solicitud Emite el POST hacia /sapi/v1/c2c/orderMatch/getUserOrderDetail.

03 Analizar Datos Extrae el estado operativo, precio total y cuentas de destino.

04 Disparar Acciones Ejecuta la transferencia bancaria o procede a liberar activos.

Casos de Uso Comunes

Emparejamiento Automatizado de Pagos

Inspecciona los números de cuenta y el banco receptor del vendedor para emitir transferencias bancarias de salida vía API de forma inmediata.

Monitoreo y Sincronización de Estados

Consulta periódicamente la transición de estados de las órdenes para mantener sincronizadas tus bases de datos y registros ERP internos.

Conciliación y Soporte de Disputas

Audita montos exactos, comisiones y datos del titular de la contraparte ante discrepancias de pago o apelaciones formales.