Endpoint Polymarket: правильный host и идентификатор

Автор: PredictionToolkit

Gamma, CLOB и Data API отвечают на разные вопросы. Руководство отделяет документированные запросы от публичных проверок, зафиксированных источниками; сервисами управляют поставщики, а не этот каталог.

Начните с задачи

• Поиск: https://gamma-api.polymarket.com GET /markets/keyset?closed=false&limit=1.
• Стакан: https://clob.polymarket.com GET /book?token_id={outcome token ID}.
• Рейтинг: https://data-api.polymarket.com GET /v2/leaderboard?time_period=day&limit=1. Три публичных запроса не требуют ключей аккаунта.

Разделяйте идентификаторы

Событие группирует рынки. Gamma id идентифицирует метаданные, conditionId — ончейн-условие. В образце CTF outcomes и clobTokenIds были закодированными в JSON массивами с соответствием по индексу. Разберите оба и проверьте равенство длин до выбора токена. Остановитесь при отсутствии полей, несоответствии или непригодности для протокола. Не заменяйте условие или токен числовым Gamma id.

Проверьте переход к стакану

Записанная проверка получила открытый рынок и стакан без авторизации, оба HTTP 200. Gamma дал markets и next_cursor; CLOB — market, asset_id, bids, asks, timestamp. market совпал с conditionId, asset_id — с токеном. Повтор может дать другой рынок, пустоту или ошибку/отсутствие стакана. Цена образца не текущая котировка.

Выберите данные кошелька

Документированные маршруты Data включают GET /v2/positions?user={proxy wallet}&limit=1 и GET /v2/activity?user={proxy wallet}. Используйте публичный адрес прокси-кошелька, который вправе изучать; в зафиксированной проверке кошельки не запрашивались. Позиции по умолчанию OPEN. Для фильтра условия используйте condition, а не Gamma id. Постраничные чтения ожидают data и pagination, с condition_id и token_id позиций. Следуйте непрозрачному next_cursor до null; pagination.offset — метаданные отображения, а не параметр запроса. Проверяйте значения по умолчанию, фильтры, лимиты и пустые результаты каждого маршрута.

Отделяйте трейдеров от builders

Запрос трейдеров вернул HTTP 200 и одну строку user_id с data/pagination, has_more и next_cursor; проверена только первая страница. GET /v2/builders/leaderboard?time_period=day&limit=1, напротив, описывает интеграции builder_code, атрибутированный объём и активных пользователей; он остался только документально изученным. Помечайте PNL или VOLUME, период и единицы. Дневной оценённый P&L отличается от реализованного за всё время; объём измеряется долями исхода, а не USD или гарантированной прибылью. Рейтинги не устанавливают личности людей и не доказывают интеграции.

Проверьте результат

• Запишите host, путь и границу публичного/частного.
• Разделите Gamma id, conditionId и токен; сравните book.market и asset_id.
• Сохраните data/pagination и курсор, не номера страниц.
• Назовите user_id или builder_code, показатель, период и единицы.

Ограничения и частные действия

Приватный CLOB GET /data/orders требует аутентификации HMAC L2; размещение ордера дополнительно требует подписи кошелька. Публичная активность кошелька не является состоянием приватных ордеров или личностью человека. Зафиксированные проверки охватили одну страницу Gamma, один стакан CTF и одну страницу трейдеров, а не учёт кошельков, все страницы, приватные запросы, подписи, ордера или задержку. Они не гарантируют историю или будущую доступность. Не отправляйте адреса, ключи, секреты или подписи в каталог.