Polymarket - запрос данных Polymarket: рынки, цены, стаканы и история

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

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

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

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

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

Polymarket - данные рынка прогнозов

Запрашивайте данные рынка прогнозов из Polymarket через их публичные REST API. Все endpoint’ы read-only и не требуют аутентификации.

Полная справка по endpoint’ам с curl-примерами находится в references/api-endpoints.md.

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

• Пользователь спрашивает о prediction markets, betting odds или вероятностях событий
• Пользователь хочет понять, каковы шансы наступления события
• Пользователь спрашивает конкретно про Polymarket
• Пользователь хочет цены рынков, данные стакана или историю цен
• Пользователь хочет отслеживать движение prediction markets

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

• Events содержат один или несколько Markets в отношении 1:many
• Markets - бинарные исходы с ценами Yes/No в диапазоне от 0.00 до 1.00
• Цены и есть вероятности: цена 0.65 означает, что рынок оценивает вероятность в 65%
• Поле outcomePrices - JSON-строка с массивом вроде ["0.80", "0.20"]
• Поле clobTokenIds - JSON-строка с массивом из двух token ID [Yes, No] для запросов цен и стакана
• Поле conditionId - hex-строка для запросов истории цен
• Объем указывается в USDC

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

1. Gamma API на gamma-api.polymarket.com - discovery, поиск и обзор рынков
2. CLOB API на clob.polymarket.com - цены в реальном времени, стаканы и история
3. Data API на data-api.polymarket.com - сделки и open interest

Типовой workflow

Когда пользователь спрашивает о вероятностях prediction market:

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

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

Для читаемости форматируйте цены как проценты:

• ["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']), чтобы получить настоящий массив.

Rate limits

Ограничения щедрые, для обычного использования упереться в них сложно:

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

Ограничения

• Навык только read-only и не поддерживает размещение сделок
• Для торговли нужна аутентификация через криптокошелек и подписи EIP-712
• У некоторых новых рынков может отсутствовать история цен
• Географические ограничения влияют на торговлю, но read-only данные доступны глобально