Albanian lek exchange-rate API

Quick start

One request returns every currency, with each institution’s own quote next to the average.

curl https://api.kursi.al/api/rates

const { timestamp, rates } = await fetch('https://api.kursi.al/api/rates').then(r => r.json());

console.log(`1 EUR = ${rates.EUR.buy} / ${rates.EUR.sell} ALL (${timestamp})`);

// One institution instead of the average — undefined when it did not quote EUR in this run:
const bkt = rates.EUR.sources.BKT;

import requests

data = requests.get("https://api.kursi.al/api/rates", timeout=10).json()
eur = data["rates"]["EUR"]
print(eur["buy"], eur["sell"], data["timestamp"])

Access

curl "https://api.kursi.al/api/history/EUR?from_date=2026-09-01&to_date=2026-09-07&source=BKT" \
  -H "X-API-Key: your-key"

Without a valid key these endpoints answer:

HTTP/1.1 403 Forbidden

{ "detail": "This endpoint requires an API key. Contact info@oda.al for access and pricing." }

Endpoints

Base URL: https://api.kursi.al. Every endpoint is a GET that returns JSON; {code} is an ISO 4217 currency code, in any letter case.

{
  "timestamp": "2026-09-21T14:30:00+02:00",
  "rates": {
    "EUR": {
      "buy": 91.25,
      "sell": 91.71,
      "change": "-0.11%",
      "trend": "down",
      "sources": {
        "BOA":      { "buy": 91.49, "sell": 91.49 },
        "BKT":      { "buy": 91.15, "sell": 91.85 },
        "Iliria98": { "buy": 91.10, "sell": 91.80 }
      }
    },
    "NOK": {
      "buy": 7.74,
      "sell": 8.19,
      "change": "+0.13%",
      "trend": "up",
      "sources": {
        "BOA":        { "buy": 8.48, "sell": 8.48 },
        "Iliria98":   { "buy": 7.00, "sell": 7.90 },
        "Raiffeisen": { "buy": 1.45, "sell": 15.45, "in_avg": false }
      }
    }
  }
}

{
  "currency": "EUR",
  "timestamp": "2026-09-21T14:30:00+02:00",
  "sources": {
    "BOA":      { "buy": 91.49, "sell": 91.49 },
    "BKT":      { "buy": 91.15, "sell": 91.85 },
    "Iliria98": { "buy": 91.10, "sell": 91.80 }
  },
  "rate": 91.48,
  "buy": 91.25,
  "sell": 91.71,
  "type": "avg"
}

{
  "currency": "EUR",
  "timestamp": "2026-09-21T14:30:00+02:00",
  "sources": { "BOA": 91.49, "BKT": 91.15, "Iliria98": 91.1 },
  "rate": 91.25,
  "type": "buy"
}

[
  { "timestamp": "2026-09-01 09:00:00", "buy": 91.15, "sell": 91.85, "source": "BKT" },
  { "timestamp": "2026-09-01 09:15:00", "buy": 91.15, "sell": 91.85, "source": "BKT" },
  { "timestamp": "2026-09-01 09:30:00", "buy": null,  "sell": null,  "source": "BKT" }
]

{
  "labels": ["22 Aug", "23 Aug", "24 Aug"],
  "series": {
    "BOA": { "buy": [91.60, 91.58, 91.54], "sell": [91.60, 91.58, 91.54] },
    "BKT": { "buy": [91.20, null,  91.15], "sell": [91.90, null,  91.85] }
  }
}

{
  "status": "ok",
  "last_run": "2026-09-21T14:30:04+02:00",
  "database": "ok",
  "failing_sources": [],
  "sources": {
    "BKT": {
      "status": "ok",
      "last_success": "2026-09-21T14:30:02+02:00",
      "last_attempt": "2026-09-21T14:30:02+02:00",
      "consecutive_failures": 0,
      "currencies": 7
    }
  }
}

Conventions

• Lek per one unit — always. Every rate is the price of 1 unit of the foreign currency in lek. That includes the yen and the rouble, which the Bank of Albania publishes per 100: the API converts them, so sources are directly comparable.
• Buy and sell are the institution’s. buy is what it pays you for foreign currency; sell is what you pay to get it.
• What the average is. The mean of every source that quoted the currency in that run. The Bank of Albania’s official rate counts as one of them; it is a reference rate — buy equals sell, and nobody exchanges money at it. If you need what a particular bank or office pays, read it from sources.
• Quotes left out of the average. Some banks publish rarely traded currencies with a spread so wide that it is not an offer (1.45 / 15.45 for the Norwegian krone). When the gap between buy and sell is more than half the rate itself, the quote stays in sources with "in_avg": false and the average ignores it. Quotes that are plainly broken — far from every other source, or an implausible jump — are not published at all.
• Not every source quotes every currency. A missing key in sources means no quote. For some currencies a single office is the whole market; its average is simply that quote.
• Time. Rates follow Albania’s day: timestamps are Europe/Tirane. /api/rates, /api/rate and /health carry the UTC offset; /api/history returns local time without one, and reads its date parameters the same way.
• Freshness and caching. Sources are read every 15 minutes. Responses carry Cache-Control: max-age=60, so asking more than once a minute returns the same document — cache it on your side and you will stay far from the rate limit.

Currencies

Against the Albanian lek (ALL):

Sources

AVG is accepted wherever a source is, and means the average. More about each institution on the sources page.

Errors

Validation errors use detail, the others error. During a rare backend failure a 200 answer can carry { "error": … } in place of data, so treat a missing rates key as a failure rather than reading through it.

Widget

No code to write: an iframe that shows live rates on your site, in English, with the sources and currencies you choose. It loads one small stylesheet and script and refreshes itself.

FAQ