yatis 0.2.1

Yet Another T-bank Investment Sdk
Documentation
## Цены облигаций и фьючерсов

Цены облигаций и фьючерсов в T-Invest API предоставляются в пунктах. Методики расчёта стоимости
лота в валюте различаются в зависимости от типа биржевого инструмента.

### Перевод цены облигации в валюту

Пункты цены для котировок облигаций представляют собой проценты номинала облигации. Для пересчёта пунктов
в валюту можно воспользоваться формулой: `price / 100 * nominal`.

* **price** — текущая котировка ценной бумаги;

* **nominal** — номинал облигации.

>**Важно**<br>
>Если валюта номинала отличается от валюты расчётов, при переводе используется курс валюты номинала к валюте расчётов, установленный ЦБ.

<a name="futures"></a>

### Перевод цены фьючерса в валюту

Стоимость фьючерсов также предоставляется в пунктах. Для пересчёта можно воспользоваться формулой:
`price / min_price_increment * min_price_increment_amount`.

* **price** — текущая котировка ценной бумаги;

* **min_price_increment** — шаг цены;

* **min_price_increment_amount** — стоимость шага цены.

>**Важно**<br>
>Во многих методах T-Invest API ответ по операциям с фьючерсами может возвращаться в валюте цены.
Значения в валюте пересчитываются исходя из текущей стоимости шага цены, которая меняется.
Таким образом стоимость в пунктах остаётся неизменной, а переоценка в валюте расчётов зависит от установленных биржей параметров на текущий момент.<br><br>
>Также при работе с фьючерсами важно учитывать размер гарантийного обеспечения. Узнать эти параметры фьючерсов
можно через метод [getFuturesMargin]/investAPI/instruments#getfuturesmargin. 

[Подробнее про срочный рынок](https://www.tbank.ru/invest/help/brokerage/account/forts/)

## Параметры методов, в которых используются пункты цены

|Сервис|Метод|Параметры|Share/ETF/Currency|Bond/Futures|
|:----|:----|:----|:----|:----|
|Instruments|Все методы|Все параметры|В валюте расчётов|В валюте расчётов|
|MarketData|Все методы|Все параметры|В валюте расчётов|В пунктах цены|
|Operations|Все методы|Все параметры|В валюте расчётов|В валюте расчётов|
|Orders|PostOrder|Все параметры|В валюте расчётов|В валюте расчётов или в пунктах цены в зависимости от [типа цены]https://russianinvestments.github.io/investAPI/orders/#pricetype|
|Orders|OrderStateStream|`orderPrice` и `price` сделки|В валюте расчётов|В пунктах цены|
|Orders|OrderStateStream|Остальные параметры|В валюте расчётов|В валюте расчётов|
|Orders|TradeStream|`price`|В валюте расчётов|В пунктах цены|
|StopOrders|PostStopOrder|Входные параметры|В валюте расчётов|В валюте расчётов|
|Operations|Все методы|Все параметры|В валюте расчётов|В валюте расчётов|
|Sandbox|PostSandboxOrder|Входные параметры|В валюте расчётов|В валюте расчётов|