Курси валют API

Замовлення та активація ключа

Замовити доступ до API Ви можете у свому кабінеті, або через відповідне посилання на головній сторінці, після реєстрації на сайті.

Після замовлення та його оплати у Вашому кабінеті з'явиться оплачений, але не активований API ключ на вибраний тариф.



Як тільки необхідно почати використовувати ключ і працювати з нашим API натисніть кнопку активувати. 



У колонці Активація / Api Key з'явиться Ваш ключ, його і потрібно використовувати для підключення до API.


Адреса сервера

На будь-якому тарифі використовуйте наступну адресу серверу API:

http://kyrs.in.ua/api/

Ваш ключ (з поля "Активація / Api Key" особистого кабінету) має бути переданий методо GET в параметр "key".
Наприклад:

http://kyrs.in.ua/api/?key=612d159de07d7b3471b993ea6c4ec5ca

Відповідь від сервера: Тариф: Мінімум

{
  • results
    {
    • average
      {
      • usd
        {
        • buy24.63,
        • sell24.76
        },
      • eur
        {
        • buy27.25,
        • sell27.51
        },
      • pln
        {
        • buy6.17,
        • sell6.24
        },
      • time1467546748,
      • date"03-07-2016 14:52",
      • currencyExchange
        [
        • "westfinance",
        • "goverla",
        • "gost",
        • "pb"
        ]
      }
    }
}

Опис параметрів

  • results - містить всю відповідь від сервера
  • average - середні курси по всіх обмінниках по 3 валютний парах
  • average/currencyExchange - список всіх обмінників, курси яких використовувались для вирахування середнього курсу.
  • time - timestamp моменту на котрий рахувався середній курс
  • date - те саме, що й time, але у форматі дати

Відповідь від сервера: Тариф: Стандарт

{
  • results
    {
    • goverla
      {
      • usd
        {
        • buy"24.65",
        • sell"24.74"
        },
      • eur
        {
        • buy"27.30",
        • sell"27.45"
        },
      • pln
        {
        • buy"6.18",
        • sell"6.23"
        },
      • timeCheck"1467546841",
      • dateCheck"03.07.2016 14:54",
      • dateOn"02-07-16"
      },
    • westfinance
      {
      • usd
        {
        • buy"24.65",
        • sell"24.75"
        },
      • eur
        {
        • buy"27.25",
        • sell"27.50"
        },
      • pln
        {
        • buy"6.17",
        • sell"6.25"
        },
      • timeCheck"1467546841",
      • dateCheck"03.07.2016 14:54",
      • dateOn"03-07-2016"
      },
    • gost
      {
      • usd
        {
        • buy"24.60",
        • sell"24.72"
        },
      • eur
        {
        • buy"27.25",
        • sell"27.45"
        },
      • pln
        {
        • buy"6.17",
        • sell"6.24"
        },
      • timeCheck"1467546309",
      • dateCheck"03.07.2016 14:45",
      • dateOn"03-07-2016"
      },
    • pb
      {
      • usd
        {
        • buy"24.62",
        • sell"24.81"
        },
      • eur
        {
        • buy"27.20",
        • sell"27.62"
        },
      • timeCheck"1467546902",
      • dateCheck"03.07.2016 14:55",
      • dateOn"03-07-2016"
      },
    • average
      {
      • usd
        {
        • buy24.65,
        • sell24.75
        },
      • eur
        {
        • buy27.28,
        • sell27.48
        },
      • pln
        {
        • buy6.18,
        • sell6.24
        },
      • time1467546906,
      • date"03-07-2016 14:55",
      • currencyExchange
        [
        • "westfinance",
        • "goverla"
        ]
      }
    }
}

Опис параметрів

    • results - містить всю відповідь від сервера
    • average - середні курси по всіх обмінниках по 3 валютний парах
    • average/currencyExchange - список всіх обмінників, курси яких використовувались для вирахування середнього курсу.
    • time - timestamp моменту на котрий рахувався середній курс
    • date - те саме, що й time, але у форматі дати
    • goverla, westfinance, gost, pb - обміння пункти (GOVERLA.UA, WEST-FINANCE, GOST.LUTSK.UA, ПриватБанк відповідно)
    • dateOn - змінна котру містить массив з курсами кожного обмінника - дата на котру виставлений курс. Деякі обмінники на свята на вихідні не змінюють дату, тому їх курс на святкові та вихідні дні може бути не актуальний.


    Відповідь від сервера: Тариф: Максимум

    {
    • results
      {
      • goverla
        {
        • usd
          {
          • buy"24.65",
          • sell"24.74"
          },
        • eur
          {
          • buy"27.30",
          • sell"27.45"
          },
        • pln
          {
          • buy"6.18",
          • sell"6.23"
          },
        • timeCheck"1467547021",
        • dateCheck"03.07.2016 14:57",
        • dateOn"02-07-16"
        },
      • westfinance
        {
        • usd
          {
          • buy"24.65",
          • sell"24.75"
          },
        • eur
          {
          • buy"27.25",
          • sell"27.50"
          },
        • pln
          {
          • buy"6.17",
          • sell"6.25"
          },
        • timeCheck"1467547021",
        • dateCheck"03.07.2016 14:57",
        • dateOn"03-07-2016"
        },
      • gost
        {
        • usd
          {
          • buy"24.60",
          • sell"24.72"
          },
        • eur
          {
          • buy"27.25",
          • sell"27.45"
          },
        • pln
          {
          • buy"6.17",
          • sell"6.24"
          },
        • timeCheck"1467546932",
        • dateCheck"03.07.2016 14:55",
        • dateOn"03-07-2016"
        },
      • pb
        {
        • usd
          {
          • buy"24.62",
          • sell"24.81"
          },
        • eur
          {
          • buy"27.20",
          • sell"27.62"
          },
        • timeCheck"1467547141",
        • dateCheck"03.07.2016 14:59",
        • dateOn"03-07-2016"
        },
      • average
        {
        • usd
          {
          • buy24.65,
          • sell24.75
          },
        • eur
          {
          • buy27.28,
          • sell27.48
          },
        • pln
          {
          • buy6.18,
          • sell6.24
          },
        • time1467547152,
        • date"03-07-2016 14:59",
        • currencyExchange
          [
          • "westfinance",
          • "goverla"
          ]
        },
      • kros
        {
        • usdpln
          {
          • buy"3.9611",
          • sell"3.9645",
          • date"03.07.2016 01:01",
          • time"1467496862"
          },
        • eurpln
          {
          • buy"4.4097",
          • sell"4.4141",
          • date"03.07.2016 01:01",
          • time"1467496862"
          },
        • eurusd
          {
          • buy"1.1135",
          • sell"1.1135",
          • date"03.07.2016 14:59",
          • time"1467547141"
          }
        },
      • exchange
        [
        • {
          • lat"50.7553477",
          • lon"25.3541874",
          • type"westfinance",
          • title"WEST-FINANCE",
          • description"м.Луцьк, (Порт Сіті) Сухомлинського, 1 з 10:00 по 22:00"
          },
        • {
          • lat"50.7468448",
          • lon"25.3267503",
          • type"westfinance",
          • title"WEST-FINANCE",
          • description"м.Луцьк п-т Волі 9 м-н "Столична ювелірна фабрика" з 10:00 по 20:00"
          },
        • {
          • lat"50.746476",
          • lon"25.3295397",
          • type"westfinance",
          • title"WEST-FINANCE",
          • description"м.Луцьк пр. Волі 15 магазин "Укр. Ювелір""
          },
        • {
          • lat"51.2012204",
          • lon"24.6725236",
          • type"westfinance",
          • title"WEST-FINANCE",
          • description"м.Ковель вул. Варшавська буд. з(б) АЗС "WOG" цілодобово"
          },
        • {
          • lat"51.2183858",
          • lon"24.7074738",
          • type"westfinance",
          • title"WEST-FINANCE",
          • description"м.Ковель б-р Лесі Українки 18 магазин "МТС" з 10:00 по 18:30"
          },
        • {
          • lat"51.1949306",
          • lon"23.8361445",
          • type"westfinance",
          • title"WEST-FINANCE",
          • description"Любомльский р-н с.Старовойтове вул.Прикордонників 7(а) АЗС "БРСМ-Нафта" цілодобово"
          },
        • {
          • lat"51.2606545",
          • lon"25.5289979",
          • type"westfinance",
          • title"WEST-FINANCE",
          • description"Маневицький р-н с. Оконськ вул. Київська 2 АЗС "Журавлина" цілодобово"
          },
        • {
          • lat"50.8473618",
          • lon"24.3095564",
          • type"westfinance",
          • title"WEST-FINANCE",
          • description"м. Володимир-Волинський вул. Устилузька 91а АЗС "Окко" Цілодобово"
          },
        • {
          • lat"50.751104",
          • lon"25.3374653",
          • type"goverla",
          • title"GOVERLA.UA",
          • description"м.Луцьк вул. Шопена 22 +38 (***) ***-**-** "
          },
        • {
          • lat"50.7587674",
          • lon"25.3514973",
          • type"kompas-kurs",
          • title"Kompas-kurs.com.ua",
          • description"м. Луцьк, вул. Карпенка-Карого,1а ( ТЦ « Караван » ) +** *** *** ** **"
          },
        • {
          • lat"50.7604433",
          • lon"25.3524957",
          • type"express",
          • title"Express.lutsk.ua",
          • description"м. Луцьк вул. Конякіна 39 (Автостанція Луцьк) тел: ***"
          },
        • {
          • lat"50.7529847",
          • lon"25.3400632",
          • type"kantor",
          • title"Kantor",
          • description"м. Луцьк вул. 8 березня 1 тел. **** час роботи: 9:00 - 19:00"
          }
        ]
      }
    }

    Опис параметрів

      • results - містить всю відповідь від сервера
      • average - середні курси по всіх обмінниках по 3 валютний парах
      • average/currencyExchange - список всіх обмінників, курси яких використовувались для вирахування середнього курсу.
      • time - timestamp моменту на котрий рахувався середній курс
      • date - те саме, що й time, але у форматі дати
      • goverla, westfinance, gost, pb - обміння пункти (GOVERLA.UA, WEST-FINANCE, GOST.LUTSK.UA, ПриватБанк відповідно)
      • dateOn - змінна котру містить массив з курсами кожного обмінника - дата на котру виставлений курс. Деякі обмінники на свята на вихідні не змінюють дату, тому їх курс на святкові та вихідні дні може бути не актуальний.
      • kros - массив котрий містить крос курси
      • exchange - массив містить всі обмінники додані до бази kyrs.in.ua (lat,lon - координати, type - внутрішній код обмінника в базі kyrs.in.ua, Title - назва, description - опис)

      Налаштування API ключа (тариф стандарт та максимум)

      На тарифах стандарт та максимум є можливість налаштувати роботу з сервісом kyrs.in.ua.

      Тариф "Стандарт" дозволяє вибрати, курси яких обмінників будуть враховані при розрахунку середнього курсу:



      А тариф "Максимум" додатково дозволяє налаштувати відправку курсів на Ваш сервер з певною періодичністю та/або при зміні курсу будь-якої з валют (з врахуванням крос-курсів).




      Приклад на мові PHP, як можна приймати курси валют:
      $arrayCurrency = json_decode($_POST['result'], true);
      print_r ($arrayCurrency);
      //ми отримаємо массив всіх данних у змінній $arrayCurrency.


      Приклад виконання коду:
      Array
      (
      [goverla] => Array
      (
      [usd] => Array
      (
      [buy] => 24.65
      [sell] => 24.74
      )

      [eur] => Array
      (
      [buy] => 27.30
      [sell] => 27.45
      )

      [pln] => Array
      (
      [buy] => 6.18
      [sell] => 6.23
      )

      [timeCheck] => 1467547922
      [dateCheck] => 03.07.2016 15:12
      [dateOn] => 02-07-16
      )

      [westfinance] => Array
      (
      [usd] => Array
      (
      [buy] => 24.65
      [sell] => 24.75
      )

      [eur] => Array
      (
      [buy] => 27.25
      [sell] => 27.50
      )

      [pln] => Array
      (
      [buy] => 6.17
      [sell] => 6.25
      )

      [timeCheck] => 1467547922
      [dateCheck] => 03.07.2016 15:12
      [dateOn] => 03-07-2016
      )

      [gost] => Array
      (
      [usd] => Array
      (
      [buy] => 24.60
      [sell] => 24.72
      )

      [eur] => Array
      (
      [buy] => 27.25
      [sell] => 27.45
      )

      [pln] => Array
      (
      [buy] => 6.17
      [sell] => 6.24
      )

      [timeCheck] => 1467547801
      [dateCheck] => 03.07.2016 15:10
      [dateOn] => 03-07-2016
      )

      [pb] => Array
      (
      [usd] => Array
      (
      [buy] => 24.62
      [sell] => 24.81
      )

      [eur] => Array
      (
      [buy] => 27.20
      [sell] => 27.62
      )

      [timeCheck] => 1467548042
      [dateCheck] => 03.07.2016 15:14
      [dateOn] => 03-07-2016
      )

      [average] => Array
      (
      [usd] => Array
      (
      [buy] => 24.65
      [sell] => 24.75
      )

      [eur] => Array
      (
      [buy] => 27.28
      [sell] => 27.48
      )

      [pln] => Array
      (
      [buy] => 6.18
      [sell] => 6.24
      )

      [time] => 1467548045
      [date] => 03-07-2016 15:14
      [currencyExchange] => Array
      (
      [0] => westfinance
      [1] => goverla
      )

      )

      [kros] => Array
      (
      [usdpln] => Array
      (
      [buy] => 3.9611
      [sell] => 3.9645
      [date] => 03.07.2016 01:01
      [time] => 1467496862
      )

      [eurpln] => Array
      (
      [buy] => 4.4097
      [sell] => 4.4141
      [date] => 03.07.2016 01:01
      [time] => 1467496862
      )

      [eurusd] => Array
      (
      [buy] => 1.1135
      [sell] => 1.1135
      [date] => 03.07.2016 15:14
      [time] => 1467548042
      )

      )

      [exchange] => Array
      (
      [0] => Array
      (
      [lat] => 50.7553477
      [lon] => 25.3541874
      [type] => westfinance
      [title] => WEST-FINANCE
      [description] => м.Луцьк, (Порт Сіті)
      Сухомлинського, 1
      з 10:00 по 22:00
      )

      [1] => Array
      (
      [lat] => 50.7468448
      [lon] => 25.3267503
      [type] => westfinance
      [title] => WEST-FINANCE
      [description] => м.Луцьк
      п-т Волі 9
      м-н "Столична ювелірна фабрика"
      з 10:00 по 20:00
      )

      [2] => Array
      (
      [lat] => 50.746476
      [lon] => 25.3295397
      [type] => westfinance
      [title] => WEST-FINANCE
      [description] => м.Луцьк
      пр. Волі 15
      магазин "Укр. Ювелір"
      )

      [3] => Array
      (
      [lat] => 51.2012204
      [lon] => 24.6725236
      [type] => westfinance
      [title] => WEST-FINANCE
      [description] => м.Ковель
      вул. Варшавська буд. з(б)
      АЗС "WOG"
      цілодобово
      )

      [4] => Array
      (
      [lat] => 51.2183858
      [lon] => 24.7074738
      [type] => westfinance
      [title] => WEST-FINANCE
      [description] => м.Ковель
      б-р Лесі Українки 18
      магазин "МТС"
      з 10:00 по 18:30
      )

      [5] => Array
      (
      [lat] => 51.1949306
      [lon] => 23.8361445
      [type] => westfinance
      [title] => WEST-FINANCE
      [description] => Любомльский р-н
      с.Старовойтове
      вул.Прикордонників 7(а)
      АЗС "БРСМ-Нафта"
      цілодобово
      )

      [6] => Array
      (
      [lat] => 51.2606545
      [lon] => 25.5289979
      [type] => westfinance
      [title] => WEST-FINANCE
      [description] => Маневицький р-н
      с. Оконськ
      вул. Київська 2
      АЗС "Журавлина"
      цілодобово
      )

      [7] => Array
      (
      [lat] => 50.8473618
      [lon] => 24.3095564
      [type] => westfinance
      [title] => WEST-FINANCE
      [description] => м. Володимир-Волинський
      вул. Устилузька 91а
      АЗС "Окко"
      Цілодобово
      )

      [8] => Array
      (
      [lat] => 50.751104
      [lon] => 25.3374653
      [type] => goverla
      [title] => GOVERLA.UA
      [description] => м.Луцьк
      вул. Шопена 22

      )

      [9] => Array
      (
      [lat] => 50.7587674
      [lon] => 25.3514973
      [type] => kompas-kurs
      [title] => Kompas-kurs.com.ua
      [description] => м. Луцьк,
      вул. Карпенка-Карого,1а
      ( ТЦ « Караван » )


      )

      [10] => Array
      (
      [lat] => 50.7604433
      [lon] => 25.3524957
      [type] => express
      [title] => Express.lutsk.ua
      [description] => м. Луцьк
      вул. Конякіна 39
      (Автостанція Луцьк)


      )

      [11] => Array
      (
      [lat] => 50.7529847
      [lon] => 25.3400632
      [type] => kantor
      [title] => Kantor
      [description] => м. Луцьк
      вул. 8 березня 1



      час роботи: 9:00 - 19:00
      )

      )

      )







      Контакти

      По питаннях додання обмінника, роботи з апі та інших, пишіть використовуючи форму нижче!