BINANCE SAPI · C2C

API para Crear Orden

Inicia y ejecuta una nueva orden de intercambio peer-to-peer (C2C/P2P) contra un anuncio activo, bloqueando los activos en custodia (escrow) y dando inicio a la liquidación entre contrapartes.

ENDPOINT

POST /sapi/v1/c2c/orderMatch/placeOrder

Autenticación USER_DATA / SIGNED

Grupo API C2C / Order Match

Método POST

Respuesta JSON

Descripción General

Este endpoint coloca una nueva orden comercial contra un anuncio peer-to-peer específico (advOrderNumber). Las órdenes pueden calcularse definiendo la cantidad exacta de criptomonedas deseadas (BY_AMOUNT) o el importe total en dinero fiduciario a pagar (BY_MONEY).

Al confirmarse la creación, el volumen correspondiente de criptomonedas queda bloqueado en el depósito de garantía (escrow) de Binance, se inician los temporizadores de pago y se establece una sesión activa de emparejamiento entre comprador y vendedor.

⚡

Solución Lista para Usar

¿Buscas automatizar la ejecución de órdenes al mejor precio del mercado? Conoce nuestro Bot de Trading Binance P2P — software automatizado para Binance que ofrece compra automática instantánea, soporte multidivisa/bancario y alertas por Telegram.

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`).
`advOrderNumber`	Body	STRING	Requerido	Número de identificación único del anuncio contra el cual se colocará la orden.
`asset`	Body	STRING	Requerido	Símbolo del criptoactivo a operar (por ejemplo, `USDT`, `BTC`).
`fiatUnit`	Body	STRING	Requerido	Símbolo de la divisa fiduciaria de pago (por ejemplo, `USD`, `VES`, `COP`, `ARS`).
`tradeType`	Body	STRING	Requerido	Sentido de la transacción (`BUY` para compra o `SELL` para venta).
`buyType`	Body	STRING	Requerido	Modo de cálculo de la orden: `BY_AMOUNT` (por cantidad de cripto) o `BY_MONEY` (por importe en dinero fiat).
`totalAmount`	Body	DECIMAL / DOUBLE	Requerido	Valor total a operar expresado en unidades cripto o en dinero fiduciario (según lo definido en `buyType`).
`matchPrice`	Body	DECIMAL / DOUBLE	Opcional	Precio unitario esperado de ejecución para protegerse del deslizamiento (slippage) durante el envío de la orden.
`payId`	Body	LONG	Opcional	Identificador del método de pago preferido seleccionado por el vendedor.
`payType`	Body	STRING	Opcional	Nombre del canal o tipo de método de pago (por ejemplo, `BANK`, `SPECIFIC_PAYMENT_NAME`).
`origin`	Body	STRING	Opcional	Etiqueta de origen para el seguimiento del canal de procedencia de la orden.
`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.

Protección Contra Deslizamiento de Precio (Slippage)

Enviar el parámetro matchPrice garantiza que la orden solo se ejecutará si el precio unitario del anuncio coincide exactamente con tu cotización objetivo, evitando variaciones indeseadas generadas por algoritmos de precio flotante.

Ejemplo de Solicitud

Ejemplo de solicitud POST mediante cURL para comprar 100 USDT a un precio fijado.

cURL BASH

curl -X POST \
'https://api.binance.com/sapi/v1/c2c/orderMatch/placeOrder' \
-H 'clientType: WEB' \
-H 'Content-Type: application/json' \
-d '{
  "advOrderNumber": "1122334455667788",
  "asset": "USDT",
  "fiatUnit": "USD",
  "tradeType": "BUY",
  "buyType": "BY_AMOUNT",
  "totalAmount": 100.00,
  "matchPrice": 1.015,
  "payType": "BANK"
}'

Respuesta

Ejemplo de respuesta devuelta tras la creación exitosa de la orden.

RESPONSE 200 OK

{
    "code": "000000",
    "message": "success",
    "data": {
        "orderNumber": "202608161234567890",
        "advNo": "1122334455667788",
        "tradeType": "BUY",
        "asset": "USDT",
        "fiat": "USD",
        "amount": "100.00",
        "totalPrice": "101.50",
        "unitPrice": "1.015",
        "orderStatus": "TRADING",
        "createTime": 1786953600000
    },
    "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.orderNumber`	STRING	Número de identificación único asignado a la nueva orden comercial C2C.
`data.totalPrice`	STRING	Monto total en dinero fiduciario a transferir o recibir en la operación.
`data.amount`	STRING	Volumen total del activo digital bloqueado en el depósito de garantía (escrow).
`data.orderStatus`	STRING	Estado inicial de la orden (habitualmente `TRADING`).
`success`	BOOLEAN	Indica el resultado general de la ejecución de la petición.

Cómo Funciona

Flujo de trabajo para colocar una orden de intercambio C2C.

01 Elegir Anuncio y Modo Indica advOrderNumber y selecciona BY_AMOUNT o BY_MONEY.

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

03 Bloqueo en Garantía El exchange retiene las criptomonedas de forma segura en custodia.

04 Iniciar Liquidación Se genera la orden y se activa la cuenta regresiva para el pago.

Casos de Uso Comunes

Bots de Compra Automática por Arbitraje

Ejecuta órdenes inmediatas contra publicaciones de la competencia cuando las brechas de spread superan los umbrales de rentabilidad configurados.

Portales de Pago y Checkout Personalizados

Permite a los usuarios de tu plataforma comprar criptoactivos integrando flujos directos de emparejamiento P2P en tu propia web.

Reabastecimiento Automatizado de Liquidez

Coloca órdenes de compra programadas para recomponer el capital de trabajo de tus anuncios cuando el inventario cae por debajo del mínimo.

Automatización de Compra Rápida

Toma anuncios con cotización preferencial en milisegundos sin intervención humana ni retrasos de interfaz manual.
Descubre nuestro Bot P2P →