Banco de Guatemala Exchange Rate API: Official GTQ Rates as JSON

The Banco de Guatemala publishes the official exchange rates that accounting, tax, and customs rules in Guatemala reference — published official rates, not moving market prices. This guide shows how to pull them as JSON: via a REST endpoint or the zero-dependency banguat-exchange-rate npm package.

What the Banguat publishes

• The tipo de cambio de referencia — the official USD/GTQ rate computed from the regulated FX market's operations, published every calendar day.
• Daily buy/sell quotations for ~25 more currencies against the dollar — EUR, MXN, the Central American set, and major Asian currencies.
• History back to 2004 — queryable by exact date or as a time series.
• The bank's own publication date on every response, so a rate is always citable.

Guatemalan law points to the referencia for tax, customs, and contract settlement — and quetzal pairs for the other quoted currencies resolve through it, flagged as derived.

Why official rates, not market rates

A live mid-market feed answers "what is USD/GTQ trading at right now?" — the right tool for checkouts and dashboards. But accountants, auditors, and tax authorities ask a different question: "which rate were you required to use for this date?" That answer comes from the Banco de Guatemala's published rates, and it never changes after publication.

Get the latest rates (REST)

curl "https://allratestoday.com/api/v1/central-bank/banguat/latest" \
  -H "Authorization: Bearer YOUR_API_KEY"

The response is the bank's most recent published data — every rate and the publication date. The latest rates are available on every plan, including the free tier (300 requests/month, no credit card).

The npm SDK

npm install banguat-exchange-rate

import { getRate, getLatestRates } from 'banguat-exchange-rate';

// One pair at the official Banguat rate
const pair = await getRate('USD', 'GTQ', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date);

// The bank's full published table
const table = await getLatestRates({ apiKey: 'art_live_...' });
console.log(table.rate_date, table.rates.length);

Zero dependencies, TypeScript types included, and it runs anywhere fetch exists — Node 18+, Bun, Deno, and edge runtimes.

Historical rates for an invoice date

import { getRatesForDate, getHistory } from 'banguat-exchange-rate';

// The official rates for an invoice date — non-publication days return
// the most recent published date, flagged via published_on_requested_date.
const day = await getRatesForDate('2026-06-30', { apiKey: 'art_live_...' });

// Time series for one pair
const series = await getHistory(
  { source: 'USD', target: 'GTQ', from: '2026-01-01' },
  { apiKey: 'art_live_...' }
);

Historical dates and time series need a paid plan; the latest rates stay free.

Published vs derived pairs

If the Banguat does not print a pair directly, the API resolves it from the bank's published rates — an inverse, or a cross rate via GTQ — and flags it derived: true with the method used. Official and computed values are never silently mixed, which is exactly the distinction an auditor will ask about.

Two decades of quetzal history

The referencia series runs from late 2006 and the multi-currency quotations from 2004, documenting one of Latin America's steadiest currencies — two decades inside a 7.2–8.4 band against the dollar. That stability is exactly why the official print, not a market feed, is what Guatemalan accounting cites.

FAQ

Does the Banco de Guatemala have an official exchange rate API?

The Banguat publishes its official rates on its own site, and AllRatesToday serves the same published rates as clean JSON via REST or the banguat-exchange-rate npm package. The latest table is free.

How often do Banco de Guatemala rates update?

Every calendar day, including weekends — Banguat computes the referencia from the previous day's regulated market operations. Every API response carries the publication date so you can cite it.

Can I get the Banguat rate for a past date, like an invoice date?

Yes. The /central-bank/banguat/rates-for-date endpoint returns the official rates for any archived date. Non-publication days resolve to the most recent published date and are flagged, so your audit trail stays honest. Historical dates require a paid plan; latest rates are free.