API Documentation – Bank Service
Documentación completa del servicio bancario de SwapBits, incluyendo integración con Manteca y Bridge.
🏦 Bank Service
El Bank Service centraliza todas las operaciones financieras de SwapBits: trading cripto, operaciones fiat, cuentas virtuales, KYC y webhooks.
📖 Tabla de Contenidos
🔐 Autenticación
🟡 Manteca API
- Usuarios – Gestión de usuarios en Manteca
- Órdenes – Trading y ejecución de órdenes
- Precios – Precios actuales e históricos
- Validaciones – Validación de monedas y pares
- Fiat – Depósitos y retiros fiat
- Utilidades – Funciones auxiliares
🔵 Bridge API
- Customer – Gestión de customers
- Cuentas Virtuales – IBAN y cuentas USD
- Utilidades – Funciones auxiliares
🔔 Webhooks y Redirecciones
- Webhooks – Eventos en tiempo real
- Redirecciones – Rutas de redirección
❌ Códigos de Error
- Códigos de Error – Lista completa de errores
🔐 Autenticación
JWT requerido
Todos los endpoints (excepto webhooks y redirecciones) requieren autenticación mediante JWT.
Header requerido
Authorization: Bearer <JWT_TOKEN>
Content-Type: application/json
🌟 Características Principales
Integración con Manteca
- Gestión completa de usuarios
- Trading de criptomonedas
- Locks de precio (10 segundos)
- Depósitos y retiros fiat (ARS)
- Validación de monedas y pares
- Históricos de precios
Integración con Bridge
- Gestión de customers KYC
- Cuentas virtuales USD
- IBAN EUR
- Webhooks en tiempo real
Funcionalidades generales
- Autenticación JWT
- Paginación en listados
- Manejo de errores estandarizado
- Webhooks para eventos
- Documentación completa de códigos de respuesta
🚀 Inicio rápido
Primeros pasos
- Obtener token JWT desde el sistema de autenticación
- Crear usuario en Manteca →
POST /manteca/create - Generar ToS en Bridge →
GET /bridge/generate-tos - Consultar precios →
GET /manteca/prices - Crear orden →
POST /manteca/order/lock→POST /manteca/order/execute
📝 Notas importantes
Consideraciones técnicas
- ⏱️ Los locks de precio expiran en 10 segundos
- 📄 Endpoints de listado soportan paginación (
page,limit) - 🕒 Fechas en formato ISO 8601
- 💱 Monedas son case-insensitive (se devuelven en mayúsculas)
- 🚦 Rate limiting aplicado según endpoint
Documentación oficial
Documentación generada automáticamente para el SwapBits – Bank Service API.