Saltar al contenido principal

Manteca - Precios

Endpoints para la consulta de precios y datos históricos en Manteca.

1. Obtener Precios Actuales​

GET /manteca/prices

Obtiene los precios actuales de todas las criptomonedas en Manteca.

Headers:

Authorization: Bearer <JWT_TOKEN>

Respuesta Exitosa (200):

{
  "success": true,
  "data": {
    "prices": [
      {
        "pair": "DAI_ARS",
        "buy": "1250.75",
        "sell": "1248.25",
        "lastUpdate": "2024-01-15T10:30:00Z"
      },
      {
        "pair": "DAI_USD", 
        "buy": "1.001",
        "sell": "0.999",
        "lastUpdate": "2024-01-15T10:30:00Z"
      }
    ]
  },
  "message": "Precios obtenidos exitosamente de Manteca"
}

2. Obtener Precio de un Par Específico​

GET /manteca/price/:pair

Obtiene el precio actual de un par específico.

Parámetros:

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

Headers:

Authorization: Bearer <JWT_TOKEN>

Ejemplo de Solicitud:

GET /manteca/price/DAI_ARS

Respuesta Exitosa (200):

{
  "success": true,
  "data": {
    "pair": "DAI_ARS",
    "buy": "1250.75",
    "sell": "1248.25",
    "spread": "2.50",
    "lastUpdate": "2024-01-15T10:30:00Z"
  },
  "message": "Precio de DAI_ARS obtenido exitosamente"
}

Respuesta de Error (400):

{
  "message": "Monedas no soportadas en el par USD_DAI: USD_DAI",
  "error": "Bad Request",
  "statusCode": 400
}

3. Obtener Histórico de Precios​

GET /manteca/price/:pair/history

Obtiene el histórico de precios de un par específico.

Parámetros:

  • pair (string): Par de monedas
  • timeframe (query, opcional): Periodo de tiempo (daily, hourly, etc.) - Por defecto: daily

Headers:

Authorization: Bearer <JWT_TOKEN>

Ejemplo de Solicitud:

GET /manteca/price/DAI_ARS/history?timeframe=daily

Respuesta Exitosa (200):

{
  "success": true,
  "data": {
    "pair": "DAI_ARS",
    "timeframe": "daily",
    "history": [
      {
        "date": "2024-01-15",
        "open": "1248.00",
        "close": "1250.75",
        "high": "1252.00",
        "low": "1247.50",
        "volume": "15000.00"
      },
      {
        "date": "2024-01-14",
        "open": "1245.00",
        "close": "1248.00",
        "high": "1249.00",
        "low": "1244.00",
        "volume": "12500.00"
      }
    ]
  },
  "message": "Histórico de precios de DAI_ARS obtenido exitosamente de Manteca"
}

📊 Timeframes Disponibles​

TimeframeDescripciónEjemplo
hourlyDatos por hora?timeframe=hourly
dailyDatos diarios (por defecto)?timeframe=daily
weeklyDatos semanales?timeframe=weekly
monthlyDatos mensuales?timeframe=monthly

💱 Pares Soportados​

Principales​

  • DAI_ARS - DAI a Pesos Argentinos
  • DAI_USD - DAI a Dólares
  • USDT_ARS - USDT a Pesos Argentinos
  • USDC_ARS - USDC a Pesos Argentinos

Formato de Par​

  • Formato: TOKEN_FIAT (ej: DAI_ARS)
  • Case insensitive pero se devuelve en mayúsculas
  • Separados por guión bajo _

📈 Estructura de Datos de Precio​

{
  "pair": "DAI_ARS",
  "buy": "1250.75",      // Precio de compra
  "sell": "1248.25",     // Precio de venta
  "spread": "2.50",      // Diferencia buy-sell
  "lastUpdate": "2024-01-15T10:30:00Z"
}

📉 Estructura de Datos Históricos​

{
  "date": "2024-01-15",
  "open": "1248.00",     // Precio de apertura
  "close": "1250.75",    // Precio de cierre
  "high": "1252.00",     // Precio máximo
  "low": "1247.50",      // Precio mínimo
  "volume": "15000.00"   // Volumen de trading
}

⚠️ Errores Comunes​

  • 400 Bad Request: Par de monedas no soportado
  • 404 Not Found: No hay datos para el par solicitado
  • 401 Unauthorized: Token JWT inválido

📝 Notas​

  • Los precios se actualizan en tiempo real
  • El spread es la diferencia entre precio de compra y venta
  • Los datos históricos están disponibles desde la fecha de implementación
  • Timeframe por defecto es daily si no se especifica