yatis 0.2.1

Yet Another T-bank Investment Sdk
Documentation
# Возвращаемые типы значений для методов и параметров

## Таблица типов значений

В таблице собрали типы значений для разных инструментов, которые возвращаются в ответе методов и их параметрах.

| Метод                     | Параметр                        | Shares, ETF | Bonds                                | Futures|
|---------------------------|---------------------------------|-------------|--------------------------------------| ---|
| Методы сервиса MarketData |                                 | Валюта      | Пункты                               | Пункты|
| postOrder                 | Лимитная заявка — входящая цена | Валюта      | Валюта                               | Пункты|
|                           | `initial_order_price`             | Валюта      | Валюта + НКД, добавляемый системой   | Валюта|
|                           | `executed_order_price  `          | Валюта      | Валюта                               | Валюта|
|                           | `initial_order_price_pt`          |             |                                      | Пункты|
|                           | `total_order_amount`              | Валюта      | Валюта                               | Валюта|
|                           | `initial_commission`              | Валюта      | Валюта                               | Валюта|
|                           | `executed_commission`             | Валюта      | Валюта                               | Валюта|
|                           | `aci_value`                       | Валюта      | Валюта                               | Валюта|
|                           | `initial_security_price`          | Валюта      | Валюта без НКД                  | Валюта|
| GetOrderState             | `stages.price `                   | Валюта      | Пункты                               | Валюта|
|                           | `initial_order_price`             | Валюта      | Валюта                               | Валюта|
|                           | `executed_order_price`            | Валюта      | Валюта, включая НКД                  | Валюта|
|                           | `total_order_amount`              | Валюта      | Валюта, включая НКД                  | Валюта|
|                           | `average_position_price`          | Валюта      | Пункты                               | Валюта|
|                           | `initialCommission`               | Валюта      | Валюта                               | Валюта|
|                           | `executedCommission`              | Валюта      | Валюта                               | Валюта|
|                           | `initial_security_price`          | Валюта      | Пункты                               | Валюта|
| postStopOrder             | `price`, `stop_price`               | Валюта      | Пункты                               | Пункты|
| getStopOrders             | `price`, `stop_price`               | Валюта      | Валюта                               | Пункты|
| getOperationByCurcor      | `payment`                         | Валюта      | Валюта                               | Валюта|
|                           | `price`                           | Валюта      | Валюта                               | Пункты|
|                           | `trades.price `                   | Валюта      | Валюта                               | Пункты|
| getOperation              | `payment`                         | Валюта      | Валюта                               | Валюта|
|                           | `price`                           | Валюта      | Валюта                               | Пункты|
|                           | `trades.price `                   | Валюта      | Валюта                               | Валюта|


## Формулы расчёта реальной стоимости инструментов в валюте

* **price** — текущая котировка ценной бумаги;
* **nominal** — номинал облигации;
* **min_price_increment** — шаг цены;
* **min_price_increment_amount** — стоимость шага цены;
* **lot** — лотность инструмента.


### Акции

Формула расчёта: **price** * **lot**.

### Облигации

Пункты цены для котировок облигаций представляют собой проценты номинала облигации. 

Формула для пересчёта пунктов в валюту: **price** / 100 * **nominal**.

### Валюта

Формула расчёта: **price** * **lot** / **nominal**.

> При торговле валютой учитывайте, что у некоторых валют, например, Иены, Армянского драма и Тенге `nominal` = 100.

### Фьючерсы

Стоимость фьючерсов предоставляется в пунктах.

Формула для пересчёта: **price** / **min_price_increment** * **min_price_increment_amount**.