Примеры запросов для доступа по API
Примеры запросов для доступа к фундаментальным данным hit.finance по API
Разберем возможности API hit.finance на конкретных примерах.
Правила построения запроса
Доступ к данным hit.finance построен на базе REST API по адресу https://hit.finance/api/
На текущий момент реализовано два типа запросов:
- Получение основных списков (акции, дивиденды, инсайдеры, идеи)
- Получение детальных данных по компании
К каждому запросу необходимо добавлять свой токен доступа в виде параметра (?api_token=<ваш токен>).
Получение основных списков (акции, дивиденды, инсайдеры, идеи)
Для доступа к основным спискам данных, запрос формируется согласно шаблону:
https://hit.finance/api/<тип данных>?api_token=<ваш токен>,
Где <типом данных> могут быть:
- stocks - для получения данных из скринера акций
- bonds - для получения данных из скринера облигаций
- etfs - для получения данных из скринера etf
- dividends - для получения списка предстоящих/прошедших дивидендов
- events - для получения данных о предстоящих/прошедших событиях
- experts - для получения списка аналитиков
- ideas - для получения списка инвест-идей
- insiders - для получения сделок инсайдеров
- news - для получения новостей
Длина ответного списка фиксирована и зависит от <типа данных>. Для навигации по списку используйте параметр ?offset=<число>, который задает отступ от начала списка.
В запросах к типам данных (stocks, bonds, etfs, dividends, experts, ideas, insiders) можно также передавать фильтры для поиска в виде дополнительных параметров.
Чтобы узнать название нужного вам фильтра - используйте его в соответствующем разделе hit.finance и скопируйте из строки браузера соответствующую часть:
Пример - фильтрация списка акций по бирже:
- Выставляем нужный фильтр в скринере акций на hit.finance /
2. Копируем код и параметры фильтра из строки браузера
3. Добавляем фильтр к нашему запросу в виде параметра
- https://hit.finance/api/fm/stocks?api_token=<token>&exchange=MOEX,SPB
Получение данных по компании:
Для получения детальных данных по конкретной компании, используйте шаблон:
https://hit.finance/api/stocks/<код биржи>:<тикер>/<тип данных>?api_token=<ваш токен>,
Где <типом данных> могут быть:
- about - для получения информации о компании
- history - для получения исторических мультипликаторов по годам
- dividends - для получения списка дивидендов по компании
- insiders - для получения сделок инсайдеров по компании
- ideas - для получения списка инвест-идей по компании
- summary - для получения сводного рейтинга по компании
- multiples - для получения мультипликаторов компании
- owners - для получения структуры акционеров
- finance - для получения финансовой отчетности
- shares - для получения данных о количестве акций
Пример получения финансовой отчетности по компании Лукойл:
- https://hit.finance/api/fm/stocks/MOEX:LKOH/finance?api_token=<ваш токен>
Спасибо!