moex-vibe/apps/docs/docs/backend/securities.md

SecuritiesModule

SecuritiesModule отвечает за поиск и фильтрацию финансовых инструментов MOEX.

Обзор

• Backend: SecuritiesModule (apps/backend/src/modules/securities/)
• Frontend: поисковая строка в layout и отдельная страница Screener по /screener
• Источник: MOEX ISS API

Search API

GET /api/v1/securities/search?q={query}&type={type}&limit={limit}

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

• type: all по умолчанию, share, bond.
• Результат: список SearchResultItem с secid, isin, shortName, type, listLevel.

Security Screener

GET /api/v1/securities/screener

Фильтрует весь board MOEX для акций или облигаций по рыночным параметрам.

Query parameters

Параметр	Тип	Описание
type	share | bond	Обязателен. Тип board для сканирования.
priceMin / Max	number	Диапазон цены: RUB для акций, проценты для облигаций
volumeMin	number	Минимальный дневной объём торгов
yieldMin / Max	number	Диапазон YTM, только для облигаций
durationMin / Max	number	Диапазон duration в годах, только для облигаций
changePercentMin	number	Минимальное дневное изменение цены в %, только для акций
sortBy	string	Поле сортировки: price, volume, yieldToMaturity, etc.
sortOrder	asc | desc	Направление сортировки
page / pageSize	number	Параметры пагинации

Детали реализации

Screener получает полный market board из MOEX одним batch request, кеширует данные на 60 секунд или стандартный market data TTL и применяет фильтрацию, сортировку и пагинацию на backend. Так сложные запросы остаются быстрыми и не перегружают MOEX API.