Перейти к содержанию

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

Skill metadata​

|
|---|---
Source| Bundled (installed by default)
Path| skills/research/polymarket
Version| 1.0.0
Author| Hermes Agent + Teknium

Reference: full SKILL.md​

info Ниже приведено полное описание навыка, которое Hermes загружает при его активации. Это те инструкции, которые видит агент, когда навык активен.

Polymarket — Prediction Market Data

Запрос данных с рынков предсказаний Polymarket через публичные REST API. Все эндпоинты доступны только для чтения и не требуют аутентификации. См. references/api-endpoints.md для полной документации эндпоинтов с примерами curl.

When to Use​

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

Key Concepts​

  • События (Events) содержат один или несколько Рынков (Markets) (связь 1:many)
  • Рынки (Markets) — это бинарные исходы с ценами Да/Нет от 0.00 до 1.00
  • Цены являются вероятностями: цена 0.65 означает, что рынок оценивает вероятность в 65%
  • outcomePrices — JSON-массив вида ["0.80", "0.20"]
  • clobTokenIds — JSON-массив из двух ID токенов [Да, Нет] для запросов цен и книги ордеров
  • conditionId — hex-строка, используется для запросов истории цен
  • Объём указан в USDC (долларах США)

Three Public APIs​

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

Typical Workflow​

Когда пользователь спрашивает о котировках на рынках предсказаний: 1. Поиск (Search) через эндпоинт public-search Gamma API по запросу пользователя 2. Разбор (Parse) ответа — извлечение событий и вложенных рынков 3. Представление (Present) вопроса рынка, текущих цен в процентах и объёма 4. Детализация (Deep dive) по запросу — использование clobTokenIds для книги ордеров, conditionId для истории

Presenting Results​

Форматируйте цены в процентах для удобства чтения: * outcomePrices ["0.652", "0.348"] → "Yes: 65.2%, No: 34.8%" * Всегда показывайте вопрос рынка и вероятность * Указывайте объём, если он доступен

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

Parsing Double-Encoded Fields​

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 секунд (общие)

Limitations​