Разбирайте портфель Т-Инвестиций и котировки прямо в чате

Агент ходит в T-Invest API по адресу invest-public-api.tinkoff.ru/rest и читает четыре домена: брокерские счета и состав портфеля, котировки и свечи по инструментам, справочник бумаг с поиском по тикеру, названию и ISIN, а также выставленные заявки. Первым запросом он получает список счетов — без него неясно, по какому портфелю считать, а счетов у одного токена бывает несколько.

REST здесь — обёртка над gRPC-контрактом: каждый вызов это POST на имя метода вида UsersService/GetAccounts, параметры уходят телом, привычных query-строк нет. Портфель отдаётся не общей кучей, а по каждому счёту отдельно, поэтому сводку «сколько всего» агент собирает сам, обойдя счета и сложив позиции. Стоимость в ответе — текущая рыночная оценка, то есть срез на момент запроса, а не зафиксированный итог дня.

На чтении агент самостоятелен, на действиях — нет. Заявки он выставляет только если токен выпущен с full-access: на read-only токене API их просто не примет, и агент назовёт причину, а не сделает вид, что отправил. Перед отправкой на биржу такое действие он отдельно подтверждает с вами. Расчётного счёта, выписки и платёжных поручений здесь нет — это брокерский счёт, а банковские операции живут в коннекторе Т-Банк Бизнес.

Доступ даёт один токен T-Invest API, и все запросы идут от его имени. Токен живёт три месяца с последнего использования — после простоя API отвечает ошибкой 40003, и агент называет эту причину, а не показывает пустую таблицу. Лимиты у методов разные: справочники и котировки щедрее, операции по счёту строже, поэтому историю за длинный период агент запрашивает окнами и держит около двух с половиной запросов в секунду.