Quickstart

export async function cotizave(path, { method = 'GET', body } = {}) {
  const key = process.env.COTIZAVE_API_KEY?.trim();
  if (!key) throw new Error('Set COTIZAVE_API_KEY on the server');
  const url = new URL(path, 'https://api.cotizave.com');
  if (url.origin !== 'https://api.cotizave.com' || !url.pathname.startsWith('/v1/')) {
    throw new Error('Invalid Cotizave API path');
  }
  const response = await fetch(url, {
    method,
    headers: {
      'X-API-Key': key,
      Accept: 'application/json',
      ...(body === undefined ? {} : { 'Content-Type': 'application/json' })
    },
    ...(body === undefined ? {} : { body: JSON.stringify(body) }),
    redirect: 'error',
    signal: AbortSignal.timeout(10_000)
  });
  let data;
  try { data = await response.json(); } catch { data = null; }
  if (!response.ok || data === null) {
    const error = new Error(`Cotizave HTTP ${response.status}`);
    error.status = response.status;
    error.code = data?.code ?? 'invalid_response';
    error.field = data?.field;
    error.details = data?.details;
    error.scope = response.headers.get('X-RateLimit-Scope');
    error.retryAfter = response.headers.get('Retry-After');
    error.reset = response.headers.get('X-RateLimit-Reset');
    throw error;
  }
  return data;
}

import os
import requests

class CotizaveError(Exception):
    def __init__(self, response, data):
        super().__init__(f"Cotizave HTTP {response.status_code}")
        payload = data if isinstance(data, dict) else {}
        self.status = response.status_code
        self.code = payload.get("code", "invalid_response")
        self.field = payload.get("field")
        self.details = payload.get("details")
        self.scope = response.headers.get("X-RateLimit-Scope")
        self.retry_after = response.headers.get("Retry-After")
        self.reset = response.headers.get("X-RateLimit-Reset")

def cotizave(path, *, method="GET", body=None):
    key = os.environ.get("COTIZAVE_API_KEY", "").strip()
    if not key:
        raise ValueError("Set COTIZAVE_API_KEY on the server")
    if not path.startswith("/v1/"):
        raise ValueError("Invalid Cotizave API path")
    with requests.request(
        method, "https://api.cotizave.com" + path,
        headers={"X-API-Key": key, "Accept": "application/json"},
        json=body, timeout=(3, 10), allow_redirects=False
    ) as response:
        try:
            data = response.json()
        except ValueError:
            data = None
        if not 200 <= response.status_code < 300 or data is None:
            raise CotizaveError(response, data)
        return data

curl --fail-with-body --max-time 10 "https://api.cotizave.com/v1/fx/rates/reference" \
  -H "X-API-Key: $COTIZAVE_API_KEY"

import { cotizave } from './cotizave.mjs';

const data = await cotizave('/v1/fx/rates/reference');
console.log(data);

from cotizave import cotizave

data = cotizave('/v1/fx/rates/reference')
print(data)