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

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

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

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

Одно но: если вы покупали инструменты из расширенного списка, в журнале операций по этим инструментам не будет, и для статистики API уже не годится

Оказалось, у Тинькова есть API,

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

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

Подскажите, не пойму никак. portfolio_get() возвращает пустой портфель почему-то, а market_search_by_ticker_get() возвращает инфу про бумагу без цены. А у меня задача получить цену акции. Можете подсказать как?

Приветствую, коллега. Так вышло, что почти одновременно с вами я начал вынашивать идею о написании своего клиента для 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 — курс с поставкой валюты «завтра», но меня устраивает.

instr = client.market.market_search_by_figi_get('BBG0013HGFT4')
print(instr)

У тинькова продвинутый подход к API: они используют OpenApi довольно новой версии 3.0. Я взялся было за ейный чемодан за написание api клиента для раста (Rust), но оказалось, что swagger-codegen поддерживает раст только в ветке для OpenApi 2.0.
В итоге я написал рабочий модуль генератора для OpenApi 3.0, который генерит вполне себе апишечку для раста через swagger.yaml. Вот он: rust-swagger-codegen_v3
Из последнепофикшенного — исправил передачу даты в запросе.

Короче поюзал я этот апи и разочаровался.
Кстати поиграться с ним можно здесь tinkoffcreditsystems.github.io/invest-openapi/swagger-ui без всяких скачиваний непонятных библиотек…
Использовать его проще, чем это описано во всяких инструкциях. Просто посылаешь post запрос на нужный адрес с нужным заголовком и получаешь данные в json формате…

А разочаровался в том, что через команду /operations нельзя получить сведения о движениях денежных средств (ввод, вывод дс, получение дивидендов, купонов и т.д....) Из-за этого для меня этот апи перестал быть интересным.
А ещё там код бумаги выдаётся не привычный ISIN, а какой-то экзотический FIGI… Я смог через тот же апи сделать таблицу соответствия ISIN и FIGI, но как-то заморочно всё выходит…
А ещё нет ограничений по правам токена. Если выпустил токен, то он либо sandbox, который вообще ни чего не может, либо боевой, который вообще всё может (покупать, продавать), а мне нужен к примеру токен, который может только получать историю сделок, но такого нет.

1. Только не ФИФО, как в складском учете, а ЛИФО как в бухгалтерском, точнее в 2НДФЛ.
ЛИФО позволяет получить налоговый вычет за счет старых бумаг, так как доход от продажи имущества бывшего во владении более 3 лет налогом не облагается. Акции в том числе.

2. У дивов налогообложение другое, поэтому сначала учесть налоги в них, потом складывать :)

Подскажите, где взять полную документацию по api для Python?
По указанным в статье ссылкам информации практически нет.

Открыл ИИС, оказалось, API не показывает операции по нему.
Так что теперь у меня автоматизированный учет по брокерскому счету и excel-ка по ИИС. :(((

Можно увидеть ИИС, но нужно проявить немного фантазии.
Сначала нужно получить Id-ы своих счетов

# Список счетов
client.user.user_accounts_get()

Ответ:

{'payload': {'accounts': [{'broker_account_id': '2000270000',
                           'broker_account_type': 'Tinkoff'},
                          {'broker_account_id': '2000490000',
                           'broker_account_type': 'TinkoffIis'}]},
 'status': 'Ok',
 'tracking_id': '04b94f70499c4630'}

Затем, запрашиваем операции по счету с типом TinkoffIis (указываем broker_account_id='2000490000') и получаем то что нужно

d2 = datetime.now(tz=timezone('Europe/Moscow'))
d1 = d2 - timedelta(days=5000)
ops = client.operations.operations_get(_from=d1.isoformat(), to=d2.isoformat(), broker_account_id='2000490000')