NBU Data API

Official National Bank of Ukraine data for AI agents · Офіційні дані НБУ для ШІ-агентів

What it is

Clean JSON over the NBU's open data: official hryvnia exchange rates, rate history, the key policy rate, CPI inflation and government bond (OVDP) auctions. Agents pay per call in USDC through the x402 protocol. No sign-up, no API key.

Prices

GET /v1/ratesOfficial NBU hryvnia exchange rates on a date$0.001
GET /v1/rates/historyDaily official NBU rate history for one currency$0.003
GET /v1/key-rateNBU key policy rate and overnight rates on a date$0.001
GET /v1/inflationUkraine consumer price inflation (headline and core) for a month$0.002
GET /v1/ovdp/auctionsUkrainian government bond (OVDP) primary auction results$0.002

Calls that fail (bad parameters, no data, NBU down) are not charged.

How to pay

  1. Call an endpoint. You get 402 Payment Required with a PAYMENT-REQUIRED header.
  2. Your x402 client signs a USDC payment on Base Sepolia (testnet) to 0x44e5eBeB366Ab69A0a3C1c05080a01FE0d8013ef.
  3. Retry with PAYMENT-SIGNATURE. You get the data and a PAYMENT-RESPONSE receipt.

Machine-readable docs: llms.txt · openapi.json · health

Що це

Чистий JSON поверх відкритих даних НБУ: офіційні курси гривні, історія курсу, облікова ставка, інфляція (ІСЦ) і результати аукціонів ОВДП. Агенти платять за кожен виклик у USDC через протокол x402. Без реєстрації та API-ключів.

Ціни

Від $0,001 до $0,003 за виклик (таблиця вище). Невдалі виклики (помилка в параметрах, немає даних, НБУ недоступний) не оплачуються.

Як платити

  1. Викличте ендпоінт і отримайте 402 Payment Required із заголовком PAYMENT-REQUIRED.
  2. Клієнт x402 підписує платіж у USDC у мережі Base Sepolia (testnet) на адресу 0x44e5eBeB366Ab69A0a3C1c05080a01FE0d8013ef.
  3. Повторіть запит із заголовком PAYMENT-SIGNATURE і отримайте дані та квитанцію PAYMENT-RESPONSE.

Source / Джерело: National Bank of Ukraine open data (bank.gov.ua). Ukrainian public open data: free reuse including commercial use, with mandatory attribution to the source (Law of Ukraine 'On Access to Public Information', art. 10-1; https://bank.gov.ua/ua/open-data). Values are passed through unchanged. Not affiliated with or endorsed by the NBU.