Integra la API con tu agente de IA en minutos.
Publicamos una guía y ejemplos pensados para agentes. Copia el prompt de la derecha en opencode, Claude Code o Cursor y deja que escriba el cliente por ti.
https://api.montosve.com/v1
· header
X-API-Key
Lee https://api.montosve.com/agents.md e integra la API de MontosVE en este proyecto.
TypeScript
MONTOSVE_API_KEY añadida a .env
src/lib/montosve.ts
Apunta a opencode, Claude Code o Cursor a /agents.md y deja que detecte tu stack y escriba el cliente.
Agrega MONTOSVE_API_KEY a tu .env. La key nunca va en el código ni en el repositorio.
Haz una llamada real a /v1/fx/rates y valida el JSON antes de construir sobre él.
const BASE_URL = 'https://api.montosve.com/v1';
const API_KEY = process.env.MONTOSVE_API_KEY;
export async function getRates(tradeType = "buy") {
const response = await fetch(`${BASE_URL}/fx/rates?trade_type=${tradeType}`, {
headers: { "X-API-Key": API_KEY },
});
if (! response.ok) {
throw new Error(`MontosVE error ${response.status}`);
}
return response.json();
}Agrega /fx/convert y /fx/spread reutilizando la misma función.
use Illuminate\Support\Facades\Http;
$response = Http::baseUrl('https://api.montosve.com/v1')
->withHeaders(['X-API-Key' => config('services.montosve.api_key')])
->acceptJson()
->get('/fx/rates', ['trade_type' => 'buy'])
->throw();
$data = $response->json('data');Define MONTOSVE_API_KEY en tu .env y léela desde config/services.php.
Endpoint https://api.montosve.com/mcp con tu API key como Authorization: Bearer o X-API-Key. Seis tools de solo lectura y acceso beta.
get-fx-rates
get-market-rate
get-spread
convert-currency
get-rate-history
get-source-health
Config por cliente, resources y prompts en la guía MCP.
Eventos disponibles: rate.bcv.updated,
rate.p2p.updated (con umbral),
source.status_changed,
api.quota.warning,
api.quota.exceeded y
api.key.expiring.
-
Firma
X-MontosVE-Signature(HMAC SHA-256 sobretimestamp.body). - Reintentos automaticos (4 intentos: 10s, 60s, 300s) e historial de entregas.
- Solo URLs publicas (http/https); se rechazan hosts privados.
POST https://tu-app.com/webhooks/montosve
X-MontosVE-Event: rate.bcv.updated
X-MontosVE-Timestamp: 1758231012
X-MontosVE-Signature: sha256=a1b2c3...
{
"event": "rate.bcv.updated",
"occurred_at": "2026-09-18T17:30:12-04:00",
"data": { "date": "2026-09-19", "usd": 100.50, "eur": 110.50 }
}
Verifica la firma con hash_hmac('sha256', $timestamp.'.'.$body, $secret) y responde 2xx rapido. Detalles y ejemplos en /agents.md.
|
Código
|
Significado
|
|---|---|
| API key ausente o inválida. | |
| Feature no disponible en tu plan o cuota agotada. | |
| Mercado o recurso inexistente. | |
| Parámetros inválidos o sin tasa para la conversión. | |
| Rate limit por minuto excedido. Usa backoff exponencial. | |
| Ninguna fuente operativa (solo en /v1/health). |
Crea una gratis, pega la guía en tu agente y ten tu primera integración funcionando hoy.