Описание API-Банки
API-Банки предназначен для интеграции базы данных сайта analizbankov.ru в любые информационные системы (например, CRM, аналитические, банковские АРМ и другие системы).
С помощью сервиса вы сможете автоматизировать извлечение отчетных и расчетных показателей как отдельных банков, так и банковских групп.
Для подключения к системе API-Банки зарегистрируйтесь на сайте https://damia.ru, для тестового доступа подключите тариф API-Старт на странице https://damia.ru/damapi/index
Для изучения возможностей API-Банки скачайте демонстрационный файл Excel.
Сервис предлагает получать любую информацию из базы банков по заданному запросу. Для получения информации используются запросы с параметрами GET или POST. На выходе - строка в формате JSON.
Для выбора методов и ввода параметров можно использовать единый адрес входа: API
API состоит из нескольких программных интерфейсов:
Название метода | Команда | Описание |
---|---|---|
Значение показателя банка | bankdata | Позволяет получить значение показателя заданного банка за определенную дату |
Информация о банке | bankinfo | Позволяет получить общую информацию о банке |
Рейтинг банка от рейтинговых агентств | bankaraits | Позволяет получить информацию о рейтингах банка от рейтинговых агентств |
Информация по БИК банка | bankbic | Выводит информацию о БИК банка |
Значения группы показателей (методики) | bankotch | Позволяет получить значения всех показателей группы (методики) заданного банка за определенную дату |
Рейтинг банков | banksrait | Позволяет получать значения заданного показателя всех банков |
Сумма значений показателя пользовательского списка банков | listdata | Позволяет получить сумму значений показателя из заданного пользовательского списка банков за определенную дату |
Информация о показателе | pokinfo | Возвращает общую информацию о показателе и его формулу |
Статистика запросов (использования ключа) | stat | Возвращает информацию статистику о количестве использованных и доступных запросов по каждому из методов |
Значение показателя банка
Позволяет получить значение показателя заданного банка за определенную дату.
На входе подаются регистрационный номер банка, идентификатор или код показателя, дата, на выходе - строка JSON.
Адрес сервиса: https://analizbankov.ru/api/bankdata
Используется запрос GET или POST.
Параметры запроса:
Параметр | Тип данных и пример | Описание |
---|---|---|
bankregn | integer bankregn=1481 | Регистрационный номер банка |
pokid | integer pokid=6618 | Идентификатор показателя (указывается либо pokid, либо pokname) |
pokname | string pokname=ПКЛ | Строковый код показателя (указывается либо pokid, либо pokname) |
date | date date=2019-01-01 | Дата, на которую требуется информация |
key | string 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/bankaraits
Используется запрос GET или POST.
Параметры запроса:
Параметр | Тип данных и пример | Описание |
---|---|---|
bankregn | integer bankregn=1481 | Регистрационный номер банка |
date | date date=2019-01-01 | Дата, на которую требуется информация |
key | string key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий значение показателя.
Поля возвращаемого документа:
Имя | Тип | Описание |
---|---|---|
items | Array | Массив результатов |
Название | integer | Название рейтинга |
Агентство | integer | Название агентства, присвоивщего рейтинг (S&P, Moody`s, Fitch, Рус-Рейтинг, НРА, Эксперт РА, АК&M, АКРА, НКР) |
Тип | string | Тип рейтинга (Долгосрочный международный, Краткосрочный, Национальный, Прогноз) |
Значение | double | Значение показателя |
Примеры запросов.
https://analizbankov.ru/api/bankdata?bankaraits?date=2023-12-01&bankregn=1481&key=<Ваш ключ>
{
"items": [
{
"Название": "Национальный рейтинг «АКРА»",
"Агентство": "АКРА",
"Тип": "Национальный",
"Значение": "AAA(RU)"
},
{
"Название": "Прогноз рейтинга «АКРА»",
"Агентство": "АКРА",
"Тип": "Прогноз",
"Значение": "стабильный"
},
{
"Название": "Рейтинг кредитоспособности НКР",
"Агентство": "НКР",
"Тип": "Национальный",
"Значение": "AAA.ru"
}
]
}
Информация по БИК банка
Позволяет получить информацию по БИК банка.
На входе подается БИК банка, на выходе - строка JSON.
Адрес сервиса: https://analizbankov.ru/api/bankbic
Используется запрос GET или POST.
Параметры запроса:
Параметр | Тип данных и пример | Описание |
---|---|---|
bankbic | integer bankregn=044525823 | Регистрационный номер банка |
key | string key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий значение показателя.
Поля возвращаемого документа:
Имя | Тип | Описание |
---|---|---|
БИК | integer | БИК банка |
Наименование | string | Наименование банка (филиала) |
ЛатНаим | string | Латинское наименование банка |
РегНом | string | Регистрационный номер банка (филиала) |
Адрес | string | Адрес банка (филиала) |
ДатаВвода | string | Дата ввода информации |
ТипУчастника | string | Тип участника |
SWIFT | string | SWIFT код |
СчетНомер | string | Номер счета |
СчетЦБНаим | string | Наименование учреждения ЦБ, где открыт счет |
СчетСтатус | array | Статус счета |
URRS | string | Дата кода URRS (если есть) |
LWRS | string | Дата кода LWRS (если есть) |
LMRS | string | Дата кода LMRS (если есть) |
CLRS | string | Дата кода CLRS (если есть) |
Примеры запросов.
https://analizbankov.ru/api/bankinfo?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/bankinfo
Используется запрос GET или POST.
Параметры запроса:
Параметр | Тип данных и пример | Описание |
---|---|---|
bankregn | integer bankregn=1481 | Регистрационный номер банка |
key | string key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий значение показателя.
Поля возвращаемого документа:
Имя | Тип | Описание |
---|---|---|
РегНом | integer | Регистрационный номер банка |
Банк | string | Сокращенное наименование банка (только название) |
КраткНаим | string | Краткое наименование банка |
ПолнНаим | string | Полное наименование банка |
Тип | string | Вид финансового учреждения (Банк или НКО) |
ОПФ | string | Организационно-правовая форма |
ДатаРег | string | Дата регистрации (в формате ДД.ММ.ГГГГ) |
ТипЛиц | string | Тип лицензии (пусто - если имеется лицензия, АНН - аннулирована, ОТЗ - отозвана, ПРС - реорганизация банка, САН - санируемый банк) |
Адрес | string | Адрес банка |
Телефоны | string | Телефоны банка |
Лицензия | array | Лицензии, выданные банку |
АСВ | string | Участие в АСВ (Да или Нет) |
ОГРН | string | ОГРН банка |
Примеры запросов.
https://analizbankov.ru/api/bankbic?bankbic=044525823&key=<Ваш ключ>
{
"БИК": "044525823",
"Наименование": "БАНК ГПБ (АО)",
"ЛатНаим": "Gazprombank (Joint Stock Company) (Bank GPB (JSC))",
"РегНом": "354",
"Адрес": "117420, ул Намёткина, 16, к 1",
"ДатаВвода": "1994-01-20",
"ТипУчастника": "20",
"SWIFT": "GAZPRUMMXXX",
"СчетНомер": "30101810200000000823",
"СчетЦБНаим": "ГУ БАНКА РОССИИ ПО ЦФО",
"СчетСтатус": "ACAC"
}
Значения группы показателей (методики)
Позволяет получить значения всех показателей группы (методики) заданного банка за определенную дату.
На входе подаются регистрационный номер банка, код группы показателей, дата, на выходе - строка JSON, содержащая массив результатов.
Адрес сервиса: https://analizbankov.ru/api/bankotch
Используется запрос GET или POST.
Параметры запроса:
Параметр | Тип данных и пример | Описание |
---|---|---|
bankregn | integer bankregn=1481 | Регистрационный номер банка |
poktype | string poktype=cb0 | Код группы показателей |
date | date date=2019-01-01 | Дата, на которую требуется получить информацию |
key | string key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий значение показателя.
Поля возвращаемого документа:
Имя | Тип | Описание |
---|---|---|
items | Array | Массив результатов |
pokid | integer | Идентификатор показателя (числовой) |
pokname | integer | Код показателя (строковый) |
Название | string | Наименование показателя |
Сумма | double | Значение показателя |
parent_pokid | string | Идентификатор вышестоящего показателя |
Примеры запросов.
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.
Параметры запроса:
Параметр | Тип данных и пример | Описание |
---|---|---|
pokid | integer pokid=4 | Идентификатор показателя (указывается либо pokid, либо pokname) |
pokname | string pokname=Н3 | Строковый код показателя (указывается либо pokid, либо pokname) |
date | date date=2019-01-01 | Дата, на которую требуется информация |
cond | string cond=in list (56) | Условие обработки данных. Возможные значения: in list (n1,n2,...) - банк находится в одном из пользовательских списков n1,n2,...; not in list (n1,n2,...) - банк не находится в одном из списков n1,n2,... . Необязательный параметр. |
key | string key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий массив значений показателей.
Поля возвращаемого документа:
Имя | Тип | Описание |
---|---|---|
items | Array | Массив результатов |
РегНом | 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.
Параметры запроса:
Параметр | Тип данных и пример | Описание |
---|---|---|
groupid | integer groupid=15 | Идентификатор пользовательской группы банка |
pokid | integer pokid=6618 | Идентификатор показателя (указывается либо pokid, либо pokname) |
pokname | string pokname=ПКЛ | Строковый код показателя (указывается либо pokid, либо pokname) |
type | string type=count | Как обрабатывать данные (суммировать, вычислять среднее, подсчитывать количество). Возможные значения: sum - сумма (по умолчанию), avg - среднее арифметическое, count - количество. Необязательный параметр. |
cond | string cond=sum>0 | Условие обработки данных. Возможные значения: sum>0 - учитывать только положительные значения; sum>0 - учитывать только отрицательные значения; in list (n1,n2,...) - банк находится в одном из пользовательских списков n1,n2,...; not in list (n1,n2,...) - банк не находится в одном из списков n1,n2,... . Необязательный параметр. |
date | date date=2019-01-01 | Дата, на которую требуется информация |
key | string 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.
Параметры запроса:
Параметр | Тип данных и пример | Описание |
---|---|---|
pokid | integer pokid=6618 | Идентификатор показателя (указывается либо pokid, либо pokname) |
pokname | string pokname=ПКЛ | Строковый код показателя (указывается либо pokid, либо pokname) |
date | date date=2019-01-01 | Дата, на которую требуется информация (необязательный параметр) |
key | string key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий значение показателя.
Поля возвращаемого документа:
Имя | Тип | Описание |
---|---|---|
pokid | integer | Идентификатор показателя (числовой) |
pokname | integer | Код показателя (строковый) |
ПолнНаим | string | Полное наименование показателя |
Размерность | string | Размерность показателя (Т - тыс.руб, % - проценты, 2 - доли) |
Комментарий | string | Комментарий (если есть) |
poktype | string | Код группы показателей |
ДатаВвода | string | Дата ввода (в формате ДД.ММ.ГГГГ) |
parent_pokid | string | Идентификатор вышестоящего показателя |
Формула | 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.
Параметры запроса:
Параметр | Тип данных и пример | Описание |
---|---|---|
key | string key=1d7aa35df102bf4af08aeb1d6387d4b70ac4821e | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о ключе и количестве доступных и истраченных запросов.
Поля возвращаемого документа:
Имя | Тип | Описание |
---|---|---|
ДатаНач | string | Начальная дата использования API по заданному ключу |
ДатаОконч | string | Конечная дата использования API |
Методы | array | Статистика использования методов API |
sbankdata,bankinfo,bankotch,banksrait,listdata,pokinfo | array | Метод (выводится информация по каждому из доступных методов) |
Лимит | 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"
}
}
}