Hermes agent

Polymarket

Запрос данных Polymarket: рынки, цены, ордербуки, история.

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

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

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

инфо

Ниже приведено полное определение навыка, которое Hermes загружает при его срабатывании. Именно это агент видит как инструкции, когда навык активен.

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

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

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

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

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

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

  • Events (события) содержат один или несколько Markets (рынков) — связь 1:многие
  • Markets — бинарные исходы с ценами Yes/No в диапазоне от 0.00 до 1.00
  • Цены и есть вероятности: цена 0.65 означает, что рынок оценивает шанс в 65%
  • Поле outcomePrices: массив в JSON-кодировке, например ["0.80", "0.20"]
  • Поле clobTokenIds: массив в JSON-кодировке из двух идентификаторов токенов [Yes, No] для запросов цен и ордербука
  • Поле conditionId: hex-строка для запросов истории цен
  • Объём указан в 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"] превращается в «Yes: 65.2%, No: 34.8%»
  • Всегда показывайте вопрос рынка и вероятность
  • Указывайте объём, если он доступен

Пример: "Will X happen?" — 65.2% Yes ($1.2M volume)

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

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)
  • У некоторых новых рынков история цен может быть пустой
  • К торговле применяются географические ограничения, но данные для чтения доступны по всему миру
⌕ ESC