Перед началом

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

  • Создавайте токен только на официальной странице Т-Банка.
  • Сохраняйте токен сразу после выпуска: брокер показывает его только один раз.
  • Если у вас несколько счетов, заранее выберите счет, который будете использовать в терминале.

Marbito Terminal не является брокером. Все операции выполняются через брокерский счет пользователя. Актуальные правила выпуска и отзыва токена всегда проверяйте в официальной документации Т-Банка.

Получите API-ключ

API-ключ в документации Т-Банка называется токеном T-Invest API. Он нужен для авторизации терминала при обращении к брокерскому API. Без токена работа с T-Invest API невозможна.

  1. Откройте официальную инструкцию Т-Банка. Перейдите на страницу про токены T-Invest API. Там Т-Банк объясняет, что такое токен, какие бывают права доступа, и дает переход в настройки профиля Т-Инвестиций.
  2. Перейдите в настройки профиля Т-Инвестиций. Чтобы не искать переход вручную, используйте кнопку ниже «Открыть настройки Т-Инвестиций». Авторизуйтесь, если потребуется, и найдите блок управления токенами T-Bank Invest API.
  3. Выпустите токен T-Invest API. Выберите реальный контур, если планируете работать с настоящим брокерским счетом. Песочница предназначена только для тестов.
  4. Выберите права доступа. Для просмотра данных достаточно read-only токена. Для выставления заявок через терминал нужен токен с торговыми правами. Не включайте лишние права, если они не нужны.
  5. Скопируйте токен сразу. Сохранить выпущенный токен позже нельзя: если вы его потеряли, нужно создать новый и отозвать старый.
Открыть настройки Т-Инвестиций Открыть инструкцию Т-Банка по токену

Практический маршрут такой: сначала откройте инструкцию T-Bank Dev Portal, чтобы понять права токена, затем перейдите в настройки Т-Инвестиций и выпустите токен там. Мы вынесли обе ссылки рядом, чтобы не заставлять вас искать нужный раздел самостоятельно.

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

Срок действия и перевыпуск токена

По официальной документации Т-Банка срок жизни токена T-Invest API составляет три месяца с даты последнего использования. Если терминал регулярно обращается к брокерскому API, дата последнего использования обновляется. Если токен долго не использовался, он может стать неактуальным.

  • После долгого перерыва. Если вы не пользовались терминалом несколько месяцев, перед торговлей проверьте подключение или заранее выпустите новый токен.
  • При ошибке авторизации. Если брокер возвращает ошибку неактуального или неверного токена, отзовите старый токен и создайте новый.
  • При подозрении на утечку. Если токен мог попасть третьим лицам, сразу удалите его в настройках Т-Инвестиций и выпустите новый.
  • При смене прав доступа. Если вы выпустили read-only токен, а затем хотите выставлять заявки через терминал, создайте новый токен с нужными правами.

Для безопасности лучше использовать отдельный токен только для Marbito Terminal и удалять старые токены, которыми вы больше не пользуетесь. Планово перевыпускать активный токен каждый месяц не требуется, но перед важной торговой сессией стоит проверить, что подключение к брокеру работает.

Найдите номер брокерского счета

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

По официальному FAQ T-Invest API номер брокерского счета можно получить несколькими способами:

  • Через T-Invest API. Метод GetAccounts возвращает список открытых счетов.
  • Через браузерную версию Т-Инвестиций. Откройте Т-Инвестиции в браузере, выберите нужный счет и проверьте номер в строке браузера.
  • Через брокерский отчет. Закажите отчет и найдите номер счета в документе.

В справке Т-Банка также указано, что номер можно найти в документе «Лицевые счета». В личном кабинете путь выглядит так: «Инвестиции» → «Портфель» → «Еще» → «О счете» → «Документы» → «Лицевые счета». В приложении можно скачать отчет по нужному счету и найти поле «Договор».

FAQ T-Invest API Справка Т-Банка по номеру счета
  • Если у вас несколько счетов, проверьте, какой именно счет будет использоваться для торговли.
  • Для ИИС, обычного брокерского счета и других типов счетов могут использоваться разные идентификаторы.

Введите данные в Marbito Terminal

API-токен и номер счета вводятся не на сайте, а в самом терминале. Этот шаг появляется после проверки лицензионного ключа и создания или ввода PIN-кода.

  1. Откройте Marbito Terminal. На стартовом экране выберите вход в терминал или пункт «Уже есть доступ».
  2. Введите лицензионный ключ. Если это первый запуск, терминал попросит персональный ключ доступа.
  3. Создайте или введите PIN. Новый пользователь создает 6-значный PIN, а пользователь с активным доступом вводит уже созданный PIN.
  4. Дождитесь экрана «Подключение брокера». Если брокерские данные еще не сохранены, терминал откроет обязательный шаг подключения.
  5. Заполните поле «Broker API token». Вставьте токен T-Invest API полностью, без лишних пробелов в начале или конце строки.
  6. Заполните поле «Broker account id». Укажите номер брокерского счета, через который будет выполняться работа.
  7. Нажмите «Подключить брокера». После сохранения терминал проверит данные и начнет подготовку рабочей области.

Если брокерские данные уже сохранены, повторно вводить API-токен и номер счета обычно не нужно: после PIN терминал восстановит подключение и начнет подготовку рабочей области. Если брокерские данные были удалены или стали недействительными, экран подключения появится снова.

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

Что проверить, если подключение не работает

  • API-ключ скопирован полностью и без лишних символов.
  • Ключ не был отозван или заменен у брокера.
  • У ключа включены нужные разрешения.
  • Номер счета указан корректно.
  • У брокера нет технических ограничений или временной недоступности сервиса.
  • Интернет-соединение стабильно.

Если ошибка повторяется, сохраните текст ошибки, время возникновения, выбранный счет и описание действия, после которого появилась проблема. Это поможет быстрее найти причину.

Быстрый старт Все инструкции