CLI

Чтобы быстро начать работу с API, мы добавили возможность взаимодействия с SDK через CLI — Command Line Interface.

Начало работы

Чтобы работать с CLI, установите Java (JRE) не ниже 11 версии. Скачать JAR-файл для запуска CLI можно из maven repository.
Для запуска укажите файл настроек с помощью флага -p. Подробнее о содержании файла.
Чтобы запустить CLI, укажите токен в файле invest.properties. Остальные настройки оставьте по умолчанию:
```
token=<INVEST_API_TOKEN>
```

Получить акцию по тикеру

Найдем акции с тикером VTBR:

java -jar java-sdk-basic-example-1.31.jar -p invest.properties client instruments -t VTBR shares

В консоли увидим, что результат записан в файл output.json. Нас интересует уникальный идентификатор инструмента — UID. Он позволит однозначно указывать инструмент в запросах для корректной работы с API. Находим строчку с uid в файле output.json:
```
{
"instruments": [
 {
   "figi": "BBG004730ZJ9",
   "ticker": "VTBR",
   ...
   "name": "Банк ВТБ",
   ...
   "tradingStatus": "SECURITY_TRADING_STATUS_DEALER_NORMAL_TRADING",
   "buyAvailableFlag": true,
   "sellAvailableFlag": true,
   ...
   "apiTradeAvailableFlag": true,
   "uid": "8e2b0325-0292-4654-8a18-4f63ed3b0e09",
   ...
 }
]
}
```
По описанным выше полям видим, что это действительно тот инструмент, который мы искали.

Иногда по одному тикеру можно получить несколько инструментов. Такое бывает, когда с бумагой происходят какие-либо корпоративные действия — например, изменение лотности, и вам возвращаются старый и новый инструменты.

В таких случаях проверяйте актуальность инструмента.

Получить исторические котировки по инструменту

У нас есть UID инструмента — теперь мы можем полноценно работать с CLI.

Получим свечные данные по акции Банк ВТБ с 1 января 2019 года, используя команду:
```
java -jar java-sdk-basic-example-1.31.jar -p invest.properties history-bars -i 8e2b0325-0292-4654-8a18-4f63ed3b0e09
--candle-interval CANDLE_INTERVAL_1_MIN --start-date 2019-01-01
```
Можно указать другой интервал свечи. Чтобы увидеть все доступные интервалы, вызовите CLI с опцией -h (--help):
```
java -jar java-sdk-basic-example-1.31.jar -p invest.properties history-bars -h
```
В текущей директории у нас появится файл 8e2b0325-0292-4654-8a18-4f63ed3b0e09_candle_interval_1_min.csv — это свечные данные. Содержание файла:
```
start_time,open,high,low,close,volume
2019-01-03T07:00:00Z,0.03391,0.03391,0.033705,0.03376,12764
2019-01-03T07:01:00Z,0.03379,0.033845,0.033785,0.033825,2629
...
```
После этого вы можете использовать эти данные в своих задачах по анализу рынка.