API de Qhawarina
API REST para acceso programático a nowcasts económicos y análisis contrafactual.
Quick Start
# Sin API key (20 requests/hora)
curl https://qhawarina.pe/api/nowcast/gdp
# Con API key (100-10,000 requests/hora según tier)
curl -H "X-API-Key: tu_api_key" https://qhawarina.pe/api/nowcast/gdpSolicita tu API key
Gratuita para investigación. Mayor throughput para uso comercial.
Nowcast Endpoints
Obtén los últimos nowcasts de indicadores económicos
GET
/api/nowcast/gdpFreeNowcast de crecimiento del PBI (YoY %)
Ver ejemplo de respuesta ▼
{
"success": true,
"data": {
"indicator": "gdp",
"nowcast": {
"value": 2.26,
"target_period": "2025-Q4",
"unit": "% YoY"
},
"model": {
"name": "DFM-Ridge",
"factors": 2,
"r2": 0.934
},
"backtest_metrics": {
"rmse": 1.47,
"relative_rmse_vs_ar1": 0.69
}
}
}GET
/api/nowcast/inflationFreeNowcast de inflación mensual (%)
Ver ejemplo de respuesta ▼
{
"success": true,
"data": {
"indicator": "inflation",
"nowcast": {
"value": 0.21,
"target_period": "2026-02",
"unit": "% monthly",
"annualized": 2.52
}
}
}GET
/api/nowcast/povertyFreeNowcast de tasa de pobreza nacional (%)
Ver ejemplo de respuesta ▼
{
"success": true,
"data": {
"indicator": "poverty",
"nowcast": {
"national": {
"poverty_rate": 26.3,
"extreme_poverty_rate": 4.8,
"target_year": 2024
}
}
}
}GET
/api/nowcast/politicalFreeÍndice de inestabilidad política (z-score)
Ver ejemplo de respuesta ▼
{
"success": true,
"data": {
"indicator": "political_risk",
"current": {
"index": 0.34,
"z_score": 0.52,
"date": "2026-02-16",
"interpretation": "Inestabilidad moderada",
"severity": "medium"
}
}
}Scenarios Endpoints (Premium)
Análisis contrafactual - simula escenarios económicos
GET
/api/scenariosProLista de escenarios disponibles
Ver ejemplo de respuesta ▼
{
"success": true,
"data": {
"scenarios": [
{
"id": "mild_recession",
"name": "Recesión Leve",
"description": "PBI cae a 0%, estrés financiero +1σ",
"tags": ["recession", "mild"],
"impacts_summary": {
"gdp": -2.5,
"inflation": 0.0,
"poverty": 1.25
}
}
],
"count": 10
}
}GET
/api/scenarios/:idProDetalles de escenario específico
Ver ejemplo de respuesta ▼
{
"success": true,
"data": {
"id": "mild_recession",
"baseline": {
"gdp": { "gdp_yoy": 2.5 },
"inflation": { "ipc_monthly_var": 0.25 }
},
"counterfactual": {
"gdp": { "gdp_yoy": 0.0, "forced": true },
"inflation": { "ipc_monthly_var": 0.25 }
},
"direct_impacts": {
"gdp": -2.5,
"inflation": 0.0
},
"propagated_impacts": {
"aggregate": {
"poverty_total_pp": 1.25,
"employment_impact_pp": -1.5
},
"interpretation": "GDP caería 2.5pp..."
}
}
}Utility Endpoints
Endpoints de utilidad y monitoreo
GET
/api/healthPublicEstado de la API y freshness de datos
Ver ejemplo de respuesta ▼
{
"status": "healthy",
"version": "1.0.0",
"services": {
"gdp_nowcast": "ok",
"inflation_nowcast": "ok",
"poverty_nowcast": "ok",
"political_index": "ok"
}
}Rate Limits
Anonymous
20/hora
Sin API key
Free
100/hora
Gratis
Pro
1,000/hora
$49/mes
Enterprise
10,000/hora
Contactar
Autenticación
Incluye tu API key en el header X-API-Key o como query parameter ?api_key=
# Método 1: Header (recomendado)
curl -H "X-API-Key: tu_api_key" https://qhawarina.pe/api/nowcast/gdp
# Método 2: Query parameter
curl https://qhawarina.pe/api/nowcast/gdp?api_key=tu_api_key⚠️ Importante: Nunca expongas tu API key en código cliente (frontend). Usa un proxy backend o variables de entorno.
Error Responses
401 Unauthorized
{
"error": "Invalid API key",
"code": "INVALID_API_KEY",
"timestamp": "2026-02-16T14:30:00Z"
}403 Forbidden
{
"error": "Scenarios API requires Pro or Enterprise tier",
"code": "TIER_UPGRADE_REQUIRED",
"timestamp": "2026-02-16T14:30:00Z"
}429 Too Many Requests
{
"error": "Rate limit exceeded",
"code": "RATE_LIMIT_EXCEEDED",
"timestamp": "2026-02-16T14:30:00Z",
"limit": 100,
"resetAt": "2026-02-16T15:00:00Z"
}404 Not Found
{
"error": "Scenario 'invalid_id' not found",
"code": "DATA_NOT_FOUND",
"timestamp": "2026-02-16T14:30:00Z"
}