Как пользоваться открытым API

Проверено: 8 ноября 2026 г.

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

Где это находится

Базовый адрес: https://finmind.uz/api/v1/. Интерактивная документация находится по адресам /api/v1/docs/ (Swagger) и /api/v1/redoc/, а машиночитаемая схема по адресу /api/v1/schema/. Рабочие примеры показаны на странице «Разработчикам». Деньги в JSON всегда передаются строкой, например «1234.50», а не числом с десятичной точкой; отсутствующее значение передаётся как null с указанием причины.

Публичные рыночные данные без входа

Токен для них не нужен: инструменты, акция по тикеру, облигация по ISIN, раскрытия, карта секторов и карта главной страницы в разделе /api/v1/public/market/. Они ограничены 600 запросами в минуту на каждый адрес клиента. Данные те же, что вы видите на публичных страницах, с указанием источника и даты.

Ваши собственные данные

Читайте свои данные

Шаг 1: Получите токен.Отправьте адрес электронной почты и пароль на /api/v1/auth/token/. Если включён двухфакторный вход, второй код вводится в рамках входа.
Шаг 2: Сохраните токен доступа.Он действует 30 минут.
Шаг 3: Отправляйте его с каждым запросом.Заголовок: Authorization: Bearer ACCESS_TOKEN.
Шаг 4: Обновите его.Отправьте токен обновления на /api/v1/auth/token/refresh/. Он действует 24 часа, а если при входе вы передали "remember": true, то 30 дней, и отсчёт начинается заново при каждом обновлении. Каждое обновление выдаёт новый токен обновления и отзывает старый.

Вошедший в систему человек может отправлять до 600 запросов в минуту. Сам вход допускает 10 запросов в минуту, а регистрация и форма обратной связи по 5 в минуту. У личного аккаунта Finmind нет API-ключа; ключи принадлежат организациям: см. Как настроить организацию: заявка, участники, роли и API-ключи.

Хороший тон

Кешируйте то, что не меняется, запрашивайте нужную страницу, а не весь список, и не оставляйте токен в коде, которым делитесь. На функцию, которой нет в вашем тарифе, Finmind отвечает кодом 403 и названием тарифа, который её открывает, а на превышение лимита запросов кодом 429.

Источник: настройки API Finmind, страница «Разработчикам» и сгенерированный справочник, прочитаны 8 ноября 2026 года.