Saltar al contenido principal

API Documentation - Bank Service

Documentación completa del servicio bancario de SwapBits que incluye integración con Manteca y Bridge.

📖 Tabla de Contenidos​

🔐 Autenticación​

🟡 Manteca API​

🔵 Bridge API​

🔔 Webhooks y Redirecciones​

❌ Códigos de Error​

🔐 Autenticación​

Todos los endpoints (excepto webhooks y redirecciones) requieren autenticación JWT mediante el header:

Authorization: Bearer <JWT_TOKEN>

Headers comunes​

Authorization: Bearer <JWT_TOKEN>
Content-Type: application/json

🌟 Características Principales​

Integración con Manteca​

  • ✅ Gestión completa de usuarios
  • ✅ Trading de criptomonedas
  • ✅ Sistema de locks de precio (10 segundos)
  • ✅ Transacciones fiat (ARS)
  • ✅ Validación de monedas y pares
  • ✅ Históricos de precios

Integración con Bridge​

  • ✅ Gestión de customers KYC
  • ✅ Cuentas virtuales USD
  • ✅ Cuentas IBAN EUR
  • ✅ Webhooks en tiempo real

Funcionalidades Generales​

  • ✅ Autenticación JWT
  • ✅ Paginación en listados
  • ✅ Manejo de errores estandarizado
  • ✅ Webhooks para eventos en tiempo real
  • ✅ Documentación completa de códigos de respuesta

🚀 Inicio Rápido​

  1. Obtener Token JWT: Usar el sistema de autenticación principal
  2. Crear Usuario en Manteca: POST /manteca/create
  3. Generar ToS en Bridge: GET /bridge/generate-tos
  4. Consultar Precios: GET /manteca/prices
  5. Crear Orden: POST /manteca/order/lock → POST /manteca/order/execute

📝 Notas Importantes​

  • Timeouts: Los locks de precio expiran en 10 segundos
  • Paginación: Usar page y limit en endpoints de listado
  • Fechas: Formato ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ)
  • Monedas: Case-insensitive pero se devuelven en mayúsculas
  • Rate Limiting: Los endpoints pueden tener limitaciones de velocidad

Documentación generada automáticamente para SwapBits Bank Service API