Monobank Currency Rates

Fetches live exchange rates from Monobank's public API endpoint GET /bank/currency.

Key constraints

• No authentication required — fully public endpoint
• Rate limit: Results are cached server-side and update at most every 5 minutes. Do NOT call more than once per 5 minutes.
• Response: Array of currency pair objects with buy/sell/cross rates

How to use

Step 1: Fetch rates

curl -s https://api.monobank.ua/bank/currency

Step 2: Parse the response

Each object in the response array contains:

Step 3: Map currency codes

Common ISO 4217 numeric codes:

• 980 = UAH (Ukrainian hryvnia)
• 840 = USD (US dollar)
• 978 = EUR (Euro)
• 826 = GBP (British pound)
• 985 = PLN (Polish zloty)
• 203 = CZK (Czech koruna)
• 756 = CHF (Swiss franc)
• 392 = JPY (Japanese yen)
• 156 = CNY (Chinese yuan)
• 933 = BYN (Belarusian ruble)
• 949 = TRY (Turkish lira)
• 36 = AUD (Australian dollar)
• 124 = CAD (Canadian dollar)
• 208 = DKK (Danish krone)
• 578 = NOK (Norwegian krone)
• 752 = SEK (Swedish krona)
• 643 = RUB (Russian ruble — may not be present)
• 818 = EGP (Egyptian pound)
• 10 = BTC (Bitcoin, non-standard)

Step 4: Present results

When presenting rates to the user:

1. Convert the Unix timestamp to human-readable format
2. Show buy/sell rates for major pairs (USD, EUR, GBP, PLN)
3. Show cross rates for exotic pairs
4. If the user asks about a specific currency, filter to that pair
5. Format rates to 2-4 decimal places depending on the pair
6. Note that these are Monobank's card rates, not cash rates

Example: filter USD/UAH with jq

curl -s https://api.monobank.ua/bank/currency | jq '.[] | select(.currencyCodeA == 840 and .currencyCodeB == 980)'

Example response object

{
  "currencyCodeA": 840,
  "currencyCodeB": 980,
  "date": 1713000000,
  "rateBuy": 41.25,
  "rateSell": 41.75
}

This means Monobank buys USD at 41.25 UAH and sells at 41.75 UAH.

Error handling

• HTTP 429: Rate limit exceeded. Wait 5 minutes before retrying.
• HTTP 403: IP blocked by AWS WAF. Usually auto-unblocks after 24 hours. The response body may contain HTML or the text "glory to Ukraine! glory to the heroes!"
• If the response is not valid JSON, the API may be temporarily unavailable.

Important notes

• These are card rates (cashless), not cash exchange rates
• Rates apply to Monobank customers' card transactions
• Not all currency pairs have buy/sell rates — some only have cross rates
• The endpoint returns ALL available pairs in one call; filter client-side
• Bitcoin (code 10) may appear with a cross rate if available