Если вы искали Polymarket API или доки Polymarket, короткий ответ такой: да, у Polymarket есть полноценный, в основном публичный API, и этот гайд раскладывает его так, чтобы вы за минуты начали читать рынки или собирать своё. Polymarket даёт три REST-сервиса и WebSocket, и большая часть вообще не требует ключа. Ниже что делает каждая часть, как работает авторизация, какие эндпоинты вы реально будете использовать, официальные SDK и что можно построить, со ссылками на официальную справку для точных параметров.
Не финансовый совет. Это технический гайд. Торговля на prediction-рынках это реальные деньги и реальный риск потерь, а доступ подчиняется географическим ограничениям Polymarket. Соблюдайте закон своей юрисдикции, сверяйте всё с официальными доками и сначала прочитайте наш риск-дисклеймер.
Главное
- У Polymarket три REST-API плюс WebSocket: Gamma (данные), CLOB (торговля), Data (аналитика).
- Чтение рынков, цен и лидербордов бесплатно и без ключа на API Gamma и Data.
- Торговля идёт через CLOB и авторизуется подписью кошельком Polygon, а не классическим API-ключом.
- Официальные SDK есть для Python (py-clob-client), TypeScript и Rust, а для чтения подойдёт любой HTTP-клиент.
- Официальная справка на docs.polymarket.com это источник истины по точным эндпоинтам и лимитам.
Карта: три API и WebSocket
Polymarket делит API по задаче, и это держит каждую часть простой. Таблица ниже это та модель, которую стоит запомнить.
| Сервис | Базовый URL | Для чего | Авторизация |
|---|---|---|---|
| Gamma API | gamma-api.polymarket.com | Рынки, события, теги, серии, поиск, профили | Публичный, без ключа |
| CLOB API | clob.polymarket.com | Ордербуки, цены, мидпоинты, спреды, история цен, размещение и отмена ордеров | Чтение публичное, торговля по подписи кошельком |
| Data API | data-api.polymarket.com | Позиции, сделки, активность, держатели, открытый интерес, лидерборды | Публичный, без ключа |
| WebSocket | wss://ws-subscriptions-clob.polymarket.com | Живые обновления ордербука и цен и статус своих ордеров | Канал market публичный, канал user авторизованный |
Большинство приложений читают из Gamma и Data и вообще не авторизуются. К авторизованной стороне CLOB вы обращаетесь только когда реально хотите разместить или отменить ордер.
Gamma API: каталог рынков
Gamma по адресу gamma-api.polymarket.com это место, где вы находите, что вообще есть. Два эндпоинта, которыми вы будете пользоваться постоянно, это markets и events, где событие группирует один или несколько связанных рынков (под одним вопросом может быть несколько рынков-исходов). Gamma также отдаёт теги, серии, спорт, поиск и публичные профили. Он полностью публичный, так что простой GET-запрос возвращает метаданные рынка, текущие цены и token ID, нужные для всего остального. Если вы собираете дашборд, скринер рынков или слой обнаружения для бота, начинаете отсюда.
CLOB API: ордербук и торговля
CLOB по адресу clob.polymarket.com это биржа. Его публичная сторона даёт ордербук, цены, мидпоинты, спреды и историю цен по любому токену рынка. Авторизованная сторона это где идёт торговля: вы собираете ордер с token ID, ценой, размером и стороной (покупка или продажа), подписываете его кошельком и отправляете, и так же отменяете.
Авторизация здесь это та часть, что удивляет пришедших из традиционных API. Нет ключа, который вы копируете из панели. Вместо этого вы авторизуетесь, подписывая сообщения кошельком Ethereum или Polygon, что доказывает контроль над средствами без передачи секрета на сервер. Официальные SDK берут этот поток подписи на себя, и это главная причина использовать их для торговли, а не писать своё.
Data API: позиции, сделки и лидерборды
Data по адресу data-api.polymarket.com это слой аналитики. Он отдаёт позиции пользователей, сделки, активность, данные держателей, открытый интерес, аналитику билдеров и публичные лидерборды. Это API за фичами вроде «кто чем владеет» и «кто больше в плюсе». Он полностью публичный, что делает его идеальным для исследований, дашбордов копи-анализа и всего, что изучает поведение, а не размещает ордера. Если бы вы хотели изучить, как позиционированы лучшие трейдеры, эти данные лежат здесь.
WebSocket: живые обновления
Опрашивать REST по кругу нормально для медленных данных, но для всего живого нужен WebSocket по адресу wss://ws-subscriptions-clob.polymarket.com. Подпишитесь на канал market для публичных обновлений ордербука и цен или на канал user, авторизованный, для статуса своих ордеров в реальном времени. Живые дашборды, маркетмейкер-боты и системы оповещений все живут на WebSocket, ведь он сам шлёт вам изменения, а не заставляет спрашивать снова и снова.
Официальные SDK и языки
SDK не нужен, чтобы читать данные, обычный HTTP-запрос работает на любом языке, но для торговли официальные клиенты экономят реальные силы. Polymarket ведёт клиент на Python (py-clob-client), плюс клиенты на TypeScript и Rust, а сообщество добавило ещё. SDK берут на себя подпись кошельком, сборку ордера и мелочи, которые легко сделать неверно руками. Для read-only проекта хватит curl или fetch, для торгового начинайте с официального SDK.
Что можно построить
API открывает несколько ясных проектов. Read-only дашборд или скринер рынков тянет Gamma плюс Data и не требует авторизации вообще. Исследовательский инструмент, изучающий позиционирование и лидерборды, живёт целиком на Data API. Живой виджет котировок или бот-оповещатель работают на WebSocket. А торговый бот использует официальный SDK, чтобы подписывать и отправлять ордера через CLOB, в идеале после долгой фазы бумажной торговли. По ручной стороне тех же рынков наши гайды как торговать на Polymarket и комиссии Polymarket разбирают механику, а как оракул UMA резолвит рынки объясняет расчёт, на который ваш код в итоге и ставит.
Практические заметки и подводные камни
Несколько вещей экономят время. Считайте публичные эндпоинты лимитированными: кэшируйте ответы, делайте бэкофф на ошибках и не опрашивайте в тугом цикле, когда есть WebSocket. Token ID, а не названия рынков, это ключи, что связывают Gamma, CLOB и Data, поэтому берите их сразу. Цены это вероятности от 0 до 1, а не доллары, так что расчёт размера и риска должен это учитывать. И поскольку торговля это реальные ончейн-деньги на Polygon, тестируйте на минимально возможном размере, обрабатывайте частичные исполнения и сбои и никогда не выкатывайте непроверенную стратегию. Всегда сверяйте точные пути эндпоинтов, параметры и лимиты с официальной справкой API, ведь именно она авторитетна и актуальна.
Итог
Polymarket API доступнее своей репутации: три REST-сервиса и WebSocket, причём сторона данных полностью публична, и только торговля закрыта подписью кошельком. Читайте через Gamma и Data, выходите в лайв через WebSocket и торгуйте через CLOB с официальным SDK. Стройте сначала read-only, проверяйте тщательно и уважайте географические ограничения и закон своей юрисдикции до любой реальной торговли. Новичок на самой площадке? Начните с что такое Polymarket и лучших рынков для наблюдения, а потом возвращайтесь собирать.
Эта статья это общая техническая информация, а не финансовый или юридический совет. Торговля на prediction-рынках несёт реальный риск потерь, API и эндпоинты меняются, а доступ географически ограничен. Сверяйтесь с официальными доками, прочитайте наш риск-дисклеймер и никогда не рискуйте деньгами, которые не готовы потерять.
Часто задаваемые вопросы
Есть ли у Polymarket публичный API?
Да. Polymarket даёт полноценный API для разработчиков, разделённый на три REST-сервиса: Gamma для данных о рынках и событиях, CLOB для ордербука и торговли, Data для позиций, сделок и лидербордов, плюс WebSocket для живых обновлений. Gamma и Data полностью публичные, ключ не нужен. Официальная справка лежит на docs.polymarket.com, и именно её стоит считать источником истины по точным параметрам.
API Polymarket бесплатный и нужен ли ключ?
Чтение данных бесплатно и в основном без ключа. Gamma (gamma-api.polymarket.com) и Data (data-api.polymarket.com) полностью публичные, так что рынки, цены, позиции и лидерборды можно тянуть без авторизации. CLOB (clob.polymarket.com) публичен для чтения ордербука и цен, но размещение и отмена ордеров требуют авторизации. Классической регистрации ключа нет, авторизация идёт через подпись кошельком.
В чём разница между API Gamma, CLOB и Data?
Gamma (gamma-api.polymarket.com) это каталог: рынки, события, теги, поиск, профили. CLOB (clob.polymarket.com) это биржа: ордербуки, цены, мидпоинты, спреды, история цен и размещение или отмена ордеров. Data (data-api.polymarket.com) это аналитика: позиции пользователей, сделки, активность, держатели, открытый интерес и лидерборды. Большинство приложений читают из Gamma и Data, а к авторизованной части CLOB обращаются только чтобы торговать.
Можно ли размещать сделки через Polymarket API?
Да, через авторизованные эндпоинты CLOB. Вы собираете ордер с token ID, ценой, размером и стороной (покупка или продажа), подписываете его кошельком Polygon и отправляете. Это реальные деньги ончейн, поэтому сначала тестируйте на минимальном размере, обрабатывайте ошибки и частичные исполнения и никогда не запускайте непроверенную стратегию. Торговля на prediction-рынках несёт реальный риск потерь. Это не финансовый совет.
Какие языки и SDK поддерживает Polymarket?
Polymarket ведёт официальный клиент на Python (py-clob-client), а также клиенты на TypeScript и Rust, плюс сообщество добавило библиотеки на других языках. Поскольку всё это REST и WebSocket поверх HTTP, можно использовать и обычный curl, Go или любой язык с HTTP-клиентом. Конкретно для торговли официальные SDK удобны тем, что сами берут на себя подпись кошельком и формирование ордера.
Есть ли WebSocket для живых данных Polymarket?
Да. Подключитесь к WebSocket CLOB по адресу wss://ws-subscriptions-clob.polymarket.com и подпишитесь на канал market для публичных обновлений ордербука и цен или на канал user (авторизованный) для статуса своих ордеров. WebSocket это правильный инструмент для живых дашбордов, торговых ботов и всего, что требует субсекундных обновлений, ведь опрос REST по кругу медленнее и тяжелее.
Есть ли лимиты и можно ли пользоваться API из любой страны?
Считайте публичные эндпоинты лимитированными, агрессивно кэшируйте, делайте бэкофф на ошибках и сверяйтесь с официальными доками вместо того, чтобы долбить их. Доступ также подчиняется географическим ограничениям Polymarket, они задокументированы и применяются, так что API это не обход региональных правил. Соблюдайте закон своей юрисдикции. Это общая информация, а не юридический или финансовый совет.
#Polymarket#API#CLOB#разработчикам#prediction markets#guide
Обсуждение
Загружаем комментарии…