Agent-ready

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.

Base URL https://api.montosve.com/v1 · header X-API-Key

Abrir guía /agents.md OpenAPI JSON

tu-agente

$ Lee https://montosve.com/agents.md e integra la API de MontosVE en este proyecto.

Stack detectado: TypeScript

MONTOSVE_API_KEY añadida a .env

Cliente creado en src/lib/montosve.ts

Test de integración agregado

Funciona con opencode Claude Code Cursor

1

Pega la guía en tu agente

Apunta a opencode, Claude Code o Cursor a /agents.md y deja que detecte tu stack y escriba el cliente.

2

Configura tu API key

Agrega MONTOSVE_API_KEY a tu .env. La key nunca va en el código ni en el repositorio.

3

Verifica la integración

Haz una llamada real a /v1/fx/rates y valida el JSON antes de construir sobre él.

Snippets listos para tu stack.

Autenticación con X-API-Key y llamadas base. Copia, ajusta el nombre del cliente y sigue.

JavaScript / TypeScript

fetch

src/lib/montosve.ts

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.

PHP / Laravel

Http client

app/Services/MontosveClient.php

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.

Errores

Maneja los errores desde el primer commit.

La API responde con códigos claros. Tu integración debería reaccionar distinto a cada uno en vez de fallar en silencio.

Ver documentación interactiva

Código	Significado
401	API key ausente o inválida.
403	Feature no disponible en tu plan o cuota agotada.
404	Mercado o recurso inexistente.
422	Parámetros inválidos o sin tasa para la conversión.
429	Rate limit por minuto excedido. Usa backoff exponencial.
503	Ninguna fuente operativa (solo en /v1/health).

¿Aún sin API key?

Crea una gratis, pega la guía en tu agente y ten tu primera integración funcionando hoy.

Obtener API key Ver guía para agentes