ინფოს დამატება
სიახლეების გამოგზავნა და NakBus-ის ავტოპარკი ახლა პარტნიორის დაფაზეა
დააკავშირეთ თქვენი დეველოპერის ანგარიში Nakordoni Partners ანგარიშთან იმავე ელფოსტით და მართეთ იქ სიახლეები და თქვენი ავტობუსების პარკი (NakDriver / NakManager) გუნდური როლებით. თქვენი API გასაღებები, endpoint-ები და აპლიკაციები უცვლელი რჩება, ხოლო აქაური გვერდები კვლავ მუშაობს. Nakordoni Partners-ის გახსნა

← ყველა ენდპოინტი

საუკეთესო გაცვლითი კურსების API Online

სად ვიყიდოთ ან გავყიდოთ ერთი ვალუტა PLN-ზე ერთ ქალაქში ახლავე: საუკეთესო საცალო კურსების მქონე პუნქტები რეიტინგში, NBP-ის ოფიციალური საცნობარო კურსის გვერდით. ეჯიბრებიან მხოლოდ 6 საათზე არაძველი კურსები, ხოლო ქალაქის მედიანას ძლიერ დაშორებული კოტირებები სავარაუდო შეცდომად გამოირიცხება. საბითუმო კურსები რეიტინგში არასოდეს ხვდება.

GET https://nakordoni.eu/api/v2/data/exchange-best-rates — კვოტის კლასი: cheap

პარამეტრიაღწერა
cityქალაქის id exchange-cities-დან, მაგ. warszawa (სავალდებულო)
currencyPLN-თან შესადარებელი ვალუტა, ISO 4217 კოდი, მაგ. EUR (სავალდებულო)
limitპუნქტები თითო სიაში, 1-20 (ნაგულისხმევად 5)
langქალაქის სახელისა და ბმულების ენა (ნაგულისხმევად en)

პასუხის ველები — პასუხის კონვერტის data ობიექტის შიგნით. [] აღნიშნავს სიას, ამიტომ data.items[].name არის თითოეული ელემენტის ველი name. ველი არის null, არ არსებობს ან ცარიელი სიაა, როცა მნიშვნელობა არ გვაქვს — შემავსებელს არასოდეს ვდებთ.

ველიაღწერა
data.best_to_buy_currency[]პუნქტები ყველაზე დაბალი გაყიდვის კურსით — სადაც ვალუტას ყველაზე იაფად იყიდით. rate ეს გაყიდვის კურსია PLN-ში 1 ერთეულზე.
data.best_to_sell_currency[]პუნქტები ყველაზე მაღალი ყიდვის კურსით — სადაც ვალუტაში ყველაზე მეტ PLN-ს მიიღებთ.
data.best_to_buy_currency[].vs_nbp_pctსხვაობა rate-სა და NBP-ის საშუალო კურსს შორის, პროცენტებში.
data.best_to_buy_currency[].rate_timeროდის მოქმედებდა კურსი, ISO 8601 პოლონეთის UTC წანაცვლებით; ასევე office_id, name, address, lat, lon, buy, sell, spread_pct და url.
data.candidatesსაკმარისად ახალი კურსის მქონე პუნქტები; 2-ზე ნაკლები ნიშნავს, რომ ორივე სია ცარიელია — შესადარებელი არაფერია.
data.nbpპოლონეთის ეროვნული ბანკის საცნობარო კურსი: mid (ცხრილი A), bid/ask (ცხრილი C) სადაც ქვეყნდება, table და effective_date; null ვალუტისთვის, რომელსაც NBP არ აქვეყნებს.
data.max_rate_age_minutesრეიტინგში დაშვებული ყველაზე ძველი კურსი (360).

საიდან მოდის მონაცემები

გადამცვლელი პუნქტების სიას და მათ კურსებს Nakordoni აგროვებს საჯარო ინფორმაციიდან, რომელსაც თავად პუნქტები აქვეყნებენ, ამოწმებს შეცდომებზე და აჩვენებს პოლონეთის ეროვნული ბანკის (NBP) ოფიციალური საცნობარო კურსის გვერდით. ყველა კურსს აქვს დრო, როდესაც ის მოქმედებდა; 72 საათზე ძველი კურსი მონიშნულია is_current: false და რეიტინგში არასოდეს ხვდება.

გადამცვლელ პუნქტებს ნებისმიერ დროს შეუძლიათ ნახონ, რას აგროვებს ჩვენი ბოტი, შეაჩერონ იგი ან მოითხოვონ თავიანთი ჩანაწერის შესწორება ან წაშლა. ჩანაწერები, რომელთა წაშლაც მფლობელმა მოითხოვა, ამ პროდუქტებიდანაც ქრება. NakordoniBot გადამცვლელი პუნქტებისთვის — ინფორმაცია და უარის თქმა

პუნქტის ყველა სტრიქონი შეიცავს url-ს — მის გვერდს nakordoni.eu-ზე. დაურთეთ ბმული იქ, სადაც მონაცემებს აჩვენებთ.

პასუხის მაგალითი

{
  "ok": true,
  "product": "exchange-best-rates",
  "data": {
    "city": "warszawa",
    "currency": "EUR",
    "quote_currency": "PLN",
    "kind": "retail",
    "candidates": 51,
    "best_to_buy_currency": [
      { "office_id": 197, "name": "Kantor …", "rate": 4.38, "buy": 4.365, "sell": 4.38,
        "spread_pct": 0.34, "vs_nbp_pct": 0.22, "rate_time": "2026-10-14T21:50:35+02:00",
        "url": "https://nakordoni.eu/en/exchange/warszawa/…" }
    ],
    "best_to_sell_currency": [ "…" ],
    "nbp": { "currency": "EUR", "mid": 4.3706, "bid": null, "ask": null,
             "table": "200/A/NBP/2026", "effective_date": "2026-10-14" }
  }
}
curl "https://nakordoni.eu/api/v2/data/exchange-best-rates?city=warszawa&currency=EUR&limit=5" \
  -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
🔑 შედით დეველოპერის ანგარიშით, რომ ეს ენდპოინტი პირდაპირ Sandbox-ში სცადოთ — დღეში 50 უფასო სატესტო გამოძახება. შესვლა

განახლდა