Что умеет API finlight

finlight — это API финансовых новостей. Он берёт непрерывный, хаотичный поток мировых рыночных новостей и превращает его в чистые, структурированные, обогащённые ИИ данные, которые можно запрашивать, получать потоком или принимать в виде push-доставки. Вместо того чтобы самостоятельно парсить сайты и разбирать HTML, вы получаете единый и согласованный интерфейс со встроенной тональностью, разметкой компаний и богатыми возможностями фильтрации.

Эта страница — карта. Она охватывает то, что даёт вам finlight, четыре способа получения данных и куда двигаться дальше. Если вы просто хотите сделать первый вызов, начните с руководства по быстрому старту.

Что содержит каждая статья

Каждая статья, которую возвращает finlight, структурирована и обогащена — это не просто заголовок и ссылка. Вы получаете:

• Основные поля: заголовок, краткое содержание, полный текст (необязательно), источник, дату публикации, язык и изображения.
• Тональность: каждая статья оценивается как positive, neutral или negative со значением уверенности, чтобы вы могли количественно измерять тон, а не читать каждую новость.
• Сущности компаний: finlight размечает компании, о которых идёт речь в статье, и сопоставляет их с реальными идентификаторами: тикером, ISIN, OpenFIGI, сектором и отраслью, а также каждой биржей, на которой котируется компания (основные и вторичные листинги, каждый с кодом биржи и страной).
• Классификация: каждая статья размечается странами, которые она затрагивает, и одной или несколькими из 13 категорий.

Это значит, что вы можете отвечать на вопросы вроде «как изменилась тональность по AAPL на этой неделе?» или «покажи мне все новости о регулировании, затрагивающие определённый набор компаний», не выстраивая собственный NLP-конвейер.

Четыре способа получить данные

Одни и те же обогащённые данные доступны через четыре способа доставки. Вы выбираете тот, что подходит под вашу нагрузку.

REST API

Запрос новостей по требованию: отправляете запрос — получаете страницу подходящих статей. Лучше всего подходит для поиска, загрузки исторических данных, дашбордов по расписанию и любых сценариев «запрос/ответ». Продвинутый эндпоинт POST /v2/articles поддерживает полный набор фильтров; есть также эндпоинты для получения отдельной статьи по URL и для перечня доступных источников. См. документацию REST.

WebSocket

Поток статей в реальном времени по мере их публикации, без опроса. Он бывает двух видов: расширенный поток с полным обогащением (тональность и сущности) и лёгкий «сырой» поток для случаев, когда нужно быстро получить лишь основное. Идеально для живых дашбордов, торговых сигналов и мониторинга. См. документацию по WebSocket.

Webhooks

Позвольте finlight отправлять новости на ваш собственный эндпоинт в тот момент, когда они совпадают с вашими фильтрами. Доступны обогащённый и «сырой» варианты, а доставки подписаны, чтобы вы могли их проверять. Лучше всего подходит для событийно-ориентированных конвейеров, оповещений и автоматизаций, которые должны работать без опроса. См. документацию по вебхукам.

MCP-сервер

Подключите finlight к ИИ-ассистенту вроде Claude или ChatGPT через Model Context Protocol и запрашивайте рыночные новости обычным языком. Лучше всего подходит для исследований и разового анализа без написания кода. См. документацию для ИИ-ассистентов.

Как правило: REST — для запросов по требованию, WebSocket — для реального времени, webhooks — для push-автоматизации, а MCP — для исследований с участием ИИ. Отдельное руководство по сравнению скоро выйдет.

Точная фильтрация

finlight построен вокруг того, чтобы вы получали ровно те новости, которые вам нужны. В REST, WebSocket и webhooks вы можете фильтровать по:

• Тикерам: компании вроде AAPL или NVDA.
• Странам: коды стран ISO для фокуса на конкретных рынках.
• Категориям: любая из 13, от markets и economy до crypto, regulation и energy.
• Источникам: включайте или исключайте конкретные издания либо добавляйте дополнительные.
• Диапазонам дат и полноценному языку запросов с булевыми операторами и фильтрами по полям, например (ticker:AAPL OR ticker:NVDA) AND NOT source:reuters.com.

Полный синтаксис запросов см. в документации по продвинутым запросам.

Глобальное, многоязычное покрытие

finlight охватывает новости на 9 языках: английском, упрощённом китайском, хинди, испанском, японском, корейском, португальском, арабском и русском. В сочетании с фильтрами по странам и категориям это позволяет отслеживать рынок на его собственном языке и в его регионе, а не полагаться на покрытие только на английском.

Создано для разработчиков

Вы можете обращаться к finlight через обычный HTTP или использовать официальные SDK:

• Node / TypeScript: npm install finlight-client
• Python: pip install finlight-client

Оба оборачивают REST и WebSocket API, берут на себя аутентификацию и повторные попытки и возвращают типизированные объекты. Аутентификация — это единственный заголовок X-API-KEY в каждом запросе, с ключом, который вы генерируете в панели управления. Минимальный запрос выглядит так:

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tickers": ["AAPL"], "pageSize": 5 }'

Тарифы

У finlight есть тарифы — от бесплатного уровня для тестирования до корпоративного, — различающиеся главным образом объёмом запросов, глубиной истории, доступом в реальном времени и такими функциями, как пользовательские источники. Бесплатный тариф поддерживает только REST и идеален для ознакомления. Актуальные лимиты и возможности каждого уровня см. на finlight.me/pricing.

Начните разработку

• Впервые здесь? Следуйте руководству по быстрому старту, чтобы сделать первый вызов за пять минут.
• Готовы погрузиться глубже? Изучите полную документацию.
• Остались вопросы? Присоединяйтесь к Discord или напишите на info@finlight.me.

Получите бесплатный API-ключ →