← Volver a docs
Empezar / Quickstart

Guía rápida

Pon a funcionar Cotizave en tu proyecto en menos de 5 minutos. Esta guía asume que sabes hacer un request HTTP desde tu lenguaje favorito.

Paso 1 · Regístrate y obtén tu API Key

  1. Ve a app.cotizave.com
  2. Haz clic en "Crear cuenta gratis"
  3. Ingresa tu email y una contraseña
  4. Confirma tu email (te llega un enlace al instante)
  5. Una vez dentro del dashboard, ve a la sección API Keys
  6. Copia la key que se generó automáticamente para tu cuenta

Tu primera API Key se ve así:

api-key
ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d
!

Guárdala en un lugar seguro. No la pegues en código público, no la subas a GitHub, no la compartas.

★

Tip: en el dashboard puedes crear múltiples API Keys para distintos entornos (ej: production, staging, local). Cada una tiene su propio nombre y puedes rotarlas individualmente.

Paso 2 · Tu primer request

Vamos a hacer una llamada al endpoint principal: GET /v1/fx/rates. Este endpoint devuelve todas las tasas disponibles.

curl
curl https://api.cotizave.com/v1/fx/rates \ -H "X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d" \ -H "Accept: application/json"

Paso 3 · La respuesta

La respuesta es un JSON con esta estructura:

200 OK · application/json
{ "country": "VE", "currency": "VES", "base": "USD", "rates": [ {"market": "reference", "mid": 475.0083, "updated_at": "2026-04-08T14:00:00Z"}, {"market": "parallel", "ask": 640.12, "bid": 637.63, "mid": 638.87}, {"market": "binance", "ask": 639.24, "bid": 636.50, "mid": 637.87} ], "fetched_at": "2026-04-08T17:29:15Z" }

Qué significa cada campo

  • market: identificador del mercado (reference, parallel, binance, bybit, etc.)
  • type: tipo de tasa (reference, parallel, p2p)
  • ask / bid: precio de venta / compra. Pueden no estar en tasas reference.
  • mid: precio promedio. Siempre está presente.
  • updated_at: timestamp de cuándo se actualizó esta cotización
  • fetched_at: timestamp de cuándo Cotizave ensambló esta respuesta

Paso 4 · Usa los datos en tu app

Un ejemplo simple: mostrar la tasa BCV y paralela en un sitio.

example.js
async function mostrarTasas() { const res = await fetch('https://api.cotizave.com/v1/fx/rates', { headers: { 'X-API-Key': 'ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d' } }) const { rates } = await res.json() const bcv = rates.find(r => r.market === 'reference') const paralela = rates.find(r => r.market === 'parallel') document.getElementById('bcv').textContent = `Bs. ${bcv.mid.toFixed(2)}` document.getElementById('paralela').textContent = `Bs. ${paralela.mid.toFixed(2)}` } mostrarTasas() setInterval(mostrarTasas, 30000)

Próximos pasos

Tips para el desarrollo

Maneja errores con gracia

  • Implementa retry con backoff exponencial (1s, 2s, 4s, 8s…)
  • Tener un fallback a datos anteriores con aviso de timestamp al usuario
  • Loguear errores para investigar después
  • Mostrar mensajes claros al usuario final si es imposible obtener datos

¿Problemas?

← AnteriorIntroducciónSiguiente →Autenticación