Примеры запросов для доступа по API

Разберем возможности API FinanceMarker.ru на конкретных примерах.

💡
Статья не актуальна. Новая документация к API находится здесь https://financemarker.ru/api/swagger-ui/

Правила построения запроса

Доступ к данным FinanceMarker.ru построен на базе REST API по адресу https://financemarker.ru/api/

На текущий момент реализовано два типа запросов:

  • Получение основных списков (акции, дивиденды, инсайдеры, идеи)
  • Получение детальных данных по компании

К каждому запросу необходимо добавлять свой токен доступа в виде параметра (?api_token=<ваш токен>).

Получение основных списков (акции, дивиденды, инсайдеры, идеи)

Для доступа к основным спискам данных, запрос формируется согласно шаблону:

https://financemarker.ru/api/<тип данных>?api_token=<ваш токен>,

Где <типом данных> могут быть:

  • stocks - для получения данных из скринера акций
  • bonds - для получения данных из скринера облигаций
  • etfs - для получения данных из скринера etf
  • dividends - для получения списка предстоящих/прошедших дивидендов
  • events - для получения данных о предстоящих/прошедших событиях
  • experts - для получения списка аналитиков
  • ideas - для получения списка инвест-идей
  • insiders - для получения сделок инсайдеров
  • news - для получения новостей

Длина ответного списка фиксирована и зависит от <типа данных>. Для навигации по списку используйте параметр ?offset=<число>, который задает отступ от начала списка.

В запросах к типам данных (stocks, bonds, etfs, dividends, experts, ideas, insiders) можно также передавать фильтры для поиска в виде дополнительных параметров.

Чтобы узнать название нужного вам фильтра - используйте его в соответствующем разделе FinanceMarker.ru и скопируйте из строки браузера соответствующую часть:

Пример - фильтрация списка акций по бирже:

  1. Выставляем нужный фильтр в скринере акций на FinanceMarker.ru /
Задаем фильтры поиска на FinanceMarker.ru

2. Копируем код и параметры фильтра из строки браузера

Нужная часть в строке браузера

3. Добавляем фильтр к нашему запросу в виде параметра

  • https://financemarker.ru/api/fm/stocks?api_token=<token>&exchange=MOEX,SPB

Получение данных по компании:

Для получения детальных данных по конкретной компании, используйте шаблон:

https://financemarker.ru/api/stocks/<код биржи>:<тикер>/<тип данных>?api_token=<ваш токен>,

Где <типом данных> могут быть:

  • about - для получения информации о компании
  • history - для получения исторических мультипликаторов по годам
  • dividends - для получения списка дивидендов по компании
  • insiders - для получения сделок инсайдеров по компании
  • ideas - для получения списка инвест-идей по компании
  • summary - для получения сводного рейтинга по компании
  • multiples - для получения мультипликаторов компании
  • owners - для получения структуры акционеров
  • finance - для получения финансовой отчетности
  • shares - для получения данных о количестве акций

Пример получения финансовой отчетности по компании Лукойл:

  • https://financemarker.ru/api/fm/stocks/MOEX:LKOH/finance?api_token=<ваш токен>

Спасибо!

Ссылки по теме: