API курсов валют Banco Central de Costa Rica

Официальные ежедневные курсы Banco Central de Costa Rica (Costa Rica) в формате JSON: десятки валют. Публикуемые курсы CRC для налоговой отчётности, аудита и выставления счетов.

Costa Rica flagBanco Central de Costa Rica — официальные ежедневные курсы валют в формате JSON: десятки валют к CRC. Последняя таблица — на любом тарифе. Получить API-ключ.

О банке Banco Central de Costa Rica

Центральный банк Коста-Рики устанавливает справочный tipo de cambio — официальные курсы покупки и продажи колона к доллару США, объявляемые каждый рабочий день и используемые в коста-риканском учёте и налогообложении, плюс кросс к евро. Серия загружается через открытый API Министерства финансов, которое переиздаёт справочные курсы BCCR; происхождение раскрыто, поскольку собственный веб-сервис BCCR требует регистрации.

Быстрый старт

Один запрос для нужной пары — USD к CRC по официальному курсу Banco Central de Costa Rica:

curl "https://allratestoday.com/api/v1/central-bank/bccr/latest?source=USD&target=CRC" \
  -H "Authorization: Bearer art_live_your_key"

Или полная опубликованная таблица банка:

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

На платных тарифах — любая историческая дата или временной ряд:

curl "https://allratestoday.com/api/v1/central-bank/bccr/history?source=USD&target=CRC&from=2025-01-01" \
  -H "Authorization: Bearer art_live_your_key"

Клиент для Node.js / TypeScript

Отдельный npm-пакет без зависимостей оборачивает эти эндпоинты — bccr-exchange-rate:

npm install bccr-exchange-rate
import { getRate } from 'bccr-exchange-rate';

const pair = await getRate('USD', 'CRC', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date);

Ноль зависимостей, типы TypeScript в комплекте; работает везде, где есть fetch — Node 18+, Bun, Deno и edge-среды.

Зачем нужен официальный курс Banco Central de Costa Rica?

Рыночные курсы меняются непрерывно, но налоговая отчётность, таможенные декларации, аудит и бухгалтерский учёт (Costa Rica и не только) обычно требуют официальный курс, опубликованный Banco Central de Costa Rica на конкретную дату — фиксированное число, на которое можно ссылаться и которое не меняется после публикации. Этот API отдаёт именно такие таблицы с датой публикации банка (rate_date) в каждом ответе; в выходные и праздники возвращается последняя опубликованная дата — именно этот курс требуют применять правила комплаенса.

Пары, которые банк не публикует напрямую, вычисляются из его таблицы (обратный или кросс-курс через CRC) и явно помечаются "derived": true — опубликованное банком и вычисленное никогда не смешиваются.

Эндпоинты

Полное описание параметров — в документации API. Каждый запрос учитывается в месячной квоте тарифа; курсы меняются раз в рабочий день, поэтому локальное кеширование опубликованной таблицы сильно экономит даже небольшую квоту.

Часто задаваемые вопросы

Есть ли API для курсов валют Banco Central de Costa Rica?

Да — этот. Официальные ежедневные курсы CRC в чистом JSON; последняя таблица на любом тарифе, включая бесплатный.

Как часто обновляются курсы?

Banco Central de Costa Rica публикует курсы один раз в рабочий день; API загружает каждую новую таблицу вскоре после публикации.

Это официальные курсы?

Да — данные берутся из публикаций самого Banco Central de Costa Rica и отдаются без изменений с датой публикации банка. Всё вычисленное, а не опубликованное, помечается флагом derived.

Курсы Banco Central de Costa Rica — один API-ключ

Последняя таблица на любом тарифе. Кредитная карта не нужна.

Получить бесплатный API-ключ Документация