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.
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.
query = "asset=USDT&fiat=USD×tamp=1700000000000" sig = hmac_sha256(secret, query)
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.
SAPI v7.4
Versión OficialVersió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
POST /sapi/v1/c2c/chat/getRiskWarningTipsAdvertencia de riesgo en chat antes de la orden
POST /sapi/v1/c2c/chat/image/pre-signed-urlURL pre-firmada de S3 para subida de imágenes
GET /sapi/v1/c2c/chat/retrieveChatCredentialCredencial WebSocket para chat en tiempo real
GET /sapi/v1/c2c/chat/retrieveChatMessagesWithPaginationHistorial de chat paginado
POST /sapi/v1/c2c/commission-rate/overviewResumen de tasas de comisión
POST /sapi/v1/c2c/commission-rate/takerTasa de comisión del taker
Modificados — 1 endpoint
POST /sapi/v1/c2c/ads/updatePatró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.
Seguimiento de Cambios Futuros
Las siguientes son áreas conocidas donde Binance podría introducir cambios importantes. Monitorear al actualizar:
Codificación de firma
La aplicación del percent-encoding está en despliegue. Ver cambio importante arriba.
Ruta URL de EP-37
AutoP2P usa /user/getPayMethodByUserId (POST). El PDF documenta /paymentMethod/getPayMethodByUserId (GET). Monitorear deprecación de alguna de las rutas.
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.
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.