API-Банки предназначен для интеграции базы данных сайта analizbankov.ru в любые информационные системы (например, CRM, аналитические, банковские АРМ и другие системы).

С помощью сервиса вы сможете автоматизировать извлечение отчетных и расчетных показателей как отдельных банков, так и банковских групп.

Для подключения к системе API-Банки зарегистрируйтесь на сайте https://damia.ru, для тестового доступа подключите тариф API-Старт на странице https://damia.ru/damapi/index

Для изучения возможностей API-Банки скачайте демонстрационный файл Excel.

Сервис предлагает получать любую информацию из базы банков по заданному запросу. Для получения информации используются запросы с параметрами GET или POST. На выходе - строка в формате JSON.

Для выбора методов и ввода параметров можно использовать единый адрес входа: API

API состоит из нескольких программных интерфейсов:

Название методаКомандаОписание
Значение показателя банкаbankdataПозволяет получить значение показателя заданного банка за определенную дату
Информация о банкеbankinfoПозволяет получить общую информацию о банке
Значения группы показателей (методики)bankotchПозволяет получить значения всех показателей группы (методики) заданного банка за определенную дату
Рейтинг банковbanksraitПозволяет получать значения заданного показателя всех банков
Сумма значений показателя пользовательского списка банковlistdataПозволяет получить сумму значений показателя из заданного пользовательского списка банков за определенную дату
Информация о показателеpokinfoВозвращает общую информацию о показателе и его формулу
Статистика запросов (использования ключа)statВозвращает информацию статистику о количестве использованных и доступных запросов по каждому из методов

Значение показателя банка

Позволяет получить значение показателя заданного банка за определенную дату.

На входе подаются регистрационный номер банка, идентификатор или код показателя, дата, на выходе - строка JSON.

Адрес сервиса: https://analizbankov.ru/api/bankdata

Используется запрос GET или POST.

Параметры запроса:

ПараметрТип данных и примерОписание
bankregninteger
bankregn=1481
Регистрационный номер банка
pokidinteger
pokid=6618
Идентификатор показателя (указывается либо pokid, либо pokname)
poknamestring
pokname=ПКЛ
Строковый код показателя (указывается либо pokid, либо pokname)
datedate
date=2019-01-01
Дата, на которую требуется информация
keystring
key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e
Ваш ключ доступа к API

Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий значение показателя.

Поля возвращаемого документа:

ИмяТипОписание
СуммаdoubleЗначение показателя

Примеры запросов.

https://analizbankov.ru/api/bankdata?date=2019-01-01&pokid=2&bankregn=1&key=<Ваш ключ>

Пример ответа сервера...

{
  "Сумма": "16.149"
}

https://analizbankov.ru/api/bankdata?date=2019-01-01&pokname=ПКЛ&bankregn=1481&key=<Ваш ключ>

Пример ответа сервера...

{
  "Сумма": "1.0249834116132"
}

Информация о банке

Позволяет получить общую информацию о банке.

На входе подается регистрационный номер банка, на выходе - строка JSON.

Адрес сервиса: https://analizbankov.ru/api/bankinfo

Используется запрос GET или POST.

Параметры запроса:

ПараметрТип данных и примерОписание
bankregninteger
bankregn=1481
Регистрационный номер банка
keystring
key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e
Ваш ключ доступа к API

Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий значение показателя.

Поля возвращаемого документа:

ИмяТипОписание
РегНомintegerРегистрационный номер банка
БанкstringСокращенное наименование банка (только название)
КраткНаимstringКраткое наименование банка
ПолнНаимstringПолное наименование банка
ТипstringВид финансового учреждения (Банк или НКО)
ОПФstringОрганизационно-правовая форма
ДатаРегstringДата регистрации (в формате ДД.ММ.ГГГГ)
ТипЛицstringТип лицензии (пусто - если имеется лицензия, АНН - аннулирована, ОТЗ - отозвана, ПРС - реорганизация банка, САН - санируемый банк)
АдресstringАдрес банка
ТелефоныstringТелефоны банка
ЛицензияarrayЛицензии, выданные банку
АСВstringУчастие в АСВ (Да или Нет)
ОГРНstringОГРН банка

Примеры запросов.

https://analizbankov.ru/api/bankdata?bankregn=1000&key=<Ваш ключ>

Пример ответа сервера...

{
  "РегНом": "1000",
  "Банк": "ВТБ",
  "КраткНаим": "БАНК ВТБ (ПАО)",
  "ПолнНаим": "Банк ВТБ (публичное акционерное общество)",
  "Тип": "Банк",
  "ОПФ": "ПАО",
  "ДатаРег": "17.10.1990",
  "ТипЛиц": "",
  "Адрес": "190000, г. Санкт-Петербург, ул. Большая Морская, 29",
  "Телефоны": "(495) 739-77-99, 8-800-200-77-99",
  "Лицензия": [
    "Лицензия на привлечение во вклады и размещение драгоценных металлов (08.07.2015)",
    "Генеральная лицензия на осуществление банковских операций (08.07.2015)"
  ],
  "АСВ": "Да",
  "ОГРН": "1027739609391"
}

Значения группы показателей (методики)

Позволяет получить значения всех показателей группы (методики) заданного банка за определенную дату.

На входе подаются регистрационный номер банка, код группы показателей, дата, на выходе - строка JSON, содержащая массив результатов.

Адрес сервиса: https://analizbankov.ru/api/bankotch

Используется запрос GET или POST.

Параметры запроса:

ПараметрТип данных и примерОписание
bankregninteger
bankregn=1481
Регистрационный номер банка
poktypestring
poktype=cb0
Код группы показателей
datedate
date=2019-01-01
Дата, на которую требуется получить информацию
keystring
key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e
Ваш ключ доступа к API

Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий значение показателя.

Поля возвращаемого документа:

ИмяТипОписание
itemsArrayМассив результатов
pokidintegerИдентификатор показателя (числовой)
poknameintegerКод показателя (строковый)
НазваниеstringНаименование показателя
СуммаdoubleЗначение показателя
parent_pokidstringИдентификатор вышестоящего показателя

Примеры запросов.

https://analizbankov.ru/api/bankotch?date=2019-01-01&poktype=cb2_&bankregn=1&key=<Ваш ключ>

Пример ответа сервера...

{
  "items": [
    {
      "pokid": "6478",
      "pokname": "ROA",
      "Название": "ROA - Прибыльность активов",
      "Сумма": "0.018655588292063",
      "parent_pokid": "РентАкт"
    },
    {
      "pokid": "6479",
      "pokname": "ROE",
      "Название": "ROE - Прибыльность капитала",
      "Сумма": "0.11688961695588",
      "parent_pokid": "РентАкт"
    },
    {
      "pokid": "6480",
      "pokname": "Посн",
      "Название": "Прибыльность основных операций",
      "Сумма": "0.030502525156325",
      "parent_pokid": "РентАкт"
    },
				...
    {
      "pokid": "6509",
      "pokname": "Урб",
      "Название": "Уровень расходов по средствам бюджетов всех уровней и внебюджетным средствам",
      "Сумма": "0.048076439312799",
      "parent_pokid": "РентПС"
    }
  ]
}

Рейтинг банков

Позволяет получать значения заданного показателя всех банков (без сортировки).

На входе подаются идентификатор или код показателя, дата, на выходе - строка JSON, содержащая массив результатов.

Адрес сервиса: https://analizbankov.ru/api/banksrait

Используется запрос GET или POST.

Параметры запроса:

ПараметрТип данных и примерОписание
pokidinteger
pokid=4
Идентификатор показателя (указывается либо pokid, либо pokname)
poknamestring
pokname=Н3
Строковый код показателя (указывается либо pokid, либо pokname)
datedate
date=2019-01-01
Дата, на которую требуется информация
keystring
key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e
Ваш ключ доступа к API

Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий массив значений показателей.

Поля возвращаемого документа:

ИмяТипОписание
itemsArrayМассив результатов
РегНомintegerРегистрационный номер банка
БанкstringСокращенное наименование банка (только название)
СуммаdoubleЗначение показателя

Примеры запросов.

https://analizbankov.ru/api/banksrait?date=2019-01-01&pokname=Н1.0&bankregn=1&key=<Ваш ключ>

Пример ответа сервера...

{
  "items": [
    {
      "РегНом": "2306",
      "Банк": "АБСОЛЮТ БАНК",
      "Сумма": "11.105"
    },
    {
      "РегНом": "2879",
      "Банк": "АВАНГАРД",
      "Сумма": "18.547"
    },
    {
      "РегНом": "415",
      "Банк": "АВЕРС",
      "Сумма": "34.03"
    },
				...
    {
      "РегНом": "3516",
      "Банк": "ОНЕЙ БАНК",
      "Сумма": "15.795"
    }
  ]
}

Сумма значений показателя пользовательского списка банков

Позволяет получить сумму значений показателя из заданного пользовательского списка банков за определенную дату.

На входе подаются идентификатор пользовательской группы банка, идентификатор или код показателя, дата, на выходе - строка JSON.

Адрес сервиса: https://analizbankov.ru/api/listdata

Используется запрос GET или POST.

Параметры запроса:

ПараметрТип данных и примерОписание
groupidinteger
groupid=15
Идентификатор пользовательской группы банка
pokidinteger
pokid=6618
Идентификатор показателя (указывается либо pokid, либо pokname)
poknamestring
pokname=ПКЛ
Строковый код показателя (указывается либо pokid, либо pokname)
datedate
date=2019-01-01
Дата, на которую требуется информация
keystring
key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e
Ваш ключ доступа к API

Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий значение показателя.

Поля возвращаемого документа:

ИмяТипОписание
СуммаdoubleЗначение показателя

Примеры запросов.

https://analizbankov.ru/api/listdata?date=2019-01-01&pokid=2&groupid=1&key=<Ваш ключ>

Пример ответа сервера...

{
  "Сумма": "29.652"
}

Информация о показателе

Возвращает общую информацию о показателе и его формулу.

На входе подаются идентификатор или код показателя, дата (опционально), на выходе - строка JSON.

Адрес сервиса: https://analizbankov.ru/api/pokinfo

Используется запрос GET или POST.

Параметры запроса:

ПараметрТип данных и примерОписание
pokidinteger
pokid=6618
Идентификатор показателя (указывается либо pokid, либо pokname)
poknamestring
pokname=ПКЛ
Строковый код показателя (указывается либо pokid, либо pokname)
datedate
date=2019-01-01
Дата, на которую требуется информация (необязательный параметр)
keystring
key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e
Ваш ключ доступа к API

Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий значение показателя.

Поля возвращаемого документа:

ИмяТипОписание
pokidintegerИдентификатор показателя (числовой)
poknameintegerКод показателя (строковый)
ПолнНаимstringПолное наименование показателя
РазмерностьstringРазмерность показателя (Т - тыс.руб, % - проценты, 2 - доли)
КомментарийstringКомментарий (если есть)
poktypestringКод группы показателей
ДатаВводаstringДата ввода (в формате ДД.ММ.ГГГГ)
parent_pokidstringИдентификатор вышестоящего показателя
ФормулаstringФормула показателя

Примеры запросов.

https://analizbankov.ru/api/pokinfo?pokname=Дпбк&key=<Ваш ключ>

Пример ответа сервера...

{
  "pokid": "5516",
  "pokname": "Дпбк",
  "ПолнНаим": "Процентные доходы от размещения средств в кредитных организациях",
  "Размерность": "T",
  "Комментарий": "",
  "poktype": "cb2",
  "ДатаВвода": "01.01.2011",
  "parent_pokid": "5515",
  "Формула": "{СИМ11118} + {СИМ11119} + {СИМ11215} + {СИМ11216} + {СИМ11217} + {СИМ11300} + {СИМ11400} +
		{СИМ11803} + {СИМ11807} + {СИМ12118} + {СИМ12119} + {СИМ12215} + {СИМ12216} + {СИМ12217} + {СИМ12300} +
		{СИМ13118} + {СИМ13119} + {СИМ13215} + {СИМ13216} + {СИМ13217} + {СИМ13300} + {СИМ13400} + {СИМ13803} +
		{СИМ13807} - {СИМ33118} - {СИМ33119} - {СИМ33215} - {СИМ33216} - {СИМ33217} - {СИМ33300} - {СИМ33400} -
		{СИМ33803} - {СИМ33807} - {СИМ34118} - {СИМ34119} - {СИМ34215} - {СИМ34216} - {СИМ34217} - {СИМ34603} -
		{СИМ34607} - {СИМ35118} - {СИМ35119} - {СИМ35215} - {СИМ35216} - {СИМ35217} - {СИМ35300} - {СИМ35400} -
		{СИМ35803} - {СИМ35807}"
}

Статистика запросов (использования ключа)

Позволяет получить информацию о статистике использования ключа.

Адрес сервиса: https://analizbankov.ru/api/stat

Используется запрос GET или POST.

Параметры запроса:

ПараметрТип данных и примерОписание
keystring
key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e
Ваш ключ доступа к API

Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о ключе и количестве доступных и истраченных запросов.

Поля возвращаемого документа:

ИмяТипОписание
ДатаНачstringНачальная дата использования API по заданному ключу
ДатаОкончstringКонечная дата использования API
МетодыarrayСтатистика использования методов API
sbankdata,bankinfo,bankotch,banksrait,listdata,pokinfoarrayМетод (выводится информация по каждому из доступных методов)
ЛимитStringВаш лимит запросов по этому методу
ИстраченоStringКоличество истраченных запросов

Примеры запросов.

https://analizbankov.ru/api/stat?key=<Ваш ключ>

Пример ответа сервера...

{
  "ДатаНач": "2019-04-22 00:00:00",
  "ДатаОконч": "2020-04-21 00:00:00",
  "Методы": {
    "bankdata": {
      "Лимит": "10000",
      "Истрачено": "6"
    },
    "bankinfo": {
      "Лимит": "10000",
      "Истрачено": "29"
    },
    "bankotch": {
      "Лимит": "10000",
      "Истрачено": "14"
    },
    "banksrait": {
      "Лимит": "10000",
      "Истрачено": "23"
    },
    "listdata": {
      "Лимит": "10000",
      "Истрачено": "15"
    },
    "pokinfo": {
      "Лимит": "10000",
      "Истрачено": "39"
    }
  }
}