API курсов валют

Мы предоставляем программный доступ к курсам валют Украины и мира через REST API: межбанк в реальном времени, наличный рынок, фиксинг, курсы НБУ, касс банков, онлайн-банков, карточные курсы и Forex.

Для получения расширенной версии API для ERP-систем (SAP), интернет-магазинов, договоров или других целей напишите нам через форму обратной связи. Укажите, какой курс и для чего нужен — мы предложим оптимальный вариант сотрудничества для решения ваших задач.

Оставить заявку

Мы предоставляем:

Курсы Межбанка в реальном времени, на основе данных по крупным сделкам купли/продажи
Коммерческий курс (мониторинг наличного рынка)
Фиксинг наличный и безналичный для договоров (курс фиксируется каждый день в одно и то же время)
Курсы НБУ
Курсы касс банков Украины
Курсы онлайн-банков Украины
Курсы карт банков Украины
Курсы обменных пунктов
Курс Forex
Курсы криптовалют

Общие сведения

Базовый адрес

Все методы доступны по адресу:

https://kurs.com.ua/api/{method}

Параметры можно передавать как строкой запроса (?key=...&format=json), так и сегментами URL (/key/.../format/json) — оба варианта равнозначны.

Авторизация

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

Оставить заявку

Формат ответа

По умолчанию ответ возвращается в формате XML. Добавьте параметр format=json, чтобы получить JSON.

Лимиты запросов

Количество запросов в час ограничено для каждого метода отдельно и зависит от условий вашего ключа. После исчерпания лимита возвращается ошибка 401.

Ошибки

В случае ошибки возвращается ответ с полями status: false и error с описанием причины.

`400`	некорректные параметры запроса (неизвестная валюта, город и т.п.)
`401`	исчерпан часовой лимит запросов, истёк срок действия ключа или недостаточно прав
`403`	неверный ключ API

Поля ответа

`bid`	курс покупки — по нему организация покупает валюту
`ask`	курс продажи — по нему организация продаёт валюту
`bid_change, ask_change, change`	изменение значения относительно предыдущего дня
`value`	официальный курс (НБУ, международный рынок)
`rate`	курс валютной пары (Forex)
`updated`	дата и время последнего обновления значения
`date`	дата, на которую возвращены данные
`new / old`	свежие данные, обновлённые сегодня / данные, не обновлявшиеся сегодня
`total, banks_total`	количество организаций в выборке
`avg / best`	средний и лучший курс среди организаций выборки
`trusted`	уровень доверия к источнику данных
`translit`	транслитерационный ключ — используется в параметрах запросов
`nal / beznal`	наличный / безналичный фиксинг
`CURRENT / PREVIOUS`	точки графика за текущий и предыдущий торговый день

Параметры key и format — общие для всех методов и в таблицах не повторяются.

Сводные курсы

GET /api/summary_info

Сводка актуальных курсов по выбранному городу или области одним запросом: средние и лучшие курсы банков, наличный рынок, межбанк, НБУ, Visa/Mastercard, Forex и фиксинг.

Параметр	Описание
`city`	Город или область — транслитерационный ключ (см. методы cities и regions). По умолчанию — `all` (вся Украина).
`currencies`	Список валют через запятую — транслитерационные ключи, напр. `usd,eur` (см. метод currencies). По умолчанию — все доступные валюты.
`basic_currency`	Базовая валюта, относительно которой рассчитываются курсы. По умолчанию — `uah`.
`date`	Дата, на которую нужны курсы, напр. `13.07.2026` или `2026-07-13`. По умолчанию — сегодня.
`type`	Тип организаций: `MAJOR` (крупнейшие), `BIG` (крупные), `BANK` (все банки), `POV` (пункты обмена). По умолчанию — `BANK`.
`source`	Источники данных через запятую. По умолчанию — все. Возможные значения: `organizations` — средние и лучшие курсы банков, `commercial` — коммерческий курс наличного рынка, `actual` — актуальный курс наличного рынка, `blackmarket` — наличный рынок, `mezhbank` — межбанк, `nbu` — курсы НБУ, `international` — международный рынок, `visa` — курсы Visa, `mastercard` — курсы Mastercard, `fixing` — фиксинг.

Пример запроса

https://kurs.com.ua/api/summary_info?key=YOUR_API_KEY&city=kiev&currencies=usd,eur&format=json

Пример ответа

{
  "basic_currency": { "id": "491", "iso": "980", "symbol": "UAH", "name": "гривна" },
  "date": "Mon, 13 Jul 2026 00:00:00 +0300",
  "city": { "id": "908", "name": "Киев", "translit": "kiev" },
  "currencies": [
    {
      "id": "1", "iso": "840", "symbol": "USD", "name": "доллар",
      "rates": [
        {
          "type": "organizations",
          "updated": "Mon, 13 Jul 2026 12:48:52 +0300",
          "banks_total": 43,
          "avg": { "bid": 44.3398, "bid_change": 0.0666, "ask": 44.7893, "ask_change": 0.0673 },
          "best": { "bid": 44.6, "bid_change": 0.2, "ask": 44.6, "ask_change": 0.05 }
        },
        {
          "type": "commercial",
          "updated": "Mon, 13 Jul 2026 12:30:00 +0300",
          "bid": 44.4552, "bid_change": 0.0235,
          "ask": 44.6187, "ask_change": 0.0022
        },
        {
          "type": "nbu",
          "updated": "Mon, 13 Jul 2026 00:00:00 +0300",
          "value": 44.3564, "change": 0.0421
        }
      ]
    }
  ]
}

Справочник валют

GET /api/currencies

Справочник валют и банковских металлов: идентификаторы, символы, названия и транслитерационные ключи, используемые в параметре currencies других методов.

Параметр Описание

type Тип справочника: currency_and_metal (по умолчанию) — валюты и банковские металлы, currency — только валюты, metal — только банковские металлы, nbu — валюты курсов НБУ, cash — валюты наличного рынка, cash_cards — валюты карточных курсов, cards — валюты платёжных карт, mejbank — валюты межбанка, commercial — валюты коммерческого курса, actual — валюты актуального курса, visa — валюты Visa, mastercard — валюты Mastercard, forex — инструменты рынка Forex, forex_currency — валюты Forex, forex_metal — металлы Forex, bank_metal — банковские металлы.

Параметр	Описание
`type`	Тип справочника: `currency_and_metal` (по умолчанию) — валюты и банковские металлы, `currency` — только валюты, `metal` — только банковские металлы, `nbu` — валюты курсов НБУ, `cash` — валюты наличного рынка, `cash_cards` — валюты карточных курсов, `cards` — валюты платёжных карт, `mejbank` — валюты межбанка, `commercial` — валюты коммерческого курса, `actual` — валюты актуального курса, `visa` — валюты Visa, `mastercard` — валюты Mastercard, `forex` — инструменты рынка Forex, `forex_currency` — валюты Forex, `forex_metal` — металлы Forex, `bank_metal` — банковские металлы.

Пример запроса

https://kurs.com.ua/api/currencies?key=YOUR_API_KEY&format=json

Пример ответа

{
  "total": 172,
  "currencies": [
    { "id": "1", "symbol": "USD", "name": "доллар", "translit": "usd" },
    { "id": "2", "symbol": "EUR", "name": "евро", "translit": "eur" },
    { "id": "3", "symbol": "RUB", "name": "рубль", "translit": "rub" }
  ]
}

Области

GET /api/regions

Список областей Украины с транслитерационными ключами для параметров region и city.

Параметр	Описание
`type`	Фильтр областей: `commercial` — области, для которых есть курсы наличного рынка.

Пример запроса

https://kurs.com.ua/api/regions?key=YOUR_API_KEY&format=json

Пример ответа

{
  "total": 24,
  "regions": [
    { "id": "2", "name": "Винницкая область", "translit": "vinnickaya_oblast" },
    { "id": "3", "name": "Волынская область", "translit": "volynskaya_oblast" }
  ]
}

Города

GET /api/cities

Список городов Украины с геокоординатами. Поле translit используется в параметре city других методов.

Параметр	Описание
`type`	Фильтр городов: `commercial`, `bank`, `bank_big`, `big`.
`region`	Область — транслитерационный ключ (см. метод regions).

Пример запроса

https://kurs.com.ua/api/cities?key=YOUR_API_KEY&type=big&format=json

Пример ответа

{
  "total": 58,
  "cities": [
    {
      "id": "908",
      "region_id": "11",
      "name": "Киев",
      "translit": "kiev",
      "size": "5",
      "geometry": {
        "lat": 50.4501,
        "lng": 30.5234,
        "bounds": {
          "ne": { "lat": 50.590798, "lng": 30.825941 },
          "sw": { "lat": 50.213273, "lng": 30.239440 }
        }
      }
    }
  ]
}

Банки и организации

GET /api/organizations

Список банков и обменных пунктов: названия, типы, телефоны и иконки.

Параметр	Описание
`type`	Тип организаций: `MAJOR`, `BIG`, `BANK`, `POV`, `BANK_ALL`.

Пример запроса

https://kurs.com.ua/api/organizations?key=YOUR_API_KEY&type=MAJOR&format=json

Пример ответа

{
  "total": 17,
  "organizations": [
    {
      "id": "34",
      "name": "Sense bank",
      "translit": "sense-bank",
      "type": "BANK",
      "group": "1",
      "phones": "0-800-50-20-50, (044)298-80-00",
      "icon": {
        "base64": "data:image/png;base64,iVBORw0KGgoAAAANSU...",
        "url": "https://old.kurs.com.ua/static/images/banks_icon/34.png"
      }
    }
  ]
}

Отделения

GET /api/organizations_departments

Отделения выбранной организации: адреса, телефоны, геокоординаты.

Параметр	Описание
`organization`	ID организации (см. метод organizations).
`city`	Город — транслитерационный ключ (см. метод cities).

Пример запроса

https://kurs.com.ua/api/organizations_departments?key=YOUR_API_KEY&organization=10&format=json

Пример ответа

{
  "total": 1698,
  "departments": [
    {
      "id": "154994",
      "city": "2327",
      "name": "Отделение ПриватБанка",
      "address": "г. Чернигов, ул. Ивана Мазепы, 6",
      "phones": "3700",
      "geo": { "lat": "51.4967", "lng": "31.2872" }
    }
  ]
}

Курсы в кассах банков

GET /api/organizations_rates

Наличные курсы в кассах банков и обменных пунктах выбранного города. Данные разбиты на свежие (new) и устаревшие (old).

Параметр	Описание
`city`	Город или область — транслитерационный ключ (см. методы cities и regions).
`currencies`	Список валют через запятую — транслитерационные ключи, напр. `usd,eur` (см. метод currencies). По умолчанию — все доступные валюты.
`date`	Дата, на которую нужны курсы, напр. `13.07.2026` или `2026-07-13`. По умолчанию — сегодня.
`type`	Тип организаций: `MAJOR`, `BIG`, `BANK`, `POV`, `BANK_ALL`, либо список типов через запятую.
`wholesale`	Оптовые курсы: `1` — вернуть оптовые значения.

Пример запроса

https://kurs.com.ua/api/organizations_rates?key=YOUR_API_KEY&city=kiev&currencies=usd&type=MAJOR&format=json

Пример ответа

{
  "date": "Mon, 13 Jul 2026 00:00:00 +0300",
  "city": { "id": "908", "name": "Киев", "translit": "kiev" },
  "currencies": [
    {
      "id": "1",
      "symbol": "USD",
      "updated": "Mon, 13 Jul 2026 00:00:00 +0300",
      "total": 15,
      "rates": {
        "new": [
          {
            "organization_id": "10",
            "organization": "Приватбанк",
            "bid": "44.1000", "bid_change": "0.0000",
            "ask": "44.7000", "ask_change": "0.0000",
            "updated": "Mon, 13 Jul 2026 09:31:32 +0300",
            "trusted": "2"
          },
          {
            "organization_id": "98",
            "organization": "Райффайзен Банк",
            "bid": "44.4500", "bid_change": "0.1500",
            "ask": "44.8200", "ask_change": "0.1300",
            "updated": "Mon, 13 Jul 2026 11:50:08 +0300",
            "trusted": "1"
          }
        ],
        "old": [
          {
            "organization_id": "146",
            "organization": "Кредобанк",
            "bid": "44.3700", "bid_change": "0.0000",
            "ask": "44.6400", "ask_change": "0.0000",
            "updated": "Fri, 10 Jul 2026 12:36:16 +0300",
            "trusted": "2"
          }
        ]
      }
    }
  ]
}

Карточные курсы банков

GET /api/organizations_card_rates

Курсы конвертации по платёжным картам банков Украины. Структура ответа — как у метода organizations_rates.

Параметр	Описание
`currencies`	Список валют через запятую — транслитерационные ключи, напр. `usd,eur` (см. метод currencies). По умолчанию — все доступные валюты.
`date`	Дата, на которую нужны курсы, напр. `13.07.2026` или `2026-07-13`. По умолчанию — сегодня.

Пример запроса

https://kurs.com.ua/api/organizations_card_rates?key=YOUR_API_KEY&currencies=usd&format=json

Пример ответа

{
  "date": "Mon, 13 Jul 2026 00:00:00 +0300",
  "currencies": [
    {
      "id": "1",
      "symbol": "USD",
      "updated": "Mon, 13 Jul 2026 00:00:00 +0300",
      "total": 38,
      "rates": {
        "new": [
          {
            "organization_id": "35",
            "organization": "Банк Альянс",
            "bid": "44.5000", "bid_change": "0.1000",
            "ask": "44.6500", "ask_change": "0.1200",
            "updated": "Mon, 13 Jul 2026 11:30:07 +0300",
            "trusted": "1"
          }
        ],
        "old": []
      }
    }
  ]
}

Онлайн курсы банков

GET /api/organizations_online_rates

Онлайн курсы банков Украины. Структура ответа — как у метода organizations_rates.

Параметр	Описание
`currencies`	Список валют через запятую — транслитерационные ключи, напр. `usd,eur` (см. метод currencies). По умолчанию — все доступные валюты.
`date`	Дата, на которую нужны курсы, напр. `13.07.2026` или `2026-07-13`. По умолчанию — сегодня.

Пример запроса

https://kurs.com.ua/api/organizations_online_rates?key=YOUR_API_KEY&currencies=usd&format=json

Пример ответа

{
  "date": "Mon, 13 Jul 2026 00:00:00 +0300",
  "currencies": [
    {
      "id": "1",
      "symbol": "USD",
      "updated": "Mon, 13 Jul 2026 00:00:00 +0300",
      "total": 29,
      "rates": {
        "new": [
          {
            "organization_id": "87",
            "organization": "ОТП Банк",
            "bid": "44.5540", "bid_change": "0.2080",
            "ask": "44.8500", "ask_change": "0.1500",
            "updated": "Mon, 13 Jul 2026 12:30:05 +0300",
            "trusted": "1"
          }
        ],
        "old": [
          {
            "organization_id": "146",
            "organization": "Кредобанк",
            "bid": "44.3700", "bid_change": "0.0000",
            "ask": "44.6400", "ask_change": "0.0000",
            "updated": "Fri, 10 Jul 2026 12:36:16 +0300",
            "trusted": "2"
          }
        ]
      }
    }
  ]
}

Курсы Forex

GET /api/forex

Курсы международного валютного рынка Forex по валютным парам.

Параметр	Описание
`currencies`	Валютные пары через запятую в формате `от_к`, напр. `eur_usd,gbp_usd`. Без параметра возвращаются основные пары рынка Forex к USD.
`date`	Дата, на которую нужны курсы, напр. `13.07.2026` или `2026-07-13`. По умолчанию — сегодня.

Пример запроса

https://kurs.com.ua/api/forex?key=YOUR_API_KEY&format=json

Пример ответа

{
  "date": "Mon, 13 Jul 2026 00:00:00 +0300",
  "rates": [
    { "currency": "EUR/USD", "rate": "1.142970", "change": "0.001340", "updated": "Mon, 13 Jul 2026 12:49:39 +0300" },
    { "currency": "GBP/USD", "rate": "1.339070", "change": "0.000130", "updated": "Mon, 13 Jul 2026 12:49:39 +0300" }
  ]
}

Фиксинг

GET /api/fixing

Ежедневный фиксинг наличного (nal) и безналичного (beznal) курса. Курс фиксируется каждый день в одно и то же время — удобно для договоров.

Параметр	Описание
`currencies`	Валюты через запятую: `usd`, `eur`, `rub`. По умолчанию — все.
`date`	Дата, на которую нужны курсы, напр. `13.07.2026` или `2026-07-13`. По умолчанию — сегодня.

Пример запроса

https://kurs.com.ua/api/fixing?key=YOUR_API_KEY&currencies=usd&format=json

Пример ответа

{
  "date": "Mon, 13 Jul 2026 00:00:00 +0300",
  "currencies": [
    {
      "id": "1",
      "symbol": "USD",
      "updated": "Mon, 13 Jul 2026 12:00:00 +0300",
      "rates": {
        "nal": 44.50, "nal_change": 0.02,
        "nal_bid": 44.45, "nal_bid_change": 0.02,
        "nal_ask": 44.55, "nal_ask_change": 0.02,
        "beznal": 44.40, "beznal_change": 0.01,
        "beznal_bid": 44.35, "beznal_bid_change": 0.01,
        "beznal_ask": 44.45, "beznal_ask_change": 0.01
      }
    }
  ]
}