Перейти к содержанию

Песочница TINKOFF INVEST API

Методы по работе со счетами песочницы.

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

  • OpenSandboxAccount — метод создания специального счёта песочницы;
  • SandboxPayIn — пополнение баланса счёта песочницы;
  • CloseSandboxAccount — метод закрытия счёта в песочнице.

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

Для получения списка своих счетов в песочнице используется метод getAccount.

Важно! Все счета в песочнице являются виртуальными и могут быть удалены в любой момент времени. Если созданный ранее счёт не найден, создайте, пожалуйста, новый.

Методы получения состояния портфеля в песочнице

Методы получения операций и портфеля аналогичны таким же методам основных сервисов:

Обратите, что для методов песочницы не рассчитываются некоторые статистические параметры портфеля, такие как относительная и абсолютные доходности и т.п.

Методы по работе с торговыми поручениями в песочнице

Параметры методов выставления, отмены, получения статуса торгового поручения в песочнице аналогичны методам основной работы с TINKOFF INVEST API.

  • postSandboxOrder — выставление торгового поручения;
  • getSandboxOrderState — получение статуса торгового поручения;
  • cancelSandboxOrder — отмена выставленного торгового поручения;
  • getSandboxOrders — получение списка торговых поручений по счёту;

Алгоритм исполнения торговых поручений в песочнице

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

  1. При выставлении торгового поручения со счёта песочницы сразу же списываются активы или начисляются валютные средства. Операции при этом появятся только при исполнении торгового поручения.
  2. Сервис получает от торговых площадок информацию о последних сделках по всем инструментам.
  3. Если для инструмента есть активные торговые поручения в песочнице, то сервис определяет сделки, цена для которых пройдена.
    Например, существует заявка на покупку акции по цене 100 руб.; если цена инструмента в последней сделке с биржи равна 100 или менее рублей, то заявка исполняется по цене, которая была в ней указана (т.е. по 100 руб).
    Если же заявка на продажу, то она исполнится, когда цена последней сделки будет 100 или более рублей.
  4. Все неисполненные торговые поручения в песочнице удаляются после окончания торговой сессии. Списанные активы возвращаются на счёт.