Что такое API: как оно работает и зачем нужно

Открываете приложение брокера и видите, как курс акций Сбербанка меняется у вас на глазах? В этот момент между серверами летят тысячи технических запросов и ответов — и всю эту невидимую работу берёт на себя API.

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

Упрощённая схема обмена данными между приложением и сервером через API.

Кратко

• API — это набор правил, по которым одна программа запрашивает данные или действие у другой.
• Через API работают биржевые терминалы, мобильные банки, крипто-кошельки и большинство финансовых сервисов.
• Московская биржа публикует собственный публичный API (ISS) — на нём построены многие сторонние сервисы и скринеры.
• Доступ к API обычно защищён ключом или токеном, который нужно хранить так же бережно, как пароль.
• Инвестору важнее не разбираться в коде, а понимать, откуда приложение берёт данные и можно ли им доверять.

Что такое API простыми словами

API (Application Programming Interface, «интерфейс программирования приложений») — это набор правил, по которым одна программа обращается к другой за данными или действием, не заглядывая в её внутреннее устройство.

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

Как биржа передаёт данные о торгах через API?

Московская биржа передаёт данные о торгах через собственный публичный API информационно-статистического сервера ISS (iss.moex.com) — к нему обращаются брокерские приложения, аналитические сервисы и скринеры, включая наш скринер акций и облигаций.

Когда вы открываете профиль бумаги, например страницу акций Сбербанка, в большинстве случаев данные о цене и объёме торгов в итоге восходят именно к такому биржевому API, даже если сервис получает их не напрямую, а через посредника.

Как устроен один запрос: клиент, сервер и ответ

Типичный сценарий выглядит так: приложение-клиент отправляет запрос на определённый адрес сервера с указанием, какие данные ему нужны, а сервер обрабатывает запрос и возвращает ответ — обычно в формате JSON, удобном для машинного чтения.

Например, приложение для заказа такси при построении маршрута обращается к API картографического сервиса и получает в ответ координаты, расстояние и оценочное время в пути. Финансовое приложение действует по тому же принципу, только вместо координат запрашивает котировку или баланс счёта.

1. 1Приложение формирует запрос к адресу API (эндпоинту)
2. 2Сервер проверяет ключ доступа и параметры запроса
3. 3Сервер обращается к своей базе данных или торговой системе
4. 4Сервер возвращает структурированный ответ, обычно в формате JSON
5. 5Приложение обрабатывает ответ и показывает результат пользователю

Какие бывают виды API

Классифицировать API можно по разным признакам, но чаще всего встречаются такие категории:

• Публичные (открытые) API — доступны сторонним разработчикам, часто с ограничением числа запросов.
• Приватные (внутренние) API — используются только внутри одной компании для связи между её собственными сервисами.
• Партнёрские API — открыты для ограниченного круга проверенных партнёров по отдельному соглашению.
• REST API — самый распространённый подход к построению API, основанный на стандартных методах передачи данных через интернет.
• WebSocket API — держит постоянное соединение и присылает обновления по мере их появления, а не по разовому запросу.

Где API работает в повседневной жизни и на бирже

API работает буквально за кулисами большинства цифровых сервисов: вход в приложение через аккаунт Google, оплата картой в интернет-магазине, отображение курса валют в банковском приложении. Отдельно стоит выделить API, через которые работают сервисы на основе больших языковых моделей: разработчики подключают такие модели через API, не создавая нейросеть с нуля.

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

Можно ли отследить перевод USDT или транзакцию Ethereum через API?

Да — сеть Ethereum предоставляет открытый API (JSON-RPC), а большинство блок-эксплореров публикуют собственные API поверх данных сети, где обращается USDT; через них можно проверить статус транзакции, не обращаясь к централизованному посреднику.

Это ключевое отличие от банковского API: доступ к данным блокчейна в целом публичен, а вот доступ к API конкретного банка или брокера, как правило, требует авторизации и ключа доступа. Термин нода (node) в этом контексте означает компьютер, который хранит копию блокчейна и отвечает на запросы через такой API.

REST, WebSocket и FIX: как выбрать формат данных

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

Ключи API, лимиты запросов и безопасность

Доступ к большинству API защищён ключом или токеном — уникальной строкой, подтверждающей право приложения обращаться к сервису. Ключ по сути равносилен паролю: если он попадёт в чужие руки, кто-то сможет обращаться к сервису от вашего имени.

Поэтому ключи не публикуют в открытом коде и не пересылают по незащищённым каналам. Для большинства публичных API также действуют лимиты на число запросов в единицу времени — это защищает инфраструктуру поставщика от перегрузки.

Что говорят регулятор и биржа об открытых API

Банк России развивает концепцию открытых API для финансового рынка — стандарты, по которым банки и финтех-сервисы могут обмениваться данными клиентов с их согласия; конкретные условия и сроки внедрения по разным организациям отличаются, и уточнять их стоит на сайте ЦБ РФ.

Помимо API Московской биржи, данные о раскрытии информации эмитентами публикуются через уполномоченные информационные агентства раскрытия, а расчёты и учёт прав по ценным бумагам обеспечивает НРД (Национальный расчётный депозитарий) — эти источники стоит держать в уме, когда вы оцениваете, насколько сервису можно доверять.

Какие бывают методы запросов и что означают коды ответов

Запрос к API состоит не только из адреса: у него есть метод — указание, что именно нужно сделать с данными. В самых распространённых веб-API их четыре: GET — «отдай данные» (запросить котировку, историю сделок), POST — «прими и создай» (выставить заявку, зарегистрировать пользователя), PUT или PATCH — «измени существующее», DELETE — «удали». Для инвестора практический смысл прост: методы чтения безопасны, а всё остальное меняет состояние на стороне сервиса — именно поэтому ключ доступа лучше ограничивать правами только на чтение.

На каждый запрос сервер отвечает трёхзначным кодом состояния. По нему сразу понятно, где сбой — в приложении, в правах доступа или на стороне сервиса:

Коды ответов API и их практический смысл

Отдельно стоит запомнить код 429: он означает, что вы упёрлись в лимит запросов, а не что сервис сломался. Приложения, которые слишком часто дёргают биржевой API, получают именно его — и в интерфейсе это выглядит как «данные не загрузились».

Почему цифры в приложении и на бирже могут отличаться

Короткий ответ: потому что между сделкой на бирже и цифрой на вашем экране стоит цепочка из нескольких API, и на каждом звене возможна задержка. Расхождение на несколько копеек или минут — это чаще всего не ошибка брокера, а особенность передачи данных.

• Задержка трансляции. Часть источников отдаёт котировки не в реальном времени, а с задержкой — такие данные годятся для наблюдения, но не для оценки цены исполнения заявки.
• Кэширование. Сервис может показывать сохранённый ответ API, чтобы не превышать лимиты запросов; на неликвидных бумагах это заметнее всего.
• Разные режимы торгов. Основная сессия, вечерняя и утренняя дают разные последние цены, и агрегаторы не всегда указывают, из какого режима взята цифра.
• Разные источники. Цена у брокера, на сайте биржи и в стороннем приложении может браться из разных API — сверять стоит с первоисточником.

Первоисточник по российским бумагам — Московская биржа, по ставкам и курсам валют — Банк России, по корпоративным событиям — официальные раскрытия эмитентов. Как устроен сам механизм торгов, из которого рождаются эти цифры, разобрано в материале «Как устроена Московская биржа», а отслеживать нужные бумаги удобно через скринер акций на long-short.ru.

Нужно ли инвестору разбираться в коде, чтобы пользоваться API?

Нет — как конечному пользователю вам не нужно писать код: с API работают разработчики приложений, которыми вы уже пользуетесь, а вы получаете готовый интерфейс — мобильное приложение, сайт или наш календарь дивидендов.

Можно ли получить биржевые данные MOEX бесплатно через API?

Часть данных биржевого API ISS доступна в открытом режиме, но объём, глубина истории и лимиты запросов регулируются условиями сервиса — актуальные правила стоит смотреть в официальной документации Московской биржи.

Безопасно ли подключать брокерское приложение через API-ключ?

Это безопасно, если ключ выдан официальным сервисом, ограничен по правам доступа (например, только чтение без права вывода средств) и хранится в защищённом виде, а не в общедоступном месте.

Чем API отличается от обычного сайта?

Сайт создан для чтения человеком — с оформлением, картинками и навигацией, а API возвращает данные в машиночитаемом формате для других программ, без визуального интерфейса.

Что делать дальше

Понимание API не требует от инвестора программирования — достаточно знать, что за удобным интерфейсом стоит обмен данными, и уметь проверить, из какого источника они берутся.

• Посмотрите, какие данные использует ваш брокер или банк, и сверьте их с официальными источниками — MOEX, ЦБ РФ, раскрытия эмитентов.
• Добавьте интересующие бумаги в свой список наблюдения, чтобы отслеживать их в одном месте.
• Проверьте ближайшие выплаты в календаре дивидендов и долговые инструменты — в календаре облигаций.
• Если интересна доходность на длинном горизонте, посчитайте её в калькуляторе сложного процента.

Материал носит информационный характер и не является индивидуальной инвестиционной рекомендацией.