Public API

Public API — это локальный WebSocket для внешних интеграций: внешнее ПО на вашем компьютере отправляет JSON с полем method, чтобы открывать наборы инструментов, менять линковку, слать уведомления и т.д. Всё работает только на loopback (127.0.0.1); терминал сам не выставляет порт в интернет.

Включение: Приложение → Интеграции → Разрешить внешние интеграции. Пользовательский обзор вкладки: Интеграции.

MCP-сервер (HTTP, ИИ-ассистенты, только чтение) описан отдельно — MCP-сервер.

---

WebSocket API

Точка подключения

• URL: ws://127.0.0.1:49152
• Порт: 49152 (только loopback). Если порт занят при старте (чужой процесс и т.п.), приложение один раз попытается освободить его; при неудаче сервер не поднимется — смотрите лог.

Как включить

1. Приложение → Интеграции.
2. Включите Разрешить внешние интеграции (блок Сервер интеграций).

Формат запроса и ответа

• Запрос: JSON с полем method и при необходимости другими полями (см. Справочник и страницы методов).
• Успех: {"status":"ok"}
• Ошибка: {"status":"error","error_code":<number>,"message":"..."} — текст для человека в message; стабильная обработка в коде по числовому error_code (текущие коды 1000–1008; см. Справочник — ошибочные ответы).

Методы

Метод	Описание
assign	Обновить залинкованную пару по цвету. Не открывает новый график/набор.
open	Открыть набор инструментов (одна биржа, символ). Опционально linking_type как у вотч-листа.
open_aggregated	Сводный набор по одному дисплей-символу на всех биржах; опционально title / extra.title.
notify	Уведомление (заголовок, текст).
ping	Проверка связи.

assign и open: разные задачи — не обязательная цепочка «сначала одно, потом другое».

Полный список полей и enum — в Справочнике.

---

См. также

• MCP-сервер — отдельный протокол и порт для MCP-клиентов.