Files
ksv741 97069d6f6d
Docs security / security (pull_request) Successful in 6s
Docs verify / verify (pull_request) Successful in 11s
Conventional commits / commits (pull_request) Successful in 16s
Docs security / security (push) Successful in 9s
Docs verify / verify (push) Successful in 10s
docs: make documentation checks self-contained
2026-09-15 20:45:40 +03:00

4.9 KiB
Raw Permalink Blame History

Интеграция с MOEX ISS

MOEX ISS дополняет данные T-Bank публичной информацией об облигациях. Backend получает её по HTTPS в JSON с iss.moex.com; запросы содержат идентификаторы выпуска, без token T-Bank и идентификатора брокерского счёта. MOEX не определяет доступ пользователя к инвестициям и не подтверждает личное получение выплаты.

Данные и сопоставление выпуска

Данные MOEX Использование в WealthLedger
Эффективная доходность, цена её расчёта, целевая дата и время торгов Рыночный показатель на странице облигации
Купоны и оферты из календаря bondization Будущие события по текущим позициям
Дата погашения, номинал и валюта из описания выпуска Прогноз полного погашения в том же разделе событий

Для доходности backend сопоставляет SECID, ISIN и BOARDID с идентификаторами облигации T-Bank. Совпадения названия недостаточно. Значение сопровождается собственной ценой расчёта и временем MOEX; оно может отличаться от котировки T-Bank и не является личной доходностью инвестора.

Для календаря используется SECID, разрешённый из тикера позиции или её метаданных. Backend читает страницы календаря, затем применяет выбранный период и текущее количество бумаг. Смысл прогнозных сумм и ограничения оферты определяет область будущих выплат. Купонный календарь непосредственно на странице облигации получает данные через T-Bank GetBondCoupons; эти два пользовательских представления не следует считать одним источником календаря.

Недоступность и свежесть

HTTP-запрос ограничен таймаутом. Сеть, неуспешный HTTP-ответ, кроме 404, или некорректная структура ответа приводят к MOEX_UNAVAILABLE. 404 и отсутствие запрошенного блока означают отсутствие доступных данных; для доходности неподходящий выпуск или неполные обязательные значения также дают отсутствие показателя. Это отличается от отказа источника.

Последствие ошибки зависит от потребителя:

  • Метрики облигации отмечают недоступность доходности, сохраняя доступные показатели других источников.
  • Расчёт будущих событий завершается ошибкой 503, если необходимый календарь недоступен; частичный список не выдаётся за полный.

Клиент MOEX не использует очередь, повторы и лимитер gRPC T-Bank и не хранит собственный кэш. Повторное использование собранных метрик принадлежит странице облигации. Наличие успешного HTTP-ответа не гарантирует котировку без задержки.

Условия обработки источника в прогнозе закреплены в спецификации будущих событий. Точный механизм транспорта, разбора и сопоставления реализован в клиенте MOEX.