Перейти к основному содержимому

Polymarket

Запросы к Polymarket: рынки, цены, книги ордеров, история.

Метаданные навыка​

ИсточникВстроенный (устанавливается по умолчанию)
Путьskills/research/polymarket
Версия1.0.0
АвторVibeOS + Teknium
Платформыlinux, macos, windows

Справочник: полный SKILL.md​

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Агент видит эти инструкции, когда навык активен.

Polymarket — Данные рынков предсказаний

Запрашивайте данные рынков предсказаний с Polymarket через их публичные REST API. Все конечные точки доступны только для чтения и не требуют аутентификации.

Полный справочник конечных точек с примерами curl см. в references/api-endpoints.md.

Когда использовать​

  • Пользователь спрашивает о рынках предсказаний, коэффициентах ставок или вероятностях событий
  • Пользователь хочет узнать «каковы шансы, что X произойдет?»
  • Пользователь спрашивает конкретно о Polymarket
  • Пользователю нужны рыночные цены, данные книги ордеров или история цен
  • Пользователь просит отслеживать движения на рынках предсказаний

Ключевые понятия​

  • События содержат один или несколько Рынков (связь 1:многие)
  • Рынки — это бинарные исходы с ценами Да/Нет от 0.00 до 1.00
  • Цены ЯВЛЯЮТСЯ вероятностями: цена 0.65 означает, что рынок оценивает вероятность в 65%
  • Поле outcomePrices: массив в формате JSON, например ["0.80", "0.20"]
  • Поле clobTokenIds: массив в формате JSON из двух идентификаторов токенов [Да, Нет] для запросов цен/книг ордеров
  • Поле conditionId: шестнадцатеричная строка, используемая для запросов истории цен
  • Объем указан в USDC (доллары США)

Три публичных API​

  1. Gamma API по адресу gamma-api.polymarket.com — Поиск, обнаружение, просмотр
  2. CLOB API по адресу clob.polymarket.com — Цены в реальном времени, книги ордеров, история
  3. Data API по адресу data-api.polymarket.com — Сделки, открытый интерес

Типичный рабочий процесс​

Когда пользователь спрашивает о коэффициентах на рынке предсказаний:

  1. Поиск через конечную точку public-search Gamma API с его запросом
  2. Разбор ответа — извлечение событий и вложенных рынков
  3. Представление вопроса рынка, текущих цен в процентах и объема
  4. Углубленный анализ по запросу — использование clobTokenIds для книги ордеров, conditionId для истории

Представление результатов​

Форматируйте цены в процентах для удобства чтения:

  • outcomePrices ["0.652", "0.348"] становится «Да: 65.2%, Нет: 34.8%»
  • Всегда показывайте вопрос рынка и вероятность
  • Указывайте объем, если он доступен

Пример: «Произойдет ли X?» — 65.2% Да (объем $1.2M)

Разбор дважды закодированных полей​

Gamma API возвращает outcomePrices, outcomes и clobTokenIds в виде строк JSON внутри ответов JSON (двойное кодирование). При обработке на Python разбирайте их с помощью json.loads(market['outcomePrices']), чтобы получить фактический массив.

Ограничения скорости​

Щедрые — маловероятно, что вы превысите их при обычном использовании:

  • Gamma: 4 000 запросов за 10 секунд (общее)
  • CLOB: 9 000 запросов за 10 секунд (общее)
  • Data: 1 000 запросов за 10 секунд (общее)

Ограничения​

  • Этот навык доступен только для чтения — он не поддерживает совершение сделок
  • Торговля требует криптографической аутентификации на основе кошелька (подписи EIP-712)
  • У некоторых новых рынков может быть пустая история цен
  • Географические ограничения применяются к торговле, но данные только для чтения доступны глобально