Быстрый старт
Базовый адрес всех запросов:
https://api.finnhub.ru/v1
Получите текущую котировку одним запросом:
curl -H "X-Api-Key: $TOKEN" \ "https://api.finnhub.ru/v1/quote?symbol=SBER"
Ответ:
{
"symbol": "SBER",
"price": 318.42,
"change": -1.86,
"change_percent": -0.58,
"volume": 41827300,
"updated_at": "2026-08-01T09:14:22Z"
}
Аутентификация
Токен передаётся в заголовке X-Api-Key. Ключи выпускаются в личном кабинете и действуют до отзыва.
X-Api-Key: fh_live_a41c9d8e72b6
Не размещайте ключ в клиентском коде. Для браузерных приложений
используйте серверный прокси — ключ не должен попадать в публичный бандл.
Эндпоинты
GET/v1/quote
Текущая котировка инструмента. Параметры: symbol (обязательный).
GET/v1/candles
Исторические свечи OHLCV. Параметры: symbol, resolution
(1, 5, 15, 60, D, W), from, to — unix-время.
GET/v1/company/profile
Профиль эмитента: отрасль, капитализация, ISIN, дата листинга.
GET/v1/news
Лента корпоративных новостей. Фильтры: symbol, from,
to, category.
GET/v1/financials/reported
Отчётность по РСБУ/МСФО в разрезе кварталов и лет.
Пример: свечи за неделю
curl -H "X-Api-Key: $TOKEN" \ "https://api.finnhub.ru/v1/candles?symbol=GAZP&resolution=60&from=1785500000&to=1786104800"
Коды ошибок
| Код | Значение | Что делать |
|---|---|---|
400 | Некорректные параметры | Проверьте обязательные поля запроса |
401 | Ключ отсутствует или отозван | Выпустите новый ключ в кабинете |
404 | Инструмент не найден | Сверьтесь со справочником тикеров |
429 | Превышен лимит | Соблюдайте паузу из заголовка Retry-After |
503 | Источник временно недоступен | Повтор с экспоненциальной задержкой |
Ограничения
| План | Запросов в минуту | История | WebSocket |
|---|---|---|---|
| Free | 60 | 1 год | — |
| Basic | 300 | 5 лет | 10 подписок |
| Pro | 1200 | полная | 100 подписок |
Текущий расход возвращается в заголовках X-RateLimit-Remaining
и X-RateLimit-Reset.
Пакетные выгрузки истории выполняйте в ночные часы —
дневные лимиты рассчитаны на интерактивную работу.
Библиотеки
Python
import requests
r = requests.get(
"https://api.finnhub.ru/v1/quote",
params={"symbol": "LKOH"},
headers={"X-Api-Key": TOKEN},
timeout=10,
)
print(r.json()["price"])
JavaScript
const res = await fetch(
"https://api.finnhub.ru/v1/quote?symbol=LKOH",
{ headers: { "X-Api-Key": token } }
);
const { price } = await res.json();
Changelog
| Дата | Изменение |
|---|---|
| 2026-07-28 | Добавлено поле volume в /v1/quote |
| 2026-07-11 | Расширена история свечей для плана Basic до 5 лет |
| 2026-06-30 | Новый эндпоинт /v1/financials/reported |
| 2026-06-02 | Снижена задержка котировок MOEX до 15 секунд |
| 2026-05-19 | Заголовки лимитов приведены к стандарту RateLimit |