# FINAM API

> Современный API для алготрейдинга, создания приложений и интеграции с сервисами. Готовые библиотеки, онлайн-тестирование методов и поддержка 24/7.

- **Доступность сервиса**: 99%
- **Обработка ордера**: 68.7 мс
- **Обновление данных**: 43.4 мс

## Доступ ко всем глобальным рынкам в одном мощном API

- **3500+ Акций**: Гонконг, Шанхай, Шэньчжэнь, Токио
- **3000+ Инструментов**: Американские опционы на акции
- **50+ Товарных фьючерсов**: CME
- **8000+ Акций**: NYSE и NASDAQ

## Кому подойдет технология

Trade API предоставляет все необходимые инструменты для создания мощных торговых роботов, инновационных финансовых приложений 
и интеграции с ведущими торговыми платформами.

- **Разработчикам и финтеху**: Для тех, кто строит бизнес. Если ваша цель - интегрировать инвестиции в свое приложение или создать новый сервис. Мы даем вам: стабильный шлюз, подробную документацию, playground и готовые SDK. 
- **Алготрейдерам и профи**: Если ваша цель – запустить торгового бота, скальперский привод или сложную стратегию, то мы даем: скорость исполнения от 7 мс, прямой доступ к биржевым стаканам (L2) и единый счет для рынков США, Азии и России.
- **Аналитикам и начинающим**: Для тех, кто автоматизирует рутину. Если ваша цель — выгрузить историю торгов для анализа или создать простого бота. Мы даем вам: низкий порог входа. Используйте простые библиотеки, чтобы управлять портфелем без глубоких знаний кода.
- **Управляющим активами**: Для тех, кто масштабирует успех. Если ваша цель — управлять множеством счетов и строить отчетность в реальном времени. Мы даем вам: надежную инфраструктуру, безопасность данных и поддержку для подключения сложных систем.

## Наши клиенты торгуют 

### Рейтинг бумаг по типам

- Акции: 36%
- Опционы: 18%
- Облигации: 18%
- Другое: 26%

### Топ ценных бумаг 

- Сбербанк России ПАО ао: 11%
- БПИФ Ликвидность УК ВИМ: 9%
- ао ПАО Банк ВТБ: 9%

## Выберите инструмент под ваши задачи — Выберите свой протокол

- **Для максимальной
скорости**: ⦁ Создавать высокочастотных торговых роботов (HFT) 
и скальпинговые стратегии ⦁ Интегрировать бэкенд-сервисы, где важна каждая миллисекунда
- **Для быстрого старта**: ⦁ Быстро написать скрипт для автоматизации, тестирования гипотез или анализа данных  ⦁ Интегрировать TradeAPI с веб-интерфейсами и мобильными приложениями
- **Для данных 
в реальном времени**: ⦁ Создавать интерактивные торговые терминалы и real-time дашборды  ⦁ Получать живой поток котировок, биржевых стаканов  ⦁ Мгновенно узнавать об исполнении своих заявок
- **Ускорение по умолчанию**: ⦁ Основа нашего gRPC и REST API ⦁ Позволяет отправлять множество запросов одновременно в одном соединении, значительно снижая задержки
- **Надежность 
в любых сетях**: ⦁ Новейший стандарт, который обеспечивает стабильную работу даже при плохом соединении ⦁ Идеально для мобильных приложений

## Как начать торговать с Trade API

1. **Получите токен**: Регистрация займет 1 минуту
2. **Запустите пример**: Используйте готовый код в нашем GitHub
3. **Интегрируйте**: Подключите SDK (Python, Kotlin, Go и др) или используйте REST/gRPC
4. **Торгуйте!**: Запускайте роботов или создавайте свои сервисы на реальных данных

## Торгуем на проверенных биржах

hkex, cme, tse, moex, xetra, nasdaq, nyse, cboe

## Documentation

- [REST](/docs/rest/llms.txt): Finam Trade-API
- [Trade API](/docs/grpc/llms.txt): Токены и аутентификация в Finam Trade API
В системе используется двухэтапная схема аутентификации 
Получение ключа: Создайте секретный ключ в разделе «Токены» на портале Finam Trade API.
Первичная авторизация: Вызовите метод Auth из сервиса AuthService, передав секретный ключ в тело запроса, чтобы получить первый JWT.
Использование в запросах: Вставляйте полученный JWT в метаданные каждого запроса к OrdersService или MarketDataService и другие сервисы, в формате Authorization: Bearer .
Автоматическое обновление (Рекомендуется):
Установите соединение с методом SubscribeJwtRenewal, сразу передав в него свой секретный ключ.
Сервер будет поддерживать открытый стрим и автоматически присылать новый JWT незадолго до истечения старого.
Ваше приложение должно подхватывать новый токен из стрима и использовать его для последующих запросов, что обеспечит бесперебойную работу без пауз
Или вызовите повторно метод Auth из сервиса AuthService
- [Finam Trade API (WebSocket)](/docs/async-api/llms.txt): WebSocket подписки на котировки/сделки/стакан/свечи/заявки.
Клиент шлёт запросы (subscribe/unsubscribe/unsubscribe_all) в виде JSON, сервер отвечает envelope-ами:
- DATA — payload с данными для разных подписок (варианты для BARS, ORDER_BOOK, QUOTES, TRADES, ORDERS)
- ERROR — ошибка (валидация, аутентификация,недоступность upstream и т.п.)
- EVENT — служебные события (HANDSHAKE_SUCCESS, CONNECTION_CLOSED и т.п.)

- [Blog](/blog/llms.txt)
- [Changelog](/chanchelog/llms.txt)
- [Tokens](/tokens.md): API token management