BINANCE SAPI · C2C

API de Historial de Órdenes de Usuario con Paginación

Consulta órdenes comerciales peer-to-peer (C2C/P2P) históricas de forma paginada mediante parámetros en la URL (Query string) para filtrar por sentido de la operación e intervalos temporales.

ENDPOINT

GET /sapi/v1/c2c/orderMatch/listUserOrderHistory

Autenticación USER_DATA / SIGNED

Grupo API C2C / Order Match

Método GET

Respuesta JSON (Paginado)

Descripción General

Este endpoint ofrece una alternativa ligera mediante HTTP GET para obtener órdenes históricas paginadas de Binance C2C (P2P). Permite a desarrolladores y software contable de comerciantes recuperar operaciones anteriores enviando parámetros de consulta en la URL como tradeType, startTimestamp y endTimestamp.

Bots de trading y scripts de auditoría emplean este endpoint para rutinas rápidas de sincronización histórica y exportaciones livianas de registros sin necesidad de estructurar cargas útiles complejas en formato JSON.

Parámetros de la Solicitud

Parámetros aceptados en la URL (Query string) 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`).
`tradeType`	Query	STRING	Opcional	Filtro por sentido de la operación comercial (`BUY` o `SELL`).
`startTimestamp`	Query	INT64	Opcional	Marca de tiempo inicial de búsqueda en milisegundos Unix.
`endTimestamp`	Query	INT64	Opcional	Marca de tiempo final de búsqueda en milisegundos Unix.
`page`	Query	INT32	Opcional	Número de página a consultar para la paginación (inicia en `1`).
`rows`	Query	INT32	Opcional	Cantidad de registros devueltos por página (por defecto `10` o `20`; máximo `100`).
`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.

Estructura de Parámetros en Solicitudes HTTP GET

Todos los parámetros de filtrado y control de paginación deben enviarse directamente en la URL como parámetros de consulta (por ejemplo, ?tradeType=BUY&page=1&rows=20) junto con la cabecera obligatoria clientType.

Ejemplo de Solicitud

Ejemplo de solicitud GET mediante cURL para consultar el historial de operaciones de compra.

cURL BASH

curl -X GET \
'https://api.binance.com/sapi/v1/c2c/orderMatch/listUserOrderHistory?tradeType=BUY&page=1&rows=10&startTimestamp=1786867200000&endTimestamp=1786953600000' \
-H 'clientType: WEB'

Respuesta

Ejemplo de respuesta paginada devuelta tras una consulta exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "total": 35,
        "page": 1,
        "rows": 10,
        "data": [
            {
                "orderNumber": "202608161234567890",
                "advNo": "1122334455667788",
                "tradeType": "BUY",
                "asset": "USDT",
                "fiat": "USD",
                "fiatSymbol": "$",
                "amount": "500.00",
                "totalPrice": "507.50",
                "unitPrice": "1.015",
                "orderStatus": 4,
                "createTime": 1786950000000,
                "counterPartNickName": "TopTraderGlobal"
            }
        ]
    },
    "success": true
}

Campos de la Respuesta

Campo	Tipo	Descripción
`code`	STRING	Código de respuesta estándar de Binance (`"000000"` indica éxito).
`data.total`	INT	Número total de órdenes históricas encontradas según los criterios de búsqueda.
`data.page`	INT	Índice de la página actual devuelta.
`data.rows`	INT	Cantidad de registros devueltos por página.
`data.data`	ARRAY	Lista de objetos con los registros de órdenes históricas C2C.
`data.data[].orderNumber`	STRING	Identificador único de la orden C2C.
`data.data[].orderStatus`	INT	Código numérico que indica el estado final o actual de la orden.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para consultar órdenes históricas C2C mediante GET.

01 Construir URL Agrega marcas de tiempo, tradeType y page a la query string.

02 Emitir Solicitud Llama vía GET a /sapi/v1/c2c/orderMatch/listUserOrderHistory.

03 Procesar Registros Extrae montos, precios acordados y apodos de contraparte.

04 Iterar Paginación Aumenta page de forma sucesiva hasta recuperar el total.

Casos de Uso Comunes

Auditoría Contable y Reportes Fiscales

Recupera órdenes P2P completadas en ventanas trimestrales o anuales para balances contables y justificación de fondos.

Sincronización Ligera para Bots

Consulta transacciones históricas mediante solicitudes GET directas sin la sobrecarga de generar cuerpos JSON.

Análisis Comercial de Comerciante

Calcula volúmenes acumulados de compra y venta junto con los precios unitarios promedio en periodos históricos definidos.