PredictionToolkit
Что такое Polymarket Gamma API?
Событие объединяет вопросы, а отдельный бинарный рынок — контракт YES/NO со своими правилами и датами. Разделяйте ID, slug и токены, не считая каждую ссылку события одним исполнимым рынком.
Проверенный /markets/keyset возвращает markets и next_cursor. Пример рынка CTF содержал id, conditionId и массивы outcomes и clobTokenIds, закодированные как JSON. Сохраняйте соответствие индексов меток исходов и токенов. Пример не подтверждает одинаковые поля или доступный стакан CLOB для всех версий протокола.
Кому подходит
- Для поисковых каталогов рынков.
- Для определений и тегов в исследованиях.
- Для связи матчей, команд и спортивных контрактов.
Данные и методы API
- События
Читайте известное событие или страницы ленты.
- Рынки
Получайте бинарные контракты и идентификаторы.
- Теги и фильтры
Сужайте выборку по категории, статусу и поддерживаемым атрибутам.
- Серии
Группируйте повторяющиеся события по теме.
- Спорт
Находите лиги, команды и рынки победителя, форы и тоталов.
- Связь с матчем
Ищите связанные рынки по ID игры без угадывания slug.
- Ответ keyset
Читайте markets и next_cursor и разбирайте закодированные массивы исходов/токенов при наличии.
Задачи интеграции
Собрать каталог
Пройдите страницы открытых событий, сохраните ID и slug и сопоставьте исходы токенам. Статус обновляйте отдельно от цен.
Связать спорт
Определите матч и порядок команд, затем найдите рынки отдельных показателей и дополнительные линии по ID игры.
Разобрать ссылку
Найдите событие или рынок по URL/slug и передайте нужные ID запросам стакана.
Сопоставить стакан CTF
Разделяйте Gamma id и conditionId. Сохраните порядок исходов и токенов и передайте токен CLOB; остановитесь при отсутствии токена или включённого стакана.
Тарифы и полная стоимость
Публичный поиск не требует авторизации. Отдельная подписка для таких чтений в руководстве не указана.
Доступ к API и настройка
- Выберите уровень события, рынка или серии.
- Запросите ограниченную страницу с фильтрами. Передавайте next_cursor как after_cursor, сохраняя те же фильтры и выбор протокола.
- Сохраните ID, slug, теги и соответствия токенов.
- Для исполнимых цен и стаканов используйте CLOB.
Полезные ссылки
Что проверить
- Полный каталог требует пагинации.
- Правила и даты относятся к каждому контракту.
- Порядок хозяев/гостей может меняться после переноса.
- Пример CTF не гарантирует токены и стаканы во всех версиях.
Наблюдения публичного API
Без учётных данных выполнены два ограниченных запроса поиска, затем проверены идентификаторы одного возвращённого CTF-рынка.
Переход по курсору
- Действие
- Запрошен /markets/keyset с closed=false и limit=2, затем его next_cursor передан как after_cursor с теми же фильтрами.
- Результат
- Оба запроса вернули HTTP 200. В каждом было по 2 записи рынка; идентификаторы второй страницы отличались. Оба ответа содержали markets и next_cursor.
- Объём и ограничения
- Прочитаны только эти две страницы. Это не подтверждает полный охват, устойчивость порядка при любых обновлениях или максимальный размер страницы.
Сопоставление исходов и идентификаторов
- Действие
- Для одного рынка декодированы outcomes и clobTokenIds; первый исход с меткой использован в отдельном запросе CLOB.
- Результат
- У выбранной записи были version v1, id рынка и conditionId. Её 2 метки исходов и 2 идентификатора токенов находились в строках с JSON: их нужно декодировать и сопоставлять по индексу.
- Объём и ограничения
- Это CTF-пример. Протокол V2 может использовать идентификаторы позиций; увиденная структура не гарантирует схему всех рынков.
Gamma дал запись для поиска, CLOB подтвердил книгу выбранного исхода, а Data API принял идентификаторы условия и события для агрегатов. Эти идентификаторы обеспечивают разные связи; одного названия события вместо них недостаточно.
Подробный взгляд
Оценки и отзывы
Отзывы пользователей 0
Когда число опубликованных отзывов достигнет 5, основная оценка станет пользовательской.
Конкретный пример поможет следующему посетителю выбрать подходящий инструмент.
Похожие инструменты
Открыть категорию
Читайте цены и глубину токенов исходов, а авторизованные заявки обрабатывайте через отдельный процесс подписи.
- Доступ API
Добавляйте текущий счёт, периоды и состояние игры в интерфейс спортивных рынков.
- Доступ API
Нормализованные рынки, исторические стаканы, аналитика кошельков и возможные соответствия Polymarket и Kalshi.
- Доступ API
Руководства и сценарии работы
Частые вопросы о Polymarket Gamma API
Чем событие отличается от рынка?
Событие группирует вопросы; бинарный рынок представляет один вопрос YES/NO.
Gamma выставляет ордера?
Нет. Это функция CLOB.
Как найти связанные спортивные рынки?
Используйте ID игры и текущий сценарий листинга.
Все списки — обычный массив?
Нет. /markets/keyset вернул объект с markets и next_cursor. Парсер должен соответствовать маршруту.