ВХОД
Вернуться

API для получения данных межбанка, средних курсов валютного аукциона и курсов в банках.

Чтобы получить доступ к API данных межбанка, НБУ, средних курсов валютного аукциона и курсов в банках, - необходимо:

  1. Предоставить нам свое название и адрес своего сайта для формирования ключа доступа, заполнив форму.
  2. Получить ключ доступа (40-символьный ключ).
  3. Настроить систему получения данных или в ручном режиме зайти по ссылкам:
    1. Межбанкhttp://api.minfin.com.ua/mb/[ключ]/[ГГГГ-ММ-ДД]/ для конкретной даты или http://api.minfin.com.ua/mb/[ключ]/ - для текущей даты.
    2. НБУhttp://api.minfin.com.ua/nbu/[ключ]/[ГГГГ-ММ-ДД]/ для конкретной даты или http://api.minfin.com.ua/nbu/[ключ]/ - для текущей даты.
    3. Курсы в банках - http://api.minfin.com.ua/summary/[ключ]/[ГГГГ-ММ-ДД]/ для конкретной даты или http://api.minfin.com.ua/summary/[ключ]/ - для текущей даты.
    4. Валютный аукцион - http://api.minfin.com.ua/auction/info/[ключ]/ - для текущей даты.
    5. Курсы для Visa/MasterCard - http://api.minfin.com.ua/card/[ключ]/[тип карты]/[ГГГГ-ММ-ДД]/ для конкретной даты и конкретного типа карты или http://api.minfin.com.ua/summary/[ключ]/[ГГГГ-ММ-ДД]/ - для конкретной даты и по всем типам карт
    6. или http://api.minfin.com.ua/summary/[ключ]/[тип карты]/ - для текущей даты и конкретного типа карты или http://api.minfin.com.ua/summary/[ключ]/ - для текущей даты по всем типам карт.
  4. Количество запросов к API не должно превышать 1 запрос раз в 5 минут.
  5. Указать ссылку на Финансовый портал "Минфин" на странице вашего сайта или приложения, где будут опубликованы курсы.

Результат JSON c данными:

Межбанк

[{"id":"20092","pointDate":" 2014-02-14 16:00:01","date":"2014-02-14 15:22:00","ask":"0.2509","bid":"0.2499","currency":"rub"}, - существующая точка

{"id":"20109","pointDate":"2014-05-07 11:08:44","date":"2014-05-07 11:01:00","ask":"","bid":"","currency":"usd","status":"deleted"}] - удаленная точка

где:

  • id - id точки,
  • pointDate - дата обновления точки,
  • pdate - дата,
  • bid - продажа,
  • ask - покупка,
  • currency - валюта,
  • status - указание, что точка была удалена. Принимает значение "deleted".

НБУ

{"usd":{"date":"2015-06-25 00:00:00", "ask":"21.17802000", "bid":"21.17802000", "trendAsk":"-0.34770000","trendBid":"-0.34770000", "currency":"usd"}, "eur":{"date":"2015-06-25 00:00:00", "ask":"23.74691400", "bid":"23.74691400", "trendAsk":"-0.37050300", "trendBid":"-0.37050300", "currency":"eur"} ,"rub":{"date":"2015-06-25 00:00:00", "ask":"0.39164000", "bid":"0.39164000", "trendAsk":"-0.00545000", "trendBid":"-0.00545000", "currency":"rub"}}

где:

  • Ключ - валюта,
  • date - дата,
  • bid - продажа,
  • ask - покупка,
  • trendBid - тренд продажи,
  • trendAsk - тренд покупки.

Курсы в банках

{"usd":{"bid":"21.2000","ask":"22.1100","trendAsk":-0.19,"trendBid":-0.3}, "eur":{"bid":"23.5000","ask":"25.0000","trendAsk":-0.2,"trendBid":-0.4}, "rub":{"bid":"0.3750","ask":"0.4100","trendAsk":-0.01,"trendBid":0}, "gbp":{"bid":"33.0000","ask":"35.1500","trendAsk":-0.45,"trendBid":0.3}}

где:

  • Ключ - валюта,
  • date - дата,
  • bid - продажа,
  • ask - покупка,
  • trendBid - тренд продажи,
  • trendAsk - тренд покупки.

Валютный аукцион

{"usd":{"ask":21.9,"bid":22,"askCount":"458","askSum":"4973113.00","bidCount":"338","bidSum":"4500310.00"},"eur":{"ask":24.55,"bid":24.8,"askCount":"150","askSum":"1340705.00","bidCount":"122","bidSum":"998931.00"},"rub":{"ask":"0.3950","bid":"0.4050","askCount":"89","askSum":"50235567.00","bidCount":"107","bidSum":"68226067.00"},"gbp":{"ask":33.8,"bid":34.95,"askCount":"10","askSum":"88700.00","bidCount":"16","bidSum":"65075.00"}}

где:

  • Ключ - валюта,
  • date - дата,
  • bid - продажа,
  • ask - покупка,
  • bidCount - количество заявок на продажу,
  • askCount - количество заявок на покупку,
  • bidSum - сумма на продажу,
  • askSum - сумма на покупку.

Курсы для Visa/MasterCard

[{"id":"37543","date":"2015-01-30 00:00:00","ask":"16.2575","bid":"16.1575","currency":"usd","card":"mc"},{"id":"37544","date":"2015-01-30 00:00:00","ask":"18.3401","bid":"18.2224","currency":"eur","card":"mc"},{"id":"32141","date":"2015-01-30 00:00:00","ask":"0.2338","bid":"0.2305","currency":"rub","card":"visa"},{"id":"37546","date":"2015-01-30 00:00:00","ask":"17.5076","bid":"17.3942","currency":"chf","card":"mc"},{"id":"37545","date":"2015-01-30 00:00:00","ask":"24.4562","bid":"24.3009","currency":"gbp","card":"mc"},{"id":"37550","date":"2015-01-30 00:00:00","ask":"12.5687","bid":"12.4865","currency":"aud","card":"mc"},{"id":"32242","date":"2015-01-30 00:00:00","ask":"11.7378","bid":"11.4714","currency":"nzd","card":"visa"}]

где:

  • id - id точки,
  • date - дата,
  • ask - покупка,
  • bid - продажа,
  • currency - валюта,
  • card - тип карты.

Для получения данных с minfin.com.ua необходимо посылать параметр заголовка user-agent (более подробное описание в RFC2616). Формат user-agent может быть таким:

"[ApplicationName]/[Version] ([http://link-to-your-application.com])",

где:

  • ApplicationName - название вашего приложения,
  • Version - версия,
  • http://link-to-your-application.com - ссылка на приложение\сайт либо краткое описание.

Например, "FinApplicationBot/1.0 (http://test.com)"

Установить user-agent в PHP возможно таким образом :

  • ini_set("user_agent","[текст user-agent]");
  • $site = file_get_contents($url);

Настоятельно просим не использовать user-agent браузеров (кроме тех случаев когда запрос действительно выполняется из-под браузера, например, с помощью JS).  

×
окно закроется через 20 секунд