Saltar al contenido principal

Manteca - Validaciones

Endpoints para validación de monedas y pares soportados en Manteca.

1. Obtener Monedas/Pares Soportados​

GET /manteca/supported-coins

Obtiene la lista de pares de monedas soportados por Manteca.

Headers:

Authorization: Bearer <JWT_TOKEN>

Respuesta Exitosa (200):

{
  "success": true,
  "data": [
    "DAI_ARS",
    "DAI_USD",
    "USDT_ARS",
    "USDC_ARS"
  ],
  "message": "Monedas soportadas obtenidas exitosamente de Manteca"
}

2. Validar Moneda Individual​

GET /manteca/validate-coin/:coin

Valida si una moneda específica está soportada por Manteca.

Parámetros:

  • coin (string): Código de la moneda

Headers:

Authorization: Bearer <JWT_TOKEN>

Ejemplo de Solicitud:

GET /manteca/validate-coin/DAI

Respuesta Exitosa (200):

{
  "success": true,
  "data": {
    "coin": "DAI",
    "isSupported": true
  },
  "message": "Moneda DAI está soportada por Manteca"
}

Respuesta de Moneda No Soportada (200):

{
  "success": true,
  "data": {
    "coin": "BTC",
    "isSupported": false
  },
  "message": "Moneda BTC NO está soportada por Manteca"
}

3. Validar Par de Monedas​

GET /manteca/validate-pair/:pair

Valida si un par de monedas está soportado por Manteca.

Parámetros:

  • pair (string): Par de monedas (ej: DAI_ARS)

Headers:

Authorization: Bearer <JWT_TOKEN>

Ejemplo de Solicitud:

GET /manteca/validate-pair/DAI_ARS

Respuesta Exitosa (200):

{
  "success": true,
  "data": {
    "pair": "DAI_ARS",
    "isSupported": true,
    "invalidCoins": []
  },
  "message": "Par DAI_ARS está completamente soportado por Manteca"
}

Respuesta de Par No Soportado (200):

{
  "success": true,
  "data": {
    "pair": "USD_DAI",
    "isSupported": false,
    "invalidCoins": ["USD_DAI"]
  },
  "message": "Par USD_DAI tiene monedas no soportadas: USD_DAI"
}

4. Validar Múltiples Monedas​

POST /manteca/validate-coins

Valida múltiples monedas a la vez.

Headers:

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

Body:

{
  "coins": ["BTC", "ETH", "DAI", "ARS"]
}

Respuesta Exitosa (200):

{
  "success": true,
  "data": {
    "coins": ["BTC", "ETH", "DAI", "ARS"],
    "allSupported": false,
    "supportedCoins": ["DAI"],
    "unsupportedCoins": ["BTC", "ETH", "ARS"]
  },
  "message": "Algunas monedas no están soportadas: BTC, ETH, ARS"
}

Respuesta de Error (400):

{
  "message": "Se requiere un array de monedas",
  "error": "Bad Request",
  "statusCode": 400
}

🔍 Guía de Validación​

Monedas Soportadas​

  • ✅ DAI - Stablecoin
  • ✅ USDT - Tether
  • ✅ USDC - USD Coin
  • ✅ ARS - Pesos Argentinos
  • ✅ USD - Dólares Americanos

Monedas NO Soportadas​

  • ❌ BTC - Bitcoin
  • ❌ ETH - Ethereum
  • ❌ EUR - Euros
  • ❌ BRL - Real Brasileño

Pares Válidos​

  • ✅ DAI_ARS
  • ✅ DAI_USD
  • ✅ USDT_ARS
  • ✅ USDC_ARS

Pares Inválidos​

  • ❌ BTC_ARS
  • ❌ ETH_USD
  • ❌ ARS_USD

🛡️ Validación Antes de Trading​

Flujo Recomendado​

  1. Validar Par: GET /manteca/validate-pair/DAI_ARS
  2. Verificar Precio: GET /manteca/price/DAI_ARS
  3. Crear Lock: POST /manteca/order/lock
  4. Ejecutar Orden: POST /manteca/order/execute

Ejemplo de Validación Completa​

// 1. Validar par
const validation = await fetch('/manteca/validate-pair/DAI_ARS');
if (!validation.data.isSupported) {
  throw new Error('Par no soportado');
}

// 2. Obtener precio actual
const price = await fetch('/manteca/price/DAI_ARS');

// 3. Proceder con el trading
const lock = await fetch('/manteca/order/lock', {
  method: 'POST',
  body: JSON.stringify({
    coin: 'DAI_ARS',
    operation: 'BUY'
  })
});

⚠️ Errores Comunes​

  • 400 Bad Request: Array de monedas faltante o formato inválido
  • 404 Not Found: Moneda o par no encontrado
  • 401 Unauthorized: Token JWT inválido

📝 Notas​

  • Las validaciones son case-insensitive pero se devuelven en mayúsculas
  • Los pares deben estar en formato MONEDA1_MONEDA2
  • Las validaciones no garantizan liquidez, solo soporte técnico
  • Siempre validar antes de crear locks de precio