Consulta los atributos base del perfil C2C (P2P) del usuario autenticado, incluyendo apodo público, número de usuario, nivel de verificación KYC y privilegios de comerciante.
/sapi/v1/c2c/user/baseDetailEste endpoint proporciona la información central del perfil de cuenta para el usuario autenticado en Binance P2P. Devuelve metadatos operativos esenciales, tales como el apodo público visible, el número de usuario (userNo), indicadores de verificación telefónica y de correo, el nivel de certificación de identidad (KYC) y el estatus de comerciante verificado.
Sistemas de trading automatizado y herramientas de gestión comercial invocan este endpoint durante el arranque inicial de sus procesos para confirmar los permisos de la cuenta y verificar las facultades operativas antes de iniciar sesiones activas de intercambio o actualización de anuncios.
01
Parámetros de encabezado (Header) aceptados por el endpoint.
| Encabezado | Tipo | Requerido | Descripción |
|---|---|---|---|
clientType | STRING | Requerido | Tipo de dispositivo o cliente que realiza la consulta (por ejemplo, WEB, APP o WEB_MOBILE). |
x-gray-env | STRING | Opcional | Identificador de entorno utilizado internamente para pruebas o despliegues controlados (gray testing). |
x-trace-id | STRING | Opcional | Identificador de trazabilidad generado por el cliente para el seguimiento y depuración de la solicitud. |
x-user-id | STRING | Opcional | Identificador de usuario objetivo si se requiere evaluar el contexto de la cuenta. |
Petición HTTP POST sin Cuerpo (Body)
No se requiere enviar una carga útil JSON en el cuerpo. Únicamente debes especificar el encabezado obligatorio clientType dentro de las cabeceras HTTP junto a las credenciales habituales de autenticación firmada (signature y timestamp).
02
Ejemplo de solicitud POST mediante cURL para consultar los detalles de perfil del usuario.
curl -X POST \
'https://api.binance.com/sapi/v1/c2c/user/baseDetail' \
-H 'clientType: WEB'03
Ejemplo de respuesta devuelta tras consultar exitosamente los atributos de la cuenta.
{
"code": "000000",
"message": "success",
"data": {
"userNo": "s1234567890abcdef",
"nickName": "MerchantAlpha",
"email": "user@example.com",
"mobile": "+1234567890",
"kycStatus": 1,
"kycLevel": "VERIFIED_PLUS",
"isMerchant": true,
"merchantLevel": 2,
"userStatus": 1
},
"success": true
}| 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.userNo | STRING | Identificador interno único asignado al usuario en Binance P2P. |
data.nickName | STRING | Apodo público visible dentro de la plataforma de comercio C2C. |
data.kycStatus | INT | Indicador de estado de la verificación de identidad (1 indica verificado). |
data.kycLevel | STRING | Nivel de certificación KYC alcanzado (por ejemplo, VERIFIED, VERIFIED_PLUS). |
data.isMerchant | BOOLEAN | Indica si la cuenta cuenta con privilegios activos de comerciante en Binance P2P. |
data.merchantLevel | INT | Rango o nivel de comerciante asignado (por ejemplo, 1: Comerciante Verificado, 2: Comerciante VIP). |
data.userStatus | INT | Estado operativo general de la cuenta (1: Normal / Activo). |
success | BOOLEAN | Indica el resultado general de la ejecución de la petición. |
04
Flujo de trabajo para consultar el perfil base de la cuenta.
Verificación Previa en Bots de Trading
Comprueba de forma automática el estatus de comerciante y el nivel de KYC antes de lanzar algoritmos de arbitraje o reposicionamiento de precios.
Perfil en Paneles de Administración
Despliega apodos públicos, niveles de verificación e insignias de comerciante VIP dentro de consolas de control y dashboards empresariales.
Auditoría Multicuenta
Supervisa permisos operativos e identidades verificadas a lo largo de múltiples instancias de claves API y cuentas de comercio.