API Kalshi: публичные данные, потоки или операции счёта

Автор: PredictionToolkit · Опубликовано 2026-11-03 · Обновлено 2026-11-03

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

Выберите API событийных контрактов

Для контрактов на события используйте документацию Kalshi Predictions. API Perps отдельно описывают бессрочные фьючерсы. В руководстве по публичному REST показано получение серий, событий, рынков и книг заявок без аутентификации. Это доступ к публичным данным; он не даёт оснований считать, что данные счёта или отправка заявок доступны анонимно.

Сопоставьте учётные данные с интерфейсом

• Публичные REST-запросы рынков: используйте документированные эндпоинты поиска и снимков книги.
• WebSocket: авторизуйте установление соединения даже при подписке на публичные рыночные каналы; эти каналы не добавляют отдельной проверки полномочий на уровне канала.
• Операции счёта и торговля: используйте необходимые подписанные запросы и разрешённые возможности аккаунта.

Актуальное руководство по ключам поддерживает Ed25519 и RSA-PSS. Выбирайте тип, поддерживаемый вашей версией клиента, а не копируйте старый пример только с RSA. Идентификатор ключа указывает зарегистрированный ключ; приватный ключ подписывает запросы. Не помещайте приватный ключ в браузерные сборки, публичные репозитории и журналы; точные метод и путь для подписи сверяйте с официальным руководством.

Разделяйте demo и production

Рекомендованные REST-хосты: external-api.kalshi.com для production и external-api.demo.kalshi.co для demo; базовый путь API — /trade-api/v2. Ключи этих сред невзаимозаменяемы. Разработку операций счёта начинайте в demo и явно проверяйте среду до включения production-действия. Результат demo не подтверждает реальную ликвидность или исполнение.

Прямой клиент, локальная обёртка или размещённый сервис?

При прямой интеграции вы работаете с идентификаторами и спецификациями API самой Kalshi. PMXT предоставляет общий интерфейс SDK для возможностей, реализованных каждой площадкой. Выберите режим работы до настройки учётных данных: самостоятельно размещённый pmxt-core работает локально, подключается к площадке и при необходимости использует её учётные данные, а облачный PMXT — собственный ключ и инфраструктуру. Документированный облачный путь операций записи использует кастодиальную модель PreFundedEscrow. Проверьте хранение средств и доступные методы именно для выбранного режима: одинаковые названия функций SDK не означают одинаковое поведение.

Сначала постройте ограниченный поток данных

• Определите серию, событие и тикер рынка и сохраните точные правила контракта. Название события не является идентификатором исполнимого рынка.
• Запросите небольшую выборку рынков и книг; до построения графика или сравнения сохраните время, единицы цен и доступный объём.
• Для потоков обрабатывайте потерю соединения и восстановление состояния: открытое соединение само по себе не подтверждает свежие пригодные данные.
• Проверьте текущие лимиты аккаунта и стоимость эндпоинтов; при HTTP 429 увеличивайте паузу между попытками.
• Проверяйте полномочия счёта и смысл параметров ордера отдельно от успешного публичного запроса.

Считайте пропускную способность отдельно от денег

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

Рекомендации по доступу в этом руководстве основаны на изучении документации по указанным ссылкам. Проверка не включала создание ключа, подключение счёта или отправку заявки. Связанные карточки описывают доступные интерфейсы интеграции; перед реализацией запроса уточните параметры endpoint и разрешения в официальных материалах.