# REST

> Токены и аутентификация в Finam Trade API (REST)

1. Получение ключа:
Сгенерируйте постоянный секретный ключ в разделе «Токены» вашего профиля.

2. Получение JWT:
Отправьте POST-запрос к методу `Auth`, передав секретный ключ в теле запроса. В ответ сервер вернет временный JWT.

3. Использование в заголовках:
Добавляйте заголовок во все последующие HTTP-запросы: `Authorization: Bearer <ваш_jwt_токен>`. Без этого заголовка сервер отклонит запрос.

4. Управление жизненным циклом:
В REST отсутствует механизм автоматической подписки на обновления. Для получения свежего токена вам необходимо повторно вызывать метод `Auth` вручную до того, как текущий JWT станет недействительным. Разработчик должен самостоятельно реализовать логику контроля времени жизни токена в коде.

**Version:** 2.14.0
**Protocol:** rest
**Spec version:** 2.0

## Servers

| URL | Protocol | Description |
| --- | --- | --- |
| https://api.finam.ru |  |  |

## Authentication

**Authorization** (apiKey)
JWT токен авторизации
In: header

## AuthService

- [Auth](/docs/rest/authservice_auth.md): Получение JWT токена из API токена
- [TokenDetails](/docs/rest/authservice_tokendetails.md): Получение информации о токене сессии

## AccountsService

- [GetAccount](/docs/rest/accountsservice_getaccount.md): Получение информации по конкретному аккаунту
- [Trades](/docs/rest/accountsservice_trades.md): Получение истории по сделкам аккаунта
- [Transactions](/docs/rest/accountsservice_transactions.md): Получение списка транзакций аккаунта

## OrdersService

- [GetOrders](/docs/rest/ordersservice_getorders.md): Получение списка заявок для аккаунта
- [PlaceOrder](/docs/rest/ordersservice_placeorder.md): Выставление биржевой заявки
- [GetOrder](/docs/rest/ordersservice_getorder.md): Получение информации о конкретном ордере
- [CancelOrder](/docs/rest/ordersservice_cancelorder.md): Отмена биржевой заявки
- [PlaceSLTPOrder](/docs/rest/ordersservice_placesltporder.md): Выставление SL/TP заявки

## MarketDataService

- [Bars](/docs/rest/marketdataservice_bars.md): Получение исторических данных по инструменту (агрегированные свечи)
- [OrderBook](/docs/rest/marketdataservice_orderbook.md): Получение текущего стакана по инструменту
- [LastQuote](/docs/rest/marketdataservice_lastquote.md): Получение последней котировки по инструменту
- [LatestTrades](/docs/rest/marketdataservice_latesttrades.md): Получение списка последних сделок по инструменту

## AssetsService

- [Assets](/docs/rest/assetsservice_assets.md): Получение списка доступных для торговли инструментов, их описание
- [AllAssets](/docs/rest/assetsservice_allassets.md): Получение списка всех инструментов, в том числе индикативных и архивных, их описание
- [Clock](/docs/rest/assetsservice_clock.md): Получение времени на сервере
- [GetAsset](/docs/rest/assetsservice_getasset.md): Получение информации по конкретному инструменту
- [GetConstituents](/docs/rest/assetsservice_getconstituents.md): Получить состав биржевого индекса по его символу
- [GetAssetParams](/docs/rest/assetsservice_getassetparams.md): Получение торговых параметров по инструменту
- [Schedule](/docs/rest/assetsservice_schedule.md): Получение расписания торгов для инструмента
- [OptionsChain](/docs/rest/assetsservice_optionschain.md): Получение цепочки опционов для базового актива
- [Exchanges](/docs/rest/assetsservice_exchanges.md): Получение списка доступных бирж, названия и mic коды

## UsageMetricsService

- [GetUsageMetrics](/docs/rest/usagemetricsservice_getusagemetrics.md): Получение текущих метрик использования для пользователя

## ReportsService

- [CreateAccountReport](/docs/rest/reportsservice_createaccountreport.md): Запустить генерацию отчета по счету за период
- [GetAccountReportInfo](/docs/rest/reportsservice_getaccountreportinfo.md): Получение информации о результате генерации отчета по счету

## See also

- [Tokens](/tokens.md): API token management