НБУ: валютні курси та банківські метали

Пояснення й структура

id

nbu-rates

name

НБУ: валютні курси та банківські метали

group

Гроші й показники

kind

Часовий ряд

summary

Офіційний курс або облікова ціна на дату. Є перевірена відповідь API та збережена копія за 2026-09-16.

publisher

Національний банк України

sourceUrl

https://bank.gov.ua/ua/open-data

links

• label

  Документація валютних сервісів

  url

  https://finliteracy.bank.gov.ua/admin_uploads/article/Instr_API_KURS_VAL_Full_eng.pdf

formats

• JSON
• XML
• CSV у Ладі

access

GET API за валютою й датою; різні сервіси НБУ мають різні схеми та масштаб значень.

auth

Перевірений GET працює без ключа.

providerUpdates

Сервіс повертає значення на запитану дату. Час публікації та правила дії курсів потрібно звіряти з методологією НБУ; дата запиту не замінює дату курсу.

refreshAdvice

Пропозиція для системи: отримувати дані щодня, перевіряти дату відповіді та повторювати запит за відсутності потрібного дня. Це не налаштований розклад Ладу.

verification

GET JSON виконано 2026-09-16. Відповідь на 2026-09-16 збережено; перевірено дати й додатні значення.

extract

• Запитати визначену дату. Перевірити HTTP-статус, формат, дату кожного запису та валютний код.
• Зберегти оригінальну відповідь, дату отримання та контрольну суму.
• Під час зміни сервісу врахувати поля Units/Amount або rate; не переносити масштаб між схемами автоматично.

keys

• Код валюти або металу + дата курсу + сервіс

pitfalls

• Курс на дату не визначає, яку дату слід застосувати до конкретної операції.
• Список відповіді API не слід вважати повним світовим довідником валют.

conceptIds

• parameter
• rule
• payment

relatedIds

• nbu-banks

example

method

GET

url

https://bank.gov.ua/NBUStatService/v1/statdirectory/exchange?valcode=USD&date=20260916&json

note

Перевірений приклад на фіксовану дату; для іншої дати змінити date у форматі YYYYMMDD.

snapshot

Так / true