Official Hryvnia Exchange Rate by Currency and Date (National Bank of Ukraine)

nbu/exchange-rate

The official exchange rate the National Bank of Ukraine sets for a foreign currency against the hryvnia (UAH): hryvnias per one unit (or per the unit stated for the currency), for one date. Give a three-letter currency code such as USD, EUR, GBP or PLN, and a date as YYYYMMDD, and leave the code out for every currency the bank set on that date (about 45 rows). Each row has the numeric currency code, the currency name in Ukrainian, the rate, the letter code and the date the rate applies to. A currency the bank does not set, or a date with no rates, returns an empty list. National Bank of Ukraine open data, passed through unmodified and served by Eden Engine; not an official National Bank of Ukraine product.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

National Bank of Ukraine

Source: National Bank of Ukraine (bank.gov.ua), official exchange rates published as open data and passed through unmodified. Served by Eden Engine; not an official National Bank of Ukraine product.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "nbu/exchange-rate" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "nbu/exchange-rate" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "nbu/exchange-rate", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "nbu/exchange-rate", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0026

Updated: Oct 25, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^(?:19|20)\\d{2}(?:(?:0[13578]|1[02])(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)(?:0[1-9]|[12]\\d|30)|02(?:0[1-9]|[12]\\d))$",
      "description": "Date the rate applies to as YYYYMMDD, for example 20260102. A date the bank set no rates for returns an empty list."
    },
    "valcode": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Three-letter currency code, for example USD, EUR, GBP, PLN, CHF. Case is ignored. Leave out for every currency set on the date."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "r030",
          "txt",
          "rate",
          "cc",
          "exchangedate"
        ],
        "properties": {
          "cc": {
            "type": "string",
            "description": "Three-letter currency code, for example USD."
          },
          "txt": {
            "type": "string",
            "description": "Currency name in Ukrainian."
          },
          "r030": {
            "type": "integer",
            "description": "Numeric currency code (ISO 4217), for example 840 for the US dollar."
          },
          "rate": {
            "type": "number",
            "description": "Official rate in hryvnias per one unit of the currency."
          },
          "special": {
            "type": [
              "string",
              "null"
            ],
            "description": "Marker the bank attaches to a rate, or null when it attaches none."
          },
          "exchangedate": {
            "type": "string",
            "description": "Date the rate applies to as DD.MM.YYYY."
          }
        },
        "additionalProperties": true
      },
      "description": "One row per currency: a single row when a code is given, about 45 when it is left out, none when the code or date has no rate."
    }
  },
  "additionalProperties": false
}