---
title: "Bulgarian National Bank Exchange Rate API: Official Rates as JSON"
description: "Official Bulgarian National Bank daily exchange rates as JSON — ~29 currencies, history back to 2016. REST + npm SDK, free tier included."
canonical: https://allratestoday.com/blog/bnb-exchange-rate-api/
source: AllRatesToday (https://allratestoday.com/) — Markdown mirror of the page above; index of all pages at https://allratestoday.com/llms.txt
generated: 2026-10-16T12:19:08.414Z
---

**Bulgarian National Bank** publishes an official table of exchange rates once per business day — daily reference rates — covering 29 currencies against the EUR. These are the *published central bank rates* used for tax filings, customs valuations, audits, and compliant invoicing — not moving market prices. This guide shows how to pull them as JSON: via a REST endpoint or the zero-dependency [`bnb-exchange-rate`](https://www.npmjs.com/package/bnb-exchange-rate) npm package, with history back to 2016.

  What 1 unit buys in EUR — official Bulgarian National Bank reference rate Euros per 1 unit · table published 2026-08-04

*Source: Bulgarian National Bank published table for 2026-08-04 · data from the AllRatesToday API (`/api/v1/central-bank/bnb/latest`).*

## What the BNB publishes

- **29 currencies** against the EUR, in one table per business day.
- **History back to 2016** — queryable by exact date or as a daily time series.
- **The bank's own publication date** on every response, so a rate is always citable.
- **No weekend or holiday gaps to trip over** — requests for non-publication days resolve to the most recent published table and are flagged explicitly.

## Why official rates, not market rates

A live mid-market feed answers "what is EUR/USD trading at right now?" — the right tool for checkouts and dashboards. But accountants, auditors, and tax authorities ask a different question: "which rate were you *required* to use for this date?" That answer comes from the central bank's published table, and it never changes after publication.

Bulgaria adopted the euro on 1 January 2026, and the BNB now publishes ECB-style euro reference rates for 29 currencies. The API's history spans the changeover: BGN-denominated official rates before 2026, euro-denominated after — with the lev's fixed conversion rate of 1.95583 BGN per euro anchoring the two eras.

## Get the latest table (REST)

```
curl "https://allratestoday.com/api/v1/central-bank/bnb/latest" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

The response is the bank's most recent published table — one row per published pair in the bank's own quoting direction, the publication date (`rate_date`), and a freshness flag. Live example captured 2026-10-09:

```
{
  "bank": "bnb",
  "name": "Bulgarian National Bank",
  "rate_date": "2026-10-09",
  "age_days": 1,
  "stale": false,
  "cadence": "daily",
  "rates": [
    {"base": "EUR", "quote": "AUD", "type": "reference", "value": 1.6052},
    {"base": "EUR", "quote": "BRL", "type": "reference", "value": 5.6086},
    {"base": "EUR", "quote": "CAD", "type": "reference", "value": 1.5942},
    … 26 more rows
  ],
  "disclaimer": "Official rates as published by the named central bank. On weekends/holidays the most recent published rate_date is returned."
}
```

Most integrations need one pair. Add `source` and `target` and the API returns a single resolved rate — `derived: false` when Bulgarian National Bank printed the pair itself:

```
curl "https://allratestoday.com/api/v1/central-bank/bnb/latest?source=EUR&target=USD" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```
{
  "bank": "bnb",
  "name": "Bulgarian National Bank",
  "rate_date": "2026-10-09",
  "source": "EUR",
  "target": "USD",
  "rate": 1.1206,
  "rate_type": "reference",
  "derived": false,
  "method": "published",
  "age_days": 1,
  "stale": false,
  "cadence": "daily",
  "disclaimer": "Official rates as published by the named central bank. On weekends/holidays the most recent published rate_date is returned."
}
```

The latest table is available on every plan, including the free tier (300 free requests, no credit card). Since the table changes once per business day, caching it locally makes even a small quota go a long way.

## The npm SDK

```
npm install bnb-exchange-rate
```

```
import { getRate, getLatestRates } from 'bnb-exchange-rate';

// One pair at the official Bulgarian National Bank rate
const pair = await getRate('EUR', 'USD', { apiKey: 'art_live_...' });
console.log(pair.rate, pair.rate_date);

// The bank's full published table
const table = await getLatestRates({ apiKey: 'art_live_...' });
console.log(table.rate_date, table.rates.length);
```

Zero dependencies, TypeScript types included, and it runs anywhere `fetch` exists — Node 18+, Bun, Deno, and edge runtimes.

## Historical rates for an invoice date

The most common compliance job: an invoice dated months ago needs the official rate *for that date*.

```
import { getRatesForDate, getHistory } from 'bnb-exchange-rate';

// The official table for an invoice date — weekends/holidays return
// the most recent published date, flagged via published_on_requested_date.
const day = await getRatesForDate('2026-06-30', { apiKey: 'art_live_...' });

// Daily series for one pair
const series = await getHistory(
  { source: 'EUR', target: 'USD', from: '2026-01-01' },
  { apiKey: 'art_live_...' }
);
```

Historical dates and time series need a [paid plan](https://allratestoday.com/pricing/); the latest table stays free.

## Published vs derived pairs

If the BNB does not print a pair directly, the API resolves it from the bank's table — an inverse, or a cross rate via EUR — and flags it `derived: true` with the method used. Official and computed values are never silently mixed, which is exactly the distinction an auditor will ask about.

## FAQ

### Does Bulgarian National Bank have an official exchange rate API?

Bulgarian National Bank publishes its official rates on its website, but not always in a developer-friendly form. AllRatesToday serves the bank's published table as clean JSON — 29 currencies, with history back to 2016 — via REST or the bnb-exchange-rate npm package. The latest table is free.

### How often do Bulgarian National Bank rates update?

Once per business day. These are published reference rates, not moving market prices — the table changes when the BNB publishes a new one, and every API response carries the bank's own publication date so you can cite it.

### Can I get the Bulgarian National Bank rate for a past date, like an invoice date?

Yes. The /central-bank/bnb/rates-for-date endpoint returns the official table for any date back to 2016. Weekends and holidays resolve to the most recent published table and are flagged, so your audit trail stays honest. Historical dates require a paid plan; latest rates are free.

## Official Bulgarian National Bank rates, as JSON

The latest table is free — 300 free requests, no credit card.

 [Get your free API key](https://allratestoday.com/register/)

## Related Articles

- [Bulgarian National Bank rates API — product page](https://allratestoday.com/central-bank-rates-api/bnb/)
- [All covered central banks](https://allratestoday.com/central-bank-rates-api/)
- [CBBH Exchange Rate API: Official BAM Rates as JSON](https://allratestoday.com/blog/cbbh-exchange-rate-api/)
- [BCRP Exchange Rate API: Official PEN Rates as JSON](https://allratestoday.com/blog/bcrp-exchange-rate-api/)
- [Central bank API documentation](https://allratestoday.com/docs/#central-bank)
- [Best exchange rate APIs in 2026 — how the official-rate and market-rate providers compare](https://allratestoday.com/best/best-exchange-rate-api/)