BINANCE SAPI · C2C

API para Verificar si Puede Crear Orden

Valida previamente la elegibilidad del usuario, las condiciones comerciales exigidas por la contraparte y el estado del anuncio antes de iniciar una orden peer-to-peer (C2C/P2P).

ENDPOINT

POST /sapi/v1/c2c/orderMatch/checkIfCanPlaceOrder

Autenticación USER_DATA / SIGNED

Grupo API C2C / Order Match

Método POST

Respuesta JSON

Descripción General

Este endpoint comprueba si un usuario autenticado cumple con todos los requisitos necesarios para colocar una orden contra un anuncio peer-to-peer específico (adOrderNo). Verifica niveles requeridos de verificación de identidad (KYC), restricciones geográficas o por país, tasa mínima de órdenes completadas, antigüedad de la cuenta y límites de liquidez remanente fijados por el creador del anuncio.

Sistemas de trading automatizado, aplicaciones móviles y paneles web ejecutan esta validación previa para evitar rechazos en la colocación de órdenes, optimizar la tasa de conversión y prevenir bloqueos temporales por intentos fallidos.

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 anuncio contra el cual se desea comprobar la elegibilidad operativa.
`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.

Buena Práctica de Verificación Previa

Ejecuta esta verificación siempre que un usuario seleccione un anuncio o justo antes de enviar la orden definitiva de intercambio. Así garantizas que la oferta continúe activa y que el perfil cumpla todas las reglas del comerciante.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para verificar la elegibilidad de creación de orden.

cURL BASH

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

Respuesta

Ejemplo de respuesta devuelta tras una comprobación exitosa.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": true,
    "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`	BOOLEAN	Devuelve `true` si el usuario está habilitado para colocar una orden en este anuncio; devuelve `false` en caso contrario.
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para validar la elegibilidad antes de colocar una orden C2C.

01 Seleccionar Anuncio Obtén el identificador del aviso objetivo (adOrderNo).

02 Enviar Validación Emite el POST con adOrderNo a /checkIfCanPlaceOrder.

03 Evaluar Reglas Comprueba nivel KYC, tasa de órdenes y saldo disponible en el anuncio.

04 Proceder con la Orden Abre el formulario de compra/venta o dispara la orden en tu bot.

Casos de Uso Comunes

Validación de Botones en la Interfaz

Habilita o deshabilita dinámicamente los botones de "Comprar" o "Vender" en listados de ofertas P2P según los permisos del usuario.

Optimización de Bots de Arbitraje

Descarta al instante anuncios restringidos o incompatibles antes de intentar enviar peticiones de compra automatizada.

Comprobación Previa de Requisitos

Verifica anticipadamente el cumplimiento de filtros de la contraparte, tales como cantidad mínima de órdenes concretadas o días de registro.