polyorderbooks

PolyOrderbooks MCP Server

Историческая глубина стакана Polymarket для Claude, Cursor и любого другого MCP‑клиента — полные уровнировки L2 покупок и продажи с шагом в 1 секунду и с указанием разрешившихся исходов.

Related MCP server: polymarket-mcp-server

Установка

Ничего устанавливать не нужно: добавьте сервер в конфигурацию MCP‑клиента — он запустится через npx.

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "polyorderbooks": {
      "command": "npx",
      "args": ["-y", "@polyorderbooks/mcp-server"],
      "env": { "POLYORDERBOOKS_API_KEY": "pob_..." }
    }
  }
}

Cursor — .cursor/mcp.json, та же структура.

Получите бесплатный ключ на polyorderbooks.com/signup. Бесплатный тариф обслуживает запросы с шагом в 1 секунду, как и платные планы, но за более короткий период истории.

Инструменты

Каталог устроен так: серии → события → рынки. Запрашивайте вид рынка через search_series, группу, разрешающуюся вместе, через search_events, а конкретный рынок — через search_markets.

Что стоит знать перед интерпретацией данных

Стаканы становятся односторонними по мере разрешения рынков. В последнюю минуту 5‑минутного рынка 76 % снимков имеют пустую сторону покупки или продажи — никто не предлагает проигрышный исход. Это реальное поведение рынка, а не пропущенные данные, и оно разрушает анализ, предполагающий двусторонний стакан.

Длительность контракта меняет всё. У 4‑часового контракта стакан односторонний в 0,5 % времени, а у 5‑минутного — в 17 %. Выводы, сделанные по одному типу, не переносятся на другой.

Ответы разрастаются быстро. Час с шагом в 1 секунду — это 3 600 интервалов на токен, а у рынка два токена. Сужайте окно или берите более крупный шаг, а для продолжения пользуйтесь возвращаемым next_cursor.

Примеры запросов

Найдите BTC‑рынки с 5‑минутными контрактами, которые разрешились вчера, и покажите, как менялась глубина стакана в последние две минуты до соглашения.

Для этого рынка: сколько бы кончала покупка 100 акций по фактическому стакану за пять секунд до закрытия, по сравнению со средней ценой в тот момент?

Сравните спред и ликвидность по 5‑минутным, 15‑минутным и 4‑часовым BTC‑контрактам за последний день.

Второй запрос — и есть суть данных L2. Серия цен показывает, где был рынок; только стакан уровня описывает вам, по какой цене можно было продать.

Чем этот отличается от других Polymarket MCP‑серверов

Хороших аналогов существует несколько — kukapay/polymarket-predictions-mcp, demwick/polymarket-agent-mcp, PaulieB14/graph-polymarket-mcp. Они оборачивают собственные Gamma и CLOB API Polymarket и делают это аккуратно.

Различие структурное, а не просто вопрос усилий. Кнопка /book Polymarket отдаёт только текущее состояние, и ничто это состояние не архивирует, поэтому ни один сервер поверх этого API не сможет отдать вчерашние стаканы. Этот сервер обращается к архивной записи, снятой в реальном времени.

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

Устранение неисправностей

«POLYORDERBOOKS_API_KEY does not exist» — сервер сразу завершит работу, если ключ не задан. Пропишите его в блоке env конфигурации вашего MCP‑клиента, а не в окружении командной строки: MCP‑серверы не наследуют ваше окружение.

Ошибка аутентификации — ключи начинаются с pob_. Если вставляли из терминала, проверьте, что в конце нет скрытого символа перевода строки.

Усечённые или медленные ответы — час с шагом 1 секунда даёт 3 600 сегментов на токен, а у рынка их два. Сузьте окно, или используйте resolution: "1m", и продолжайте получать данные через next_cursor.

Пустые стаканы — это ожидаемо вблизи расчёта. Смотрите примечание выше про односторонний стакан.

Открытые данные

897 192 снимка по 805 разрешившимся рынкам и трём длительностям контрактов публикуются под CC BY 4.0 с DOI, без регистрации:

doi.org/10.5281/zenodo.22084114

Это полезно, чтобы самостоятельно познакомиться в этих свойствах, прежде чем полагаться на API.

Разработка

npm install
npm run build
POLYORDERBOOKS_API_KEY=pob_... npm run dev

Сервер общается через stdio. Чтобы опробовать его без MCP‑клиента, передайте на stdin JSON‑RPC: сначала initialize, потом tools/list, затем tools/call.

Ссылки

• polyorderbooks.com — API

• docs.polyorderbooks.com — справка

• Python client — установка pip install polyorderbooks

• Бесплатный BTC‑пример — один рынок, без регистрации

Лицензия

MIT. Проект не связан с Polymarket, не одобрен им и не принадлежит ему.