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
      }
    }
  ]
}