API i kursit të këmbimit në lekë

Nisja e shpejtë

Një kërkesë kthen të gjitha valutat, me kuotimin e secilit institucion pranë mesatares.

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})`);

// Një institucion i vetëm në vend të mesatares — undefined nëse nuk e kuotoi EUR-on këtë cikël:
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"])

Aksesi

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

Pa një çelës të vlefshëm, këto endpoint-e përgjigjen:

HTTP/1.1 403 Forbidden

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

Endpoint-et

URL-ja bazë: https://api.kursi.al. Çdo endpoint është një GET që kthen JSON; {code} është kodi ISO 4217 i valutës, me shkronja të mëdha ose të vogla.

{
  "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
    }
  }
}

Konventat

• Lekë për një njësi — gjithmonë. Çdo kurs është çmimi i 1 njësie të valutës së huaj në lekë. Përfshirë jenin dhe rublën, që Banka e Shqipërisë i publikon për 100: API-ja i kthen, që burimet të jenë drejtpërdrejt të krahasueshme.
• Blerja dhe shitja janë të institucionit. buy është ajo që ju paguan ai për valutën e huaj; sell është ajo që paguani ju për ta marrë.
• Çfarë është mesatarja. Mesatarja e çdo burimi që e kuotoi valutën në atë cikël. Kursi zyrtar i Bankës së Shqipërisë numërohet si një prej tyre; është kurs referues — blerja është e barabartë me shitjen dhe askush nuk këmben me të. Nëse ju duhet ajo që paguan një bankë a këmbimore e caktuar, lexojeni nga sources.
• Kuotimet e lëna jashtë mesatares. Disa banka i publikojnë valutat që tregtohen rrallë me një diferencë aq të gjerë sa nuk është ofertë (1.45 / 15.45 për koronën norvegjeze). Kur hendeku mes blerjes dhe shitjes është më shumë se gjysma e vetë kursit, kuotimi mbetet në sources me "in_avg": false dhe mesatarja e shpërfill. Kuotimet dukshëm të gabuara — larg çdo burimi tjetër, ose me një kërcim të pabesueshëm — nuk publikohen fare.
• Jo çdo burim kuoton çdo valutë. Një çelës që mungon te sources do të thotë se nuk pati kuotim. Për disa valuta, një këmbimore e vetme është i gjithë tregu; mesatarja e tyre është thjesht ai kuotim.
• Koha. Kurset ndjekin ditën shqiptare: datat janë Europe/Tirane. /api/rates, /api/rate dhe /health e mbajnë diferencën orare; /api/history kthen orën lokale pa të, dhe i lexon parametrat e datave po ashtu.
• Freskia dhe ruajtja. Burimet lexohen çdo 15 minuta. Përgjigjet mbajnë Cache-Control: max-age=60, prandaj një kërkesë më shumë se një herë në minutë kthen të njëjtin dokument — ruajeni nga ana juaj dhe qëndroni larg kufirit të kërkesave.

Valutat

Kundrejt lekut shqiptar (ALL):

Burimet

AVG pranohet kudo ku pranohet një burim, dhe do të thotë mesatarja. Më shumë për secilin institucion te faqja e burimeve.

Gabimet

Gabimet e validimit përdorin detail, të tjerët error. Në një dështim të rrallë të backend-it, një përgjigje 200 mund të mbajë { "error": … } në vend të të dhënave, prandaj trajtojeni mungesën e çelësit rates si dështim, në vend që të lexoni përtej tij.

Widgeti

Pa shkruar kod: një iframe që tregon kurset e ditës në faqen tuaj, me burimet dhe valutat që zgjidhni. Ngarkon një stil dhe një skript të vogël, dhe rifreskohet vetë.

Pyetje të shpeshta