Local API, SDK и MCP
Читайте рыночные данные и счёт из запущенного Spectre Terminal и торгуйте через него из своих программ.
Local API — это интерфейс HTTP и WebSocket, который запущенный Spectre
Terminal отдаёт на 127.0.0.1. Программа на той же машине читает то, что
показывает окно терминала, и отправляет те же команды, включая заявки.
С чего начать
- Начало работы: включить API, получить токен, сделать первый запрос.
- Аутентификация: передать токен и исправить отклонённый запрос.
- Руководство под вашу задачу: рыночные данные, счёт, торговля, раскладка, настройки или живые стримы.
Клиентские пакеты
| Пакет | Для чего | Установка |
|---|---|---|
spectre-terminal | Python 3.10 и новее | pip install spectre-terminal |
@spectre-trade/terminal | TypeScript и JavaScript, Node 22 и новее | npm install @spectre-trade/terminal |
spectre-terminal-mcp | ИИ-агенты, в виде MCP-сервера | pip install spectre-terminal-mcp |
Клиенты сами находят порт и читают токен из окружения. См. Поиск терминала.
Справочник
- HTTP API: каждая операция с параметрами, ответами и ошибками.
- Стрим WebSocket: запросы, кадры и топики.
- Ошибки и лимиты.
- Файлы спецификаций: OpenAPI и AsyncAPI.
Важно помнить
- API по умолчанию выключен. Включите его в Settings App → Общие → Local API.
- Токен — это секрет. Он разрешает всё, что может окно терминала, включая постановку заявок.
- Веб-страницы не могут вызывать API. Запускайте примеры из скрипта или программы.
- Цены и объёмы — десятичные строки. Время — в миллисекундах UTC.
accepted— неfilled. Торговый вызов говорит, что терминал принял команду. Исход читайте из счёта.