API курсов валют Banco de Guatemala
Официальные курсы Banco de Guatemala на 15 сент. 2026 г.: 1 USD = 7.6232 GTQ. Все публикуемые валюты: 1 валюта, история с 2004 года. Бесплатный JSON API для отчётности, аудита и счетов.
О банке Banco de Guatemala
Banco de Guatemala ежедневно рассчитывает tipo de cambio de referencia — официальный курс кетсаля к доллару, закреплённый законом для налогов, таможни и контрактов, — а также публикует ежедневные котировки покупки/продажи примерно 25 других валют к доллару, с историей с 2004 года.
- Официальный сайт: banguat.gob.gt
- Официальная публикация курсов: Tipo de cambio de referencia
Быстрый старт
Один запрос для нужной пары — USD к GTQ по официальному курсу Banco de Guatemala:
curl "https://allratestoday.com/api/v1/central-bank/banguat/latest?source=USD&target=GTQ" \
-H "Authorization: Bearer art_live_your_key" Или полная опубликованная таблица банка:
curl "https://allratestoday.com/api/v1/central-bank/banguat/latest" \
-H "Authorization: Bearer art_live_your_key" На платных тарифах — любая историческая дата или временной ряд:
curl "https://allratestoday.com/api/v1/central-bank/banguat/history?source=USD&target=GTQ&from=2025-01-01" \
-H "Authorization: Bearer art_live_your_key" Последние опубликованные курсы (2026-09-15)
Самая свежая таблица, опубликованная Banco de Guatemala, — ровно то, что сейчас возвращает эндпоинт /latest. Значения указаны в GTQ за 1 единицу каждой валюты:
Скачать таблицу: Excel (.xlsx) CSV (требуется платный тариф)
По одной строке на валюту за каждую дату публикации. До одного года за загрузку. Тарифицируется как один API-запрос за каждую валюту за каждый месяц данных.
Нужен весь архив одним файлом? Полный архив всех источников также опубликован как открытый датасет: central-bank-exchange-rates на Hugging Face
| База | Котировка | Тип | Курс |
|---|---|---|---|
USD | GTQ | reference | 7.62318 |
Клиент для Node.js / TypeScript
Отдельный npm-пакет без зависимостей оборачивает эти эндпоинты — banguat-exchange-rate:
npm install banguat-exchange-rate import { getRate } from 'banguat-exchange-rate';
const pair = await getRate('USD', 'GTQ', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); Ноль зависимостей, типы TypeScript в комплекте; работает везде, где есть fetch — Node 18+, Bun, Deno и edge-среды.
Полная документация — установка, все четыре функции, формат ответов, коды ошибок: banguat-exchange-rate (на английском).
Зачем нужен официальный курс Banco de Guatemala?
Рыночные курсы меняются непрерывно, но налоговая отчётность, таможенные декларации, аудит и бухгалтерский учёт (Guatemala и не только) обычно требуют официальный курс, опубликованный Banco de Guatemala на конкретную дату — фиксированное число, на которое можно ссылаться и которое не меняется после публикации. Этот API отдаёт именно такие таблицы с датой публикации банка (rate_date) в каждом ответе; в выходные и праздники возвращается последняя опубликованная дата — именно этот курс требуют применять правила комплаенса.
Пары, которые банк не публикует напрямую, вычисляются из его таблицы (обратный или кросс-курс через GTQ) и явно помечаются "derived": true — опубликованное банком и вычисленное никогда не смешиваются.
Эндпоинты
GET /api/v1/central-bank/banguat/latest— последняя таблица или одна пара (все тарифы)GET /api/v1/central-bank/banguat/{YYYY-MM-DD}— таблица на любую дату (платные тарифы)GET /api/v1/central-bank/banguat/history— временной ряд, до 5 000 строк (платные тарифы)GET /api/v1/central-bank/banguat/availability— календарь публикаций: даты, на которые банк реально публиковал таблицу (все тарифы)
Полное описание параметров — в документации API. Каждый запрос учитывается в месячной квоте тарифа; курсы меняются раз в рабочий день, поэтому локальное кеширование опубликованной таблицы сильно экономит даже небольшую квоту.
Часто задаваемые вопросы
Есть ли API для курсов валют Banco de Guatemala?
Да — этот. Официальные ежедневные курсы GTQ в чистом JSON; последняя таблица на любом тарифе, включая бесплатный.
Как часто обновляются курсы?
Banco de Guatemala публикует курсы один раз в рабочий день; API загружает каждую новую таблицу вскоре после публикации (последняя: 2026-09-15).
Это официальные курсы?
Да — данные берутся из публикаций самого Banco de Guatemala и отдаются без изменений с датой публикации банка. Всё вычисленное, а не опубликованное, помечается флагом derived.
Курсы Banco de Guatemala — один API-ключ
Последняя таблица на любом тарифе. История с 2004 года на платных тарифах. Кредитная карта не нужна.
Получить бесплатный API-ключ Документация