Cuota exacta, CAT real por TIR, tabla de amortización francesa y modo inverso
(«¿cuánto auto me alcanza con tanto al mes?»). Cinco mercados LATAM.
Tu agente llama, recibe 402 con el precio
y paga dentro del mismo intercambio HTTP. Nadie teclea una tarjeta.
# Cotiza un auto de $350,000 MXN a 48 meses curl -X POST "https://galvida.com/api/v1/quote.php" \ -H "X-API-Key: $GALVIDA_KEY" \ -H "Content-Type: application/json" \ -d '{ "country": "MX", "vehicle_price": 350000, "down_payment_pct": 15, "term_months": 48, "annual_rate_pct": 14.9, "rate_type": "nominal" }'
No hay registro, no hay formulario, no hay panel. El mismo intercambio HTTP que pide el dato
lleva el precio y el cobro. Compatible con x402 v2 (el estandar que usa Cloudflare
Monetization Gateway) y con saldo prepago por X-API-Key.
La primera vez no necesitas clave ni cuenta. Si tu agente esta evaluando la API, estas tres llamadas le bastan para saber si el dato le sirve.
curl -X POST https://galvida.com/api/v1/quote.php \
-H 'Content-Type: application/json' \
-d '{"country":"MX","vehicle_price":350000}'
El 402 es autosuficiente: trae el precio, el metodo de pago y a donde pagar. En x402 v2 viaja en la cabecera PAYMENT-REQUIRED (base64).
HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6Mi...
{ "x402Version": 2,
"accepts": [{ "scheme": "prepaid-key",
"unit_price_usd": 0.012 }] }
USD 5 = 417 consultas. La recarga se suma a la misma clave: no se emite una nueva ni hay que reconfigurar nada.
POST /api/v1/checkout.php
{ "pack":"topup",
"api_key":"gv_live_..." }
→ { "url": "https://checkout.stripe.com/..." }
La lógica que normalmente reconstruye tu equipo en cada proyecto, expuesta como un endpoint estable y versionado.
Pago fijo, desglose de capital e interés por periodo y saldo insoluto. Sin redondeos acumulados: la última cuota cierra exactamente en cero, como debe cuadrar en tu contabilidad.
No sumamos intereses y dividimos. Calculamos la TIR mensual por bisección (240 iteraciones) y la anualizamos: (1+r)¹²−1. Comparable entre bancos.
México y Argentina trabajan nominal; Colombia, Chile y Perú publican efectiva anual. Convierte una en otra sin que tu cliente vea la diferencia.
MXN, COP, ARS, CLP y PEN con presets de plazo y tasa por país. Un solo contrato de API para toda la región.
Sin base de datos por request, sin colas, sin dependencias externas. Caché de opcode y listo: el costo marginal de una consulta es redondeo.
Llámalo desde el navegador, un backend o un script. Respuesta con request_id para auditar y api_version para no romperte.
Mueve los controles. Este cálculo corre en tu navegador con la misma fórmula que el endpoint — el resultado coincide centavo a centavo.
Los proveedores de tu categoría te obligan a una suscripción mensual antes de dejarte hacer una sola llamada. Nosotros no.
X-Galvida-Free-Queries-Remainingaccepts[] (formato x402) y el agente resuelve el cobro solo. Recarga mínima $5 USD = 417 consultas, que no vencen.402 con métodos de pago incluidos| Proveedor | Precio por consulta | Suscripción requerida | Cobertura LATAM | CAT / TIR |
|---|---|---|---|---|
| Galvida Credit API | $0.012 · sin plan ni cuenta | Ninguna | MX · CO · AR · CL · PE | Sí, por TIR |
| auto.dev — Interest Rates | $0.005 / llamada | Sí — $299/mes (Growth) | Solo EE.UU. | No |
| RateAPI | Solo con plan | Sí — $50/mes por 100 req | Solo EE.UU. | Parcial |
| MotorCrunch | Gratis (60 req/min) | No | Solo EE.UU. / USD | No |
| BBVA API Market | No publicado | Requiere convenio | Parcial | No |
Precios de referencia pública de cada proveedor, consultados en su sitio oficial. La comparación es informativa y puede variar; verifica siempre la página del proveedor antes de contratar.
Todo lo necesario para integrar en una tarde.
curl -X POST "https://galvida.com/api/v1/quote.php" \ -H "X-API-Key: $GALVIDA_KEY" \ -H "Content-Type: application/json" \ -d '{ "country": "MX", "vehicle_price": 350000, "down_payment_pct": 15, "term_months": 48, "annual_rate_pct": 14.9, "rate_type": "nominal", "opening_fee_pct": 2, "monthly_insurance": 0, "include_schedule": true }'
const res = await fetch('https://galvida.com/api/v1/quote.php', { method: 'POST', headers: { 'Content-Type': 'application/json', 'X-API-Key': process.env.GALVIDA_KEY }, body: JSON.stringify({ country: 'MX', vehicle_price: 350000, down_payment_pct: 15, term_months: 48, annual_rate_pct: 14.9, rate_type: 'nominal' }) }); const data = await res.json(); console.log(data.result.monthly_payment); // 8429.87 console.log(data.result.cat_pct); // 17.22
import os, requests r = requests.post( "https://galvida.com/api/v1/quote.php", headers={"X-API-Key": os.environ["GALVIDA_KEY"]}, json={ "country": "MX", "vehicle_price": 350000, "down_payment_pct": 15, "term_months": 48, "annual_rate_pct": 14.9, "rate_type": "nominal", }, timeout=10, ) r.raise_for_status() q = r.json()["result"] print(q["monthly_payment"], q["cat_pct"])
<?php $ch = curl_init('https://galvida.com/api/v1/quote.php'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: ' . getenv('GALVIDA_KEY'), ], CURLOPT_POSTFIELDS => json_encode([ 'country' => 'MX', 'vehicle_price' => 350000, 'down_payment_pct' => 15, 'term_months' => 48, 'annual_rate_pct' => 14.9, 'rate_type' => 'nominal', ]), ]); $q = json_decode(curl_exec($ch), true); echo $q['result']['monthly_payment'];
countryOPCMX · CO · AR · CL · PE. Define moneda, tasa y plazo por defecto. Default MX.
vehicle_priceREQPrecio del vehículo en moneda local. Mayor a 0, máximo 100,000,000.
down_payment_pctOPCEnganche como porcentaje del precio. 0–99.99. Default 15.
term_monthsOPCPlazo en meses. 6–120. Default según país (48 o 60).
annual_rate_pctOPCTasa anual en porcentaje. Default según preset del país. Rango 0–300.
rate_typeOPCnominal (divide entre 12) o effective (capitaliza (1+i)^(1/12)−1).
opening_fee_pctOPCComisión de apertura sobre el principal, capitalizada. Default 2. Rango 0–20.
monthly_insuranceOPCSeguro mensual fijo sumado a la cuota. Default 0.
include_scheduleOPCtrue/false. Devuelve el primer año y el último mes de la tabla. Default true.
X-API-Key: gv_live_xxxxxxxxxxxxxxxxxxxx
# Alternativa para pruebas rápidas en navegador:
GET /api/v1/quote.php?api_key=gv_...&country=MX&vehicle_price=350000
401 missing_api_key Falta el header X-API-Key 401 invalid_api_key La clave no existe o fue revocada 429 quota_exceeded Cuota mensual agotada o más de 60 req/min 400 invalid_vehicle_price / invalid_term / invalid_rate ... # Toda respuesta de error mantiene la forma: { "ok": false, "error": { "code": "...", "message": "..." } }
/quote suma $0.012 USD (o $0.006 en Volumen). Al cierre de mes emitimos la factura con el conteo real de tu panel de uso. Los errores 400 y 401 no se cobran; los 429 tampoco.(1+r)¹²−1, así que es directamente comparable con el CAT que publica cualquier institución en México.annual_rate_pct acepta cualquier valor entre 0 y 300, y rate_type te deja entrar con tasa nominal o efectiva. Puedes guardar el catálogo de tasas de tus bancos aliados y pasarlo en cada llamada — la API no te impone ninguna tasa.429 quota_exceeded con el detalle de uso en el cuerpo, sin cortar tu integración. Puedes pasar a Producción en cualquier momento desde el panel; la misma key cambia de plan y sigue funcionando sin tocar código.
Si eres un agente, llama y listo: tres consultas gratis por IP y día, y cuando se agoten el
402 trae el precio y el método de pago.
Si eres una persona y prefieres que te atendamos, deja tu correo y te damos 20 consultas de prueba.
Guárdala ahora: no se vuelve a mostrar. Tu consumo vive en /api/cuenta.html.
Para agentes no hace falta este formulario:
curl -X POST https://galvida.com/api/v1/quote.php -d '{"country":"MX","vehicle_price":350000}'
¿Factura o contrato de volumen? soporte@galvida.com