API Documentation

API pública del mercado ganadero argentino. Acceso libre con rate limit por IP. Plan Enterprise (desde USD 99/mes) agrega API key dedicada, mayor cupo, webhooks y soporte. Fuente principal de precios: Mercado Agroganadero (MAG) Cañuelas, cacheado y citado.

Base URL
https://www.consignatarias.com.ar/api
OpenAPI Specification
Especificación completa en formato OpenAPI 3.0openapi.json →
Endpoints
GET/api/remates/stats

Estadísticas generales del mercado: total de remates, distribución por provincia, top consignatarias.

GET/api/remates/hoy

Lista de remates programados para hoy.

GET/api/remates/proximos

Remates de los próximos 7 días. Acepta ?dias=N y ?provincia=X.

GET/api/remates/buscar

Búsqueda de remates por texto, provincia o tipo.

GET/api/remates/calendario

Vista de calendario con remates por día.

GET/api/precios

Índice INMAG actual, precios por categoría y variaciones semanales. Acepta ?categoria=novillos|terneros|etc.

GET/api/precios?detallado=true

Las 16 sub-categorías oficiales de MAG con corte por peso (h390/+390/h430/+430). Devuelve min, max, avg, mediana, cabezas, importe, kgs totales y kg promedio por sub-cat. Actualizado por día de remate (Mar/Mié/Vie). Fuente: haciinfo000502.

GET/api/precios?historico=90

Serie histórica INMAG diaria. Param ?historico=N días (7-3650). Devuelve serie + estadísticas (min/max/avg/count). Histórico completo desde 2015. Fuente: haciinfo000011.

GET/api/accountPRO

Tu cuenta — plan, cupo mensual, uso, remaining y fecha de reset. Bearer auth devuelve metadata de la key usada. Sin Bearer y con cookie de sesión devuelve estado del user logueado. Útil para monitorear desde scripts.

GET/api/market/history

Histórico INMAG con series de precios. Params: ?days=30|90|365 o ?from=YYYY-MM-DD&to=YYYY-MM-DD. Devuelve series + estadísticas (min, max, avg, VWAP).

GET/api/market/categories

Histórico de precios por categoría de hacienda (novillos, novillitos, vacas, vaquillonas, toros). Params: ?category=X&from=YYYY-MM&to=YYYY-MM. 36 meses de datos (2022-2024).

GET/api/consignataria/{slug}

Perfil de una consignataria específica.

GET/api/status

Health check y estadísticas de la API.

GET/api/planes

Lista de planes de suscripción y precios.

GET/api/alertasPRO

Listar alertas configuradas.

POST/api/alertasPRO

Crear nueva alerta de remates.

POST/api/webhooks/registerPRO

Registrar webhook para notificaciones.

Autenticación (Enterprise)

Los endpoints son públicos por default (rate-limited por IP). Si contratás un plan Enterprise recibís una API key con cupo mensual, tracking y soporte:

curl https://www.consignatarias.com.ar/api/precios \
  -H "Authorization: Bearer cnsg_live_xxxxxxxxxxxxxxxx"

Generá y administrá tus keys en /cuenta/api-keys. Cada respuesta autenticada devuelve headers X-RateLimit-Limit y X-RateLimit-Remaining. Al llegar al 80% del cupo mensual te llega un email — no cortamos sin avisar.

Precios detallados (16 sub-categorías)

Además de las 6 categorías genéricas, exponemos la apertura oficial completa de MAG con corte por peso para invernada/gordo: novillos Esp.Joven +430 · Regular h430 · Regular +430, novillitos Esp. h390/+390/Regular, vaquillonas Esp. h390/+390/Regular, vacas Esp.Joven h430/+430/Regular/Conserva Buena/Conserva Inferior, toros Esp./Regular, MEJ Esp. h430/Regular.

Cada sub-categoría devuelve: precio mínimo, máximo, promedio, mediana, cabezas operadas, importe total, kgs totales, kg promedio. Actualizado por día de remate (martes/miércoles/viernes ~15:30 ART). Fuente: MAG haciinfo000502.

curl https://www.consignatarias.com.ar/api/precios?detallado=true

{
  "success": true,
  "data": {
    "fecha": "2026-05-12",
    "subcategorias": [
      {
        "subcategory": "NOVILLOS Esp.Joven + 430",
        "category_group": "novillos",
        "weight_threshold": "esp_joven_plus_430",
        "price_min": 3500.000,
        "price_max": 4600.000,
        "price_avg": 4328.522,
        "price_median": 4500.000,
        "head_count": 1269,
        "total_amount": 2602740000.00,
        "total_kgs": 601300.00,
        "kg_avg": 474
      }
      // ... 15 más
    ],
    "fuente": "Mercado Agroganadero — haciinfo000502 (Resolución MPyT)",
    "fuente_url": "https://www.mercadoagroganadero.com.ar/..."
  }
}
Self-service: tu plan y uso

Endpoint dedicado para que vos (o tu app) sepan en qué plan estás, cuánto del cupo mensual consumiste, cuánto te queda y cuándo se reinicia. Pensado para healthchecks y dashboards internos.

curl https://www.consignatarias.com.ar/api/account \
  -H "Authorization: Bearer cnsg_live_xxxxxxxxxxxxxxxx"

{
  "success": true,
  "authenticated_via": "api_key",
  "key": {
    "prefix": "cnsg_live_a1b2",
    "environment": "live"
  },
  "plan": "growth",
  "limits": {
    "monthly_quota": 50000,
    "rate_limit_per_minute": 300
  },
  "usage": {
    "monthly_used": 12847,
    "monthly_remaining": 37153,
    "percent_consumed": 26,
    "resets_on": "2026-06-01"
  },
  "sla": "99.8%",
  "docs": "https://www.consignatarias.com.ar/api-docs"
}

También aceptamos cookie de sesión: si llamás desde un browser logueado el response incluye todas tus keys activas, el tier de PRO Usuario y el tier Enterprise por separado.

Histórico INMAG (desde 2015)

Serie diaria del INMAG completa, 11 años de historia (2.236+ días con datos verificados). Param ?historico=N donde N son los días hacia atrás (7–3650).

curl https://www.consignatarias.com.ar/api/precios?historico=365

{
  "success": true,
  "data": {
    "dias": 365,
    "desde": "2025-05-12",
    "hasta": "2026-05-12",
    "serie": [
      { "date": "2025-05-13", "head_count": 8240, "total_amount": 24531870000,
        "inmag_value": 2978.451, "inmag_calculated": true, "variation": 1.2 },
      // ...
    ],
    "estadisticas": {
      "count": 295, "min": 2123.039, "max": 4720.935, "avg": 3658.21
    },
    "fuente": "Mercado Agroganadero — INMAG diario (haciinfo000011)"
  }
}
Ejemplo: /api/remates/stats
{
  "success": true,
  "data": {
    "resumen": {
      "totalRemates": 280,
      "rematesHoy": 12,
      "rematesProximos7dias": 67,
      "provinciasActivas": 13,
      "consignatariasActivas": 63
    },
    "porProvincia": [
      {"provincia": "BUENOS AIRES", "total": 84, "proximos7dias": 28},
      {"provincia": "SANTA FE", "total": 47, "proximos7dias": 10}
    ]
  },
  "timestamp": "2026-03-13T17:30:27.872Z"
}
Límites por plan
PlanReq/mesRate limitSLA
Público (sin auth)por IP, fair usebest effort
Enterprise Starter (USD 99)1.00030/min99,5%
Enterprise Growth (USD 500)50.000300/min99,8%
Enterprise Scale (USD 700+)100K–5M5.000/min99,9%

¿Preguntas? Contactanos en agro@memola.com.ar