Тинькофф инвестиции api token

С 05.04.2021 пользователям intelinvest.ru стала доступна настройка прямой интеграции с брокером Тинькофф. В течение двух недель после выхода обновления мы провели несколько важных доработок, а также собрали самые частые вопросы пользователей, на которое постарались ответить в данной статье.

Безопасность

Как хранится у вас токен? Брокер не рекомендует передавать третьим лицам.

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

Что будет, если кто-то получит доступ в мой личный кабинет Intelinvest?

В случае доступа третьих лиц в личный кабинет пользователя скопировать или воспользоваться токеном API нельзя.
Intelinvest.ru не передает данные пользователей третьим лицам

Можно ли как-то (случайно) совершить сделку у брокера через Intelinvest?

Intelinvest.ru не оказывает брокерские услуги и не может отправлять торговые поручения через OpenAPI.

Решил отменить интеграцию, как убрать токен?

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

Настойка интеграции

Использовал загрузку отчетов брокера, как настроить интеграцию?

Используйте раздел Настройки — Импорт сделок. Выбрав в роли брокера Тинькофф перейдите в настройку интеграции(кнопка Интеграция).
Рекомендуем производить настройку интеграции в пустой портфель, не содержащий других сделок.
Проверка списка сделок по API происходит от последней сделки в портфеле до настоящего момента.

В окне настроек необходимо указать пароль, это пароль аккаунта?

В окне настроек необходимо указать ваш индивидуальный API токен для торговли (инструкция «как получить api токен» находится на странице импорта), и установить пароль (пароль может быть любым, но его необходимо запомнить).

Указал токен, но настройки не сохраняются

Настройка интеграции с API токеном для песочницы не производится.
Ознакомьтесь с подробной инструкцией «Как получить API токен» на странице импорта.

У меня несколько счетов, как настроить интеграцию?

Если у Вас больше 1 счета в Тинькофф, после указания токена и пароля появится поле выбора. Необходимо указать счет (как правило Брокерский или ИИС) по которому будет произведена настройка.
Для интеграции по нескольким счетам используйте отдельные портфели. Добавить портфель можно через Управление портфелями.

Уникальный номер счета в брокере Тинькофф отображается на странице , а также в выгружаемых отчетах брокера.

Добавил новую сделку у брокера, в Intelinvest ее нет. Как обновляются сделки?

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

Для обновления списка сделок перейдите в Импорт сделок, нажмите «Обновить данные» и укажите пароль для интеграции. Система проверит сделки от последней даты в портфеле до текущего момента и дополнит портфель необходимыми записями.
Через API попадает полный список сделок, даже если они совершены 5 минут назад.

Результаты импорта

Если в результатах импорта есть комментарий «Неверный идентификатор бумаги» напишите почту вашего аккаунта в службу технической поддержки. После проведения проверки данных поступающих от Tinkoff Open API будут внесены корректировки для автоматического распознавания таких бумаг.

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

РЕПО сделки не были импортированы

РЕПО (брокер может брать часть активов клиента в кредит, предоставляя за это вознаграждение) сделки не импортируются, так как не оказывают значительного влияния на расчеты доходности. На сумму вознаграждения за такие операции автоматически заводится корректировка баланса.

Маржинальная торговля(кредитное плечо)

Сделки маржинальной торговли на данный момент не учитываются. Импорт переносит сделки обычного режима торговли. Внести сделки с кредитным плечом можно через интерфейс ручного ввода в режиме портфеля PRO (Управление портфелями).Когда сделки будут попадать автоматически, без проверки пароля?

Прочие вопросы

Когда сделки будут попадать автоматически, без проверки пароля?

Отключение шифрования данных возможно после предоставления брокером токена, у которого доступ только на чтение записей(read only), без возможности отправить торговое поручение.

Будут ли интеграции с другими брокерами?

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

Будет ли интеграция доступна в мобильном приложении?

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

Источник

Протокол

Streaming market-data в качестве протокола транспорта использует WebSocket.

Ограничения

Доступно 6 TCP-соединений на одного пользователя.

Подписка на свечи

Параметр	Тип	Обязательность	Описание
event	string	+	Название события
time	string	+	Время в формате RFC3339Nano
payload	object	+	Структура свечи
payload.o	double	+	Цена открытия
payload.c	double	+	Цена закрытия
payload.h	double	+	Наибольшая цена
payload.l	double	+	Наименьшая цена
payload.v	double	+	Объем торгов
payload.time	string	+	Время в формате RFC3339
payload.interval	string	+	Interval
payload.figi	string	+	FIGI

candle:unsubscribe

Отписка от свечей

Подписка на стакан

Параметр	Тип	Обязательность	Описание
event	string	+	Название события
time	string	+	Время в формате RFC3339Nano
payload	object	+	Структура со стаканом
payload.depth	int	+	Глубина стакана
payload.bids	array[double,double]	+	Массив [Цена, количество] предложений цены
payload.asks	array[double,double]	+	Массив [Цена, количество] запросов цены
payload.figi	string	+	FIGI

orderbook:unsubscribe

Отписка от стакана

Подписка на информацию об инструменте

Параметр	Тип	Обязательность	Описание
event	string	+	Название события
time	string	+	Время в формате RFC3339Nano
payload	object	+	Структура с информацией по инструменту
payload.trade_status	string	+	Статус торгов
payload.min_price_increment	double	+	Шаг цены
payload.lot	double	+	Лот
payload.accrued_interest	double	—	НКД. Возвращается только для бондов
payload.limit_up	double	—	Верхняя граница заявки. Возвращается только для RTS инструментов
payload.limit_down	double	—	Нижняя граница заявки. Возвращается только для RTS инструментов
payload.figi	string	+	FIGI

instrument_info:unsubscribe

Отписка от информации об инструменте

Сообщения об ошибке

К любому запросу можно добавить необязательное поле request_id, которое будет использовано в сообщении об ошибке

Источник

API Тиньков.Инвестиции. Первые шаги

Практически с первых дней я стал клиентом Тиньков.Инвестиции.

И с этого же момента меня терзают смутные сомнения — отражает ли личный кабинет объективную реальность?

Дело в том, что я покупаю ценные бумаги, номинированные в долларах, но в ЛК цены всех активов отображаются в долларах, а итоговая стоимость портфеля в рублях.

И мне непонятно, это доллар вырос или я такой результативный инвестор?

А как же комиссии, налоги и прочие дивиденды?

Вот бы взять все мои сделки и расписать по ФИФО, как в складском учете… А сверху положить полученные дивиденды, а потом вычесть налоги.

Вот тогда я и увижу понятный мне результат.

Оказалось, у Тинькова есть API, которое позволяет писать торговых роботов (мне это совсем не интересно), а также загружать данные по своему портфелю и операциям.

У этого API есть официальное описание, но мне не все было понятно, пришлось разбираться.
Результаты этих разборок представляю вашему вниманию.

Получение токена и установка библиотеки

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

Цитирую официальную инструкцию по получению токена:

Зайдите в свой аккаунт на tinkoff.ru
Перейдите в раздел инвестиций
Перейдите в настройки
Функция «Подтверждение сделок кодом» должна быть отключена
Выпустите токен OpenApi для биржи и Sandbox. Возможно система попросит вас авторизоваться еще раз, не беспокойтесь, это необходимо для подключения робота к торговой платформе.
Скопируйте токен и сохраните, токен отображается только один раз, просмотреть его позже не получится, тем не менее вы можете выпускать неограниченное количество токенов.

На момент написания статью токен выдавался на странице www.tinkoff.ru/invest/settings, кнопка в нижней части страницы.

С токеном для песочницы у меня возникали ошибки, поэтому я начал экспериментировать с боевой версией. Чего и вам желаю (Осторожно: не купите-продайте случайно что-то лишнее).

Авторизация

Эти две строки делают все, что нам нужно.

Дальше работаем с переменной client.

Что у нас в портфеле

Получим содержимое ~~нашего~~ вашего портфеля:

Посмотрим основные данные первого элемента:

В моем случае это:

value — Цена бумаги
balance — Кличество бумаг в портфеле, value и currency — их денежное выражение.

figi — Financial Instrument Global Identifier (Финансовый Глобальный Идентификатор инструмента)
ticker — Тикер актива.

По этим данным мы можем узнать человекочитаемое название актива.

Для данного запроса нам это не нужно (см. поле name), но в других случаях пригодится.

Получаем название бумаги по FIGI и тикету

Эта API-функция у меня работает как надо. Видим, что ‘BBG000BWPXQ8’ -> ‘British American Tobacco’.

А вот поиск названия актива по тикеру у меня не работает :(((

Разработчики предложили обновить библиотеку, но даже после этого не взлетело.

Качаем справочник ценных бумаг

Впрочем, я решил этот вопрос кардинально. Скачал у Тинькова полный справочник торгуемых активов:

получил
Как видим, figi и name там есть. Для моих целей — более чем достаточно.

Получаем список операций

А вот самое интересное — получить список моих операций. В операции (в моем случае) попадают следующие действия:

PayIn — Пополнение брокерского счета
PayOut — Вывод денег
BuyCard — Покупка с карты
Sell — Продажа
BrokerCommission — Комиссия брокера
Dividend — Выплата дивидендов
Tax — Налоги
TaxDividend- Налоги c дивидендов
ServiceCommission — Комиссия за обслуживание

Код для выгрузки портфеля:

Посмотрим, что получилось. В моем случае, представляет интерес этот элемент Вот что он собой являет
Нас интересуют поля:

date — дата сделки
figi — код актива
operation_type — тип операции
payment — сумма операции. У налогов или комиссий указана именно она. price при этом None
price — цена одной бумаги
quantity — плановое количество бумаг
trades — реальные биржевые сделки

Сразу возник вопрос — зачем нам какие-то trades, если есть price и quantity?

Все не так просто (план и факт)

Как я понял, в quantity указано то количество бумаг, которые я хотел купить. А то, что фактически куплено, лежит в trades[i].quantity.

Т.е. если хотите обратится к фактическим сделкам, нужно перебрать то, что лежит в trades.

В ряде случаев, там None — например, для налогов или вводов/выводов средств.

Чтобы получить настоящие цифры, нужно смотреть и в сделки, и в биржевые операции:

Читают сейчас

Редакторский дайджест

Присылаем лучшие статьи раз в месяц

Скоро на этот адрес придет письмо. Подтвердите подписку, если всё в силе.

Вакансии

AdBlock похитил этот баннер, но баннеры не зубы — отрастут

Минуточку внимания

Комментарии 63

Оказалось, у Тинькова есть API, которое позволяет писать торговых роботов (мне это совсем не интересно)

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

Главная проблема — API очень простой, но одновременно и очень сырой. Часто тормозит и глючит. Поиграться — нормально, но если торговать профессионально, то есть варианты и получше.

Был бы рад ссылкам

Специализированные брокеры. Полноценно пока не интересовался этой темой, поэтому ссылок не дам.

Там в квике есть lua, на которой худо бедно можно накорябать робота, графики с индивидуальными индикаторами, или шлюз в другие миры.
Но квик что-то подтормаживает, знающие люди говорят, для htf надо брать плазу2 и колокейшн у брокера.

знающие люди говорят, для htf надо брать плазу2 и колокейшн у брокера

Рано или поздно пытливый программистский ум все равно захочет хоть немного HFT — бота с реакцией в несколько секунд. О миллисекундах, к сожалению, речи не идёт — это удел кровавого энтерпрайса и крупных игроков.

Я имею в виду тормоза самого Тинькоффа как сервиса. В обычном режиме там тоже всё исполняется в момент, но в периоды высокой активности на бирже, когда самое лучшее время делать деньги, он встаёт колом.

Но в целом я Т не особо за это ругаю: у него изначально была другая направленность — не на профессиональных трейдеров, а просто на желающих пощупать возможность заработка на инвестициях в долгосроке. API для торговли они предоставили совсем недавно.

Ну вот представьте: накупили вы этих плазов, поставили колокейшн в золотом корпусе, запустили скрипты и ждете. А на другом конце интернета сидят условные Мамут с Усмановым, смотрят на экраны своих HFT и ржут над вами.

Почему ржут? А потому что пока скрипит ваша плаза в колокейшне, у них уже миллиончик+миллиончик+миллиончик…

А в режиме read-only через API Тинькофф можно считать только свои позиции?

Имел ввиду получение собственных открытых позиций — цена покупки, дата, количество.
Без возможности торговли. Для синхронизации со своими сервисами по учету.

Кто-нибудь знает — Тинькофф единственный брокер, которые имеет своё открытое апи?
В первую очередь интересен только просмотр позиций без возможностей торговли.

В IB и так нет проблем с экспортом отчетов.
Проблема с рос. брокерами — нет единой формы, они периодически меняются, а сбербанк (бывший тройка диалог) — так в плане отчетов вообще ловить нечего — невозможно даже определить начальную цену позиции.

И оно открыто? А кто кроме Тинькова имеет открытое апи?

Тинькофф Инвестиции, ITI Capital (АО «ИК «Ай Ти Инвест»).
А знаете ещё кто имеет апи?

А после слияния с Фридом Финанс апи сохранилось?

Вот тут становится непонятно, что вы подразумеваете под «Открытым АПИ».

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

Я хотел бы через API получать свои открытые позиции в режиме только чтения.

И мне непонятно, это доллар вырос или я такой результативный инвестор?

Я себе написал замену Excel для учёта сделок.
Всё считает. Можно посмотреть состояние портфеля на любую дату. Главное все сделки в систему завести… Можно отчёт брокера импортировать. Зацените кто хочет, https://izi-invest.ru

Относительно «а итоговая стоимость портфеля в рублях» — у Тинькофф есть переключатель (в мобильных приложениях на значок рубля нажать, если не путаю), можно и в долларах смотреть

Вах, не прошло и полгода, что называется…

Когда я, будучи их клиентом, спросил о кусочке API для всего-то ежедневного получения курса евродоллара, меня первую неделю не могли понять вообще, вторую отвечали безопасники (упс? я вообще-то технарей спрашивал) разных уровней и задавали острожные, хоть и дурацкие на взгляд программиста, вопросы, а на третью посоветовали… парсить их главную страницу, где выводится курс…
Передовой банк, что уж тут.

Приветствую, коллега. Так вышло, что почти одновременно с вами я начал вынашивать идею о написании своего клиента для OpenAPI на Ruby. Как раз сегодня я зарелизил свою поделку, консольный клиент для вывода портфолио брокерского счёта.

Моя задача — сделать консольную утилиту для просмотра полной итоговой суммы и процентов моего портфеля. Однако, столкнулся с несколькими недостатками данного API.

1. Отсутствие итоговой суммы и процентов доходности в API. Хотя бы в приближённом виде. А это то, ради чего я вообще начал писать код.
2. Список позиций на счёте вроде хорош, но в нём не хватает процентов доходности и оценочной стоимости каждой позиции. Пришлось писать кучу кода для вычисления процентов.
3. Каждая позиция в своей валюте, это вроде понятно и правильно. Но когда я собрался посчитать общую стоимость, это вылилось в нетривиальную задачу. Оказывается в API нет биржевого курса долларов/евро. Пришлось считать так: брать данные своих активов доллар и евро и через сумму и доходность высчитывать курс к рублю. Потом я прохожу по списку позиций и каждую позицию умножаю на курс к рублю, чтобы получить рублёвый итог.

По итогу несмотря на кучу неточных вычислений я получил довольно точные цифры, отличающиеся от приложения на доли процентов. И мне порой даже кажется, что мои данные чуть точнее, поскольку я сам вывел все формулы и сам по ним считаю свои денежки 🙂

Во избежание ошибок float-вычислений, использую BigDecimal — этакий float с гарантированной десятичной точностью. То есть складывая 1.1 + 1.2 получится 2.3, а не 2.2999999999999.

API в целом рабочее, но немного бесполезненькое. Иногда замирает, иногда некоторые поля приходят нулевые, пару раз ловил 500. Может через вебсокеты получится что-то интересное добыть.

Я курс доллара тоже у Тинькова беру

cd2 = datetime.now(tz=timezone(‘Europe/Moscow’))
cd1 = cd2 — timedelta(days=3)
cur = client.market.market_candles_get(‘BBG0013HGFT4’, cd1, cd2, ‘day’)

if len(cur.payload.candles) == 0:
print(»)
else:
print(cur.payload.candles[len(cur.payload.candles) — 1])

Это инструмент USD000UTSTOM — курс с поставкой валюты «завтра», но меня устраивает.

Источник

Тинькофф инвестиции api token