API курсов валют Central Bank of Iraq
Официальные ежедневные курсы Central Bank of Iraq (Iraq) в формате JSON: 19 валют, история с 2009 года. Публикуемые курсы IQD для налоговой отчётности, аудита и выставления счетов.
О банке Central Bank of Iraq
Центральный банк Ирака публикует ежедневные курсы динара — покупка, официальный и продажа — для 19 валют. Официальный базовый курс USD/IQD (1310 динаров за доллар с февраля 2023 года) — административно установленный якорь валютной системы Ирака, тогда как кроссы движутся вместе с рынком каждый рабочий день (с воскресенья по четверг). Собственная таблица банка ведётся с 2009 года.
- Официальный сайт: cbi.iq
- Официальная публикация курсов: Exchange prices
Быстрый старт
Один запрос для нужной пары — USD к IQD по официальному курсу Central Bank of Iraq:
curl "https://allratestoday.com/api/v1/central-bank/cbiq/latest?source=USD&target=IQD" \
-H "Authorization: Bearer art_live_your_key" Или полная опубликованная таблица банка:
curl "https://allratestoday.com/api/v1/central-bank/cbiq/latest" \
-H "Authorization: Bearer art_live_your_key" На платных тарифах — любая историческая дата или временной ряд:
curl "https://allratestoday.com/api/v1/central-bank/cbiq/history?source=USD&target=IQD&from=2025-01-01" \
-H "Authorization: Bearer art_live_your_key" Клиент для Node.js / TypeScript
Отдельный npm-пакет без зависимостей оборачивает эти эндпоинты — central-bank-of-iraq-exchange-rate:
npm install central-bank-of-iraq-exchange-rate import { getRate } from 'central-bank-of-iraq-exchange-rate';
const pair = await getRate('USD', 'IQD', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date); Ноль зависимостей, типы TypeScript в комплекте; работает везде, где есть fetch — Node 18+, Bun, Deno и edge-среды.
Зачем нужен официальный курс Central Bank of Iraq?
Рыночные курсы меняются непрерывно, но налоговая отчётность, таможенные декларации, аудит и бухгалтерский учёт (Iraq и не только) обычно требуют официальный курс, опубликованный Central Bank of Iraq на конкретную дату — фиксированное число, на которое можно ссылаться и которое не меняется после публикации. Этот API отдаёт именно такие таблицы с датой публикации банка (rate_date) в каждом ответе; в выходные и праздники возвращается последняя опубликованная дата — именно этот курс требуют применять правила комплаенса.
Пары, которые банк не публикует напрямую, вычисляются из его таблицы (обратный или кросс-курс через IQD) и явно помечаются "derived": true — опубликованное банком и вычисленное никогда не смешиваются.
Эндпоинты
GET /api/v1/central-bank/cbiq/latest— последняя таблица или одна пара (все тарифы)GET /api/v1/central-bank/cbiq/{YYYY-MM-DD}— таблица на любую дату (платные тарифы)GET /api/v1/central-bank/cbiq/history— временной ряд, до 5 000 строк (платные тарифы)GET /api/v1/central-bank/cbiq/availability— календарь публикаций: даты, на которые банк реально публиковал таблицу (все тарифы)
Полное описание параметров — в документации API. Каждый запрос учитывается в месячной квоте тарифа; курсы меняются раз в рабочий день, поэтому локальное кеширование опубликованной таблицы сильно экономит даже небольшую квоту.
Часто задаваемые вопросы
Есть ли API для курсов валют Central Bank of Iraq?
Да — этот. Официальные ежедневные курсы IQD в чистом JSON; последняя таблица на любом тарифе, включая бесплатный.
Как часто обновляются курсы?
Central Bank of Iraq публикует курсы один раз в рабочий день; API загружает каждую новую таблицу вскоре после публикации.
Это официальные курсы?
Да — данные берутся из публикаций самого Central Bank of Iraq и отдаются без изменений с датой публикации банка. Всё вычисленное, а не опубликованное, помечается флагом derived.
Курсы Central Bank of Iraq — один API-ключ
Последняя таблица на любом тарифе. История с 2009 года на платных тарифах. Кредитная карта не нужна.
Получить бесплатный API-ключ Документация