Saltar al contenido principal

Changelog

Historial de versiones SAPI, cambios importantes y actualizaciones de la API. Las entradas se rastrean desde el PDF oficial SAPI v7.4 y se complementan con descubrimientos en producción.

Cambio Importante

2026 — Requerido Percent-Encoding en Firmas HMAC

Binance ahora requiere que los parámetros del query string sean percent-encoded antes de calcular la firma HMAC-SHA256. Anteriormente, los query strings en bruto se firmaban directamente.

ANTIGUO (roto desde 2026)
query = "asset=USDT&fiat=USD&timestamp=1700000000000"
sig = hmac_sha256(secret, query)
NUEVO (requerido desde 2026)
query = urllib.parse.urlencode(params)
sig = hmac_sha256(secret, query)
# urlencode gestiona el percent-encoding

Impacto: todos los endpoints firmados con HMAC (auth: hmac, adaptive). Los endpoints con auth solo por headers o sin auth no se ven afectados. AutoP2P usa urllib.parse.urlencode() que es compatible.

2024-05-08

SAPI v7.4

Versión Oficial

Versión 7.4 del PDF de documentación SAPI de Binance C2C. Es la versión oficial más reciente utilizada como referencia principal para este sitio de documentación.

Añadidos — 6 nuevos endpoints

EP-29
POST /sapi/v1/c2c/chat/getRiskWarningTips

Advertencia de riesgo en chat antes de la orden

EP-30
POST /sapi/v1/c2c/chat/image/pre-signed-url

URL pre-firmada de S3 para subida de imágenes

EP-33
GET /sapi/v1/c2c/chat/retrieveChatCredential

Credencial WebSocket para chat en tiempo real

EP-34
GET /sapi/v1/c2c/chat/retrieveChatMessagesWithPagination

Historial de chat paginado

EP-41
POST /sapi/v1/c2c/commission-rate/overview

Resumen de tasas de comisión

EP-42
POST /sapi/v1/c2c/commission-rate/taker

Tasa de comisión del taker

Modificados — 1 endpoint

EP-7
POST /sapi/v1/c2c/ads/update

Patrón de actualización solo-precio documentado: enviar únicamente advNo + price elimina el error 187049. Incluir surplusAmount en la misma solicitud dispara errores de sincronización de volumen.

Eliminados — 7 endpoints

Los siguientes endpoints fueron deprecados y eliminados en v7.4. Pueden seguir respondiendo en versiones antiguas de la API de Binance pero no deben usarse en nuevas integraciones.

GET /sapi/v1/c2c/ads/getAdsByToken
POST /sapi/v1/c2c/ads/batchUpdateStatus
POST /sapi/v1/c2c/orderMatch/getUserInfo
POST /sapi/v1/c2c/orderMatch/completeOrder
GET /sapi/v1/c2c/merchant/getMerchantInfo
POST /sapi/v1/c2c/chat/sendMessage
POST /sapi/v1/c2c/chat/getMessages

Seguimiento de Cambios Futuros

Las siguientes son áreas conocidas donde Binance podría introducir cambios importantes. Monitorear al actualizar:

activo

Codificación de firma

La aplicación del percent-encoding está en despliegue. Ver cambio importante arriba.

vigilar

Ruta URL de EP-37

AutoP2P usa /user/getPayMethodByUserId (POST). El PDF documenta /paymentMethod/getPayMethodByUserId (GET). Monitorear deprecación de alguna de las rutas.

vigilar

Endpoints con auth adaptativa

EP-13 y EP-24 usan auth adaptativa (intenta HMAC, fallback a api-key, luego headers). Binance podría estandarizar los requisitos de auth.

vigilar

Endpoint de búsqueda BAPI (EP-0)

p2p.binance.com/bapi/c2c/v2 es un endpoint público no documentado. Sin garantía de SLA. Puede requerir stealth headers para evitar rate limiting.