BINANCE SAPI · C2C

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

Consulta órdenes comerciales peer-to-peer (C2C/P2P) históricas y activas con soporte de paginación y filtros avanzados por rangos de fecha, sentido de operación, criptoactivos y códigos de estado.

ENDPOINT

POST /sapi/v1/c2c/orderMatch/listOrders

Autenticación USER_DATA / SIGNED

Grupo API C2C / Order Match

Método POST

Respuesta JSON (Paginado)

Descripción General

Este endpoint permite a bots de trading, plataformas contables y paneles de comerciantes consultar listas paginadas de órdenes en Binance C2C (P2P). Ofrece un conjunto completo de filtros de consulta, tales como número de anuncio original (advNo), criptomoneda (asset), sentido comercial (BUY/SELL), marcas de tiempo de inicio y fin, y múltiples códigos de estado simultáneos.

Motores de conciliación automatizados consultan periódicamente este endpoint para mantener sincronizado el ciclo de vida de las órdenes P2P con bases de datos y libros contables externos.

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`).
`page`	Body	INT	Opcional	Número de página a consultar para la paginación (inicia en `1`).
`rows`	Body	INT	Opcional	Cantidad de registros devueltos por página (por defecto `10` o `20`; máximo `100`).
`asset`	Body	STRING	Opcional	Filtro por símbolo del criptoactivo (por ejemplo, `USDT`, `BTC`).
`tradeType`	Body	STRING	Opcional	Filtro por sentido de la orden (`BUY` o `SELL`).
`advNo`	Body	STRING	Opcional	Filtro para recuperar únicamente órdenes originadas a partir de un anuncio específico.
`orderStatus`	Body	INT	Opcional	Código numérico de estado individual (por ejemplo, `1`: En Proceso, `4`: Completada, `5`: Cancelada).
`orderStatusList`	Body	ARRAY[INT]	Opcional	Arreglo de códigos de estado para consultar múltiples estados operativos de forma simultánea.
`startDate`	Body	LONG	Opcional	Marca de tiempo inicial de búsqueda expresada en milisegundos Unix.
`endDate`	Body	LONG	Opcional	Marca de tiempo final de búsqueda expresada en milisegundos Unix.
`payType`	Body	INT	Opcional	Filtro por código numérico del método de pago utilizado.
`sort`	Body	STRING	Opcional	Campo utilizado para ordenar los resultados (por ejemplo, `createTime`).
`order`	Body	STRING	Opcional	Dirección de ordenamiento de los registros (`ASC` o `DESC`).
`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.

Flexibilidad en Filtros de Estado

Puedes enviar un único código de estado mediante orderStatus o consultar varios estados al mismo tiempo (como órdenes en proceso de pago y órdenes en apelación) utilizando el arreglo orderStatusList.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para consultar órdenes de compra de USDT completadas recientemente.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/orderMatch/listOrders' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "page": 1,
  "rows": 10,
  "asset": "USDT",
  "tradeType": "BUY",
  "orderStatusList": [4],
  "startDate": 1786867200000,
  "endDate": 1786953600000
}'

Respuesta

Ejemplo de respuesta paginada devuelta tras una consulta exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "total": 42,
        "page": 1,
        "rows": 10,
        "data": [
            {
                "orderNumber": "202608161234567890",
                "advNo": "1122334455667788",
                "tradeType": "BUY",
                "asset": "USDT",
                "fiat": "USD",
                "fiatSymbol": "$",
                "amount": "250.00",
                "totalPrice": "253.75",
                "unitPrice": "1.015",
                "orderStatus": 4,
                "createTime": 1786950000000,
                "counterPartNickName": "MerchantAlpha"
            }
        ]
    },
    "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	Cantidad total de órdenes que coinciden con los filtros aplicados en todas las páginas.
`data.page`	INT	Número de página actual devuelto en la respuesta.
`data.rows`	INT	Cantidad de registros devueltos por página.
`data.data`	ARRAY	Arreglo de objetos con los detalles de cada orden C2C encontrada.
`data.data[].orderNumber`	STRING	Identificador único de la orden C2C.
`data.data[].orderStatus`	INT	Código numérico que representa el estado 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 y paginar registros históricos de órdenes C2C.

01 Fijar Criterios Define fechas, activo cripto, estados requeridos y tamaño de página.

02 Emitir Solicitud Envía el POST con el cuerpo JSON a /sapi/v1/c2c/orderMatch/listOrders.

03 Iterar Páginas Incrementa el parámetro page de forma sucesiva hasta cubrir el total.

04 Sincronizar Base de Datos Ingesta las órdenes en tablas contables o registros locales de auditoría.

Casos de Uso Comunes

Exportaciones Contables y Fiscales

Extrae el historial comercial estructurado en periodos específicos para la declaración de impuestos y auditorías financieras.

Conciliación Periódica de Libros

Sincroniza bases de datos externas de comerciantes y sistemas ERP con las órdenes registradas en el historial P2P de Binance.

Análisis de Rendimiento por Anuncio

Filtra las órdenes por un advNo específico para calcular la tasa de llenado y rentabilidad exacta de cada publicación.