Saltar al contenido principal

Manteca - Precios

Endpoints para consultar precios actuales de pares soportados en Manteca y obtener series históricas con timeframes configurables.

📌 Qué podés hacer con estos endpoints

Consultar precios actuales de pares (buy/sell/spread) y descargar histórico (OHLCV) por timeframe. Requiere autenticación vía JWT.

1) Obtener Precios Actuales​

GET/manteca/prices

Obtiene los precios actuales de todas las criptomonedas/pares en Manteca

📤 Respuesta

{
"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"
}

Headers:

Authorization: Bearer <JWT_TOKEN>

2) Obtener Precio de un Par Específico​

GET/manteca/price/:pair

Obtiene el precio actual de un par específico

📋 Parámetros

pairstringrequerido

Par de monedas (ej: DAI_ARS, DAI_USD)

📤 Respuesta

{
"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"
}

Headers:

Authorization: Bearer <JWT_TOKEN>

Ejemplo de solicitud:

GET /manteca/price/DAI_ARS

Par no soportado (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 (OHLCV) de un par específico

📋 Parámetros

pairstringrequerido

Par de monedas (ej: DAI_ARS)

timeframestring

Periodo de tiempo (hourly, daily, weekly, monthly). Default: daily

📤 Respuesta

{
"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"
}

Headers:

Authorization: Bearer <JWT_TOKEN>

Ejemplo de solicitud:

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

📊 Timeframes Disponibles​

Timeframes soportados

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",      
  "sell": "1248.25",     
  "spread": "2.50",      
  "lastUpdate": "2024-01-15T10:30:00Z"
}

📉 Estructura de Datos Históricos​

{
  "date": "2024-01-15",
  "open": "1248.00",
  "close": "1250.75",
  "high": "1252.00",
  "low": "1247.50",
  "volume": "15000.00"
}

⚠️ Errores Comunes​

Errores típicos

  • 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​

Comportamiento y consideraciones

  • 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
  • El timeframe por defecto es daily si no se especifica