Live

Dokumentimi i API-t

Integroni kursin e këmbimit në kohë reale direkte në website-in ose aplikacionin tuaj për tregun shqiptar.

Autentikimi

Për çdo kërkesë drejt API-t, duhet të dërgoni çelësin tuaj individual (API Token) në header-in e kërkesës:

X-API-Key: kodi-juaj-personal
Shënim: Çelësi i API-t sigurohet nga stafi i Kursi.al pas regjistrimit të projektit tuaj.

Endpoint-et Kryesore

Kurset Aktuale

FALAS
GET /api/rates

Kthen listën e të gjitha valutave kryesore me çmimet e blerjes dhe shitjes nga të gjitha burimet tona.

Request Body (Options)

  • Metoda: GET
  • Body: Nuk ka (Dërgohet bosh)

Response Example

{
  "timestamp": "2026-01-18T18:00:00",
  "rates": {
    "EUR": { "buy": 103.50, "sell": 104.20, "change": "+0.05%" },
    "USD": { "buy": 95.20, "sell": 96.10, "change": "-0.10%" }
  }
}

Historiku Profesional

ME PAGESË
GET /api/history/{code}

Shërbim i avancuar për kërkime tregu, eksport të dhënash dhe analiza trendi afatgjata.

Request Body (Options)

  • Metoda: GET
  • Parametrat:
    • from_date: Data e fillimit (e.g. 2026-01-01)
    • to_date: Data e mbarimit (e.g. 2026-01-15)
    • source: BOA, BKT, Raiffeisen, etj (Default: AVG)

Response Example

[
  { 
    "timestamp": "2026-01-18 10:00:00", 
    "buy": 103.5, 
    "sell": 104.2, 
    "source": "AVG" 
  },
  { 
    "timestamp": "2026-01-18 11:00:00", 
    "buy": 103.48, 
    "sell": 104.18, 
    "source": "AVG" 
  }
]
Për të marrë qasje në të dhënat historike profesionale, ju lutemi na kontaktoni për planet e abonimit.

Shembull me cURL

curl -X GET "http://localhost:8000/api/rates" \
  -H "X-API-Key: kodi-juaj-personal"

Pyetjet e Shpeshta për API

Ju jeni të lutur të na dërgoni një kërkesë me emrin e projektit tuaj në info@oda.al. Ne do t'ju gjenerojmë një token të dedikuar.

Magazinimi dhe analizimi i miliona pikave të të dhënave kërkon infrastrukturë të dedikuar. Planet tona të historikut ofrojnë eksport në Excel/CSV dhe analizë trendi për bizneset.

Po, API falas ka limitime standarde rate-limiting për të garantuar stabilitetin e shërbimit për të gjithë. Për kërkesa të pakufizuara, ju lutemi na kontaktoni.

Gati për të nisur?

Na dërgoni një email për të marrë çelësin tuaj të parë API sot.

Na Kontakto për Zhvillim