{"uid":"cap_FkqeF0fHqpndBxRFTDhIq","slug":"nbu-data-ukraine-official-uah-exchange-rates-92831d40","name":"NBU Data Ukraine – Official UAH Exchange Rates","description":"Official National Bank of Ukraine (NBU) exchange rates of the hryvnia (UAH) on a date: 40+ currencies, gold, silver and SDR, with English names. Call it when you need the legally official UAH rate for Ukrainian accounting, tax, invoices or customs, or to convert to/from UAH on a given date. Params: date (YYYY-MM-DD, default today in Kyiv), currency (ISO code, optional; omit for all).","url":"https://nbu.navistri.com/v1/rates?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Date the rate applies to, YYYY-MM-DD, from 1996-09-02 to tomorrow (Kyiv). Default: today."},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"ISO 4217 code such as USD, EUR, PLN, XAU. Omit to get every published currency."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["date","base","count","rates"],"properties":{"base":{"const":"UAH"},"date":{"type":"string","format":"date"},"count":{"type":"number"},"rates":{"type":"array","items":{"type":"object","required":["currency","rate","units","ratePerUnit"],"properties":{"name":{"type":["string","null"],"description":"English name"},"rate":{"type":"number","description":"UAH per `units` units of the currency"},"setOn":{"type":["string","null"],"description":"Date the NBU set the rate"},"units":{"type":"number"},"nameUk":{"type":["string","null"],"description":"Ukrainian name"},"currency":{"type":"string","description":"ISO 4217 alphabetic code"},"numericCode":{"type":["number","null"]},"ratePerUnit":{"type":"number","description":"UAH per 1 unit of the currency"},"specialConditions":{"type":["boolean","null"],"description":"USD only: rate set under special conditions"}}}}}},"meta":{"type":"object","properties":{"terms":{"type":"string"},"cached":{"type":"boolean"},"params":{"type":"object"},"source":{"type":"string"},"endpoint":{"type":"string"},"sourceUrl":{"type":"string"},"retrievedAt":{"type":"string","format":"date-time"},"upstreamUrl":{"type":"string"}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CKtiDTwjAeTUJbc1WSLlJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the official National Bank of Ukraine (NBU) hryvnia exchange rates for 40+ currencies, gold, silver, and SDR on a given date, with English names.","exampleAgentPrompt":"What is the official NBU hryvnia exchange rate for USD and EUR today? I need the legally official rates for a Ukrainian invoice.","exampleUseCases":[{"title":"UAH invoice rate for accounting","prompt":"I need the official NBU hryvnia rate for USD on 2024-11-15 — it's for a Ukrainian accounting invoice and has to be the legally official NBU rate."},{"title":"Customs declaration currency conversion","prompt":"What was the official National Bank of Ukraine rate for EUR on 2025-01-10? I'm filling out a customs declaration and need the exact NBU rate for that date."},{"title":"All UAH rates snapshot for tax filing","prompt":"Can you pull all the official NBU exchange rates for hryvnia from 2024-12-31? I need every currency they publish for a year-end tax filing."}],"resultDescription":"Returns a JSON object with the date, base currency (UAH), and an array of currency rate objects each containing: ISO code, English name, Ukrainian name, numeric code, units, UAH rate per units, UAH rate per single unit, the date the rate was set, and a special-conditions flag for USD. Also includes metadata such as source URL, retrieval timestamp, caching status, and terms.","failureModes":["Date out of range (before 1996-09-02 or beyond tomorrow Kyiv time) returns an error","Invalid or unsupported currency ISO code returns an empty rates array or error","Malformed date format (not YYYY-MM-DD) returns a validation error","Network or upstream NBU API unavailability may return a 5xx error","Currency code not published by NBU returns no rate entry"],"whenToPreferThis":"Choose this endpoint when you need the legally official UAH exchange rate as published by the National Bank of Ukraine — required for Ukrainian accounting, tax filings, customs declarations, and official invoicing. It provides historical rates back to 1996, covers 40+ currencies plus gold, silver, and SDR, and returns English names alongside Ukrainian names. Prefer this over generic FX APIs when Ukrainian legal compliance is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:30:10.351Z","isFirstParty":false,"canonicalSlug":"nbu-data-ukraine-official-uah-exchange-rates-92831d40"}