Polymarket — это децентрализованная платформа прогнозных рынков, где пользователи могут торговать на исход будущих событий с использованием технологии блокчейн. Polymarket предоставляет комплексный API, позволяющий разработчикам и агентам получать доступ к данным рынков в реальном времени, спискам событий, информации о ценах и статистике стакана заявок для создания рабочих процессов на основе данных и автоматизаций с использованием ИИ.
С помощью API Polymarket и интеграции AACFlow вы можете позволить агентам программно получать информацию о прогнозных рынках, исследовать открытые рынки и связанные с ними события, анализировать исторические данные о ценах, а также получать доступ к стаканам заявок и средним ценам рынков. Это открывает новые возможности для исследований, автоматизированного анализа и разработки интеллектуальных агентов, которые реагируют на вероятности событий в реальном времени, полученные из рыночных цен.
Ключевые особенности интеграции Polymarket включают:
- Список рынков и фильтрация: Просмотр всех текущих или исторических прогнозных рынков, фильтрация по тегам, сортировка и постраничная навигация по результатам.
- Детали рынка: Получение деталей для отдельного рынка по ID рынка или slug, включая его исходы и статус.
- Списки событий: Доступ к спискам событий Polymarket и детальной информации о событиях.
- Стакан заявок и данные о ценах: Анализ стакана заявок, получение последних рыночных цен, просмотр средней цены или получение исторической информации о ценах для любого рынка.
- Готовность к автоматизации: Создание агентов или инструментов, которые программно реагируют на изменения рынков, изменение коэффициентов или конкретные исходы событий.
Используя эти задокументированные конечные точки API, вы можете легко интегрировать богатые данные прогнозных рынков Polymarket в свои собственные рабочие процессы ИИ, информационные панели, исследовательские инструменты и торговые автоматизации.
Интегрируйте прогнозные рынки Polymarket в рабочий процесс. Можно получать рынки, конкретный рынок, события, конкретное событие, теги, серии, стакан заявок, цену, среднюю цену, историю цен, цену последней сделки, спред, минимальный шаг цены, позиции, сделки, активность, таблицу лидеров, держателей и выполнять поиск.
Получение списка прогнозных рынков от Polymarket с возможностью фильтрации
| Параметр | Тип | Обязательный | Описание |
|---|
closed | string | Нет | Фильтр по статусу закрытия (true/false). Используйте false только для открытых рынков. |
order | string | Нет | Поле для сортировки (например, volumeNum, liquidityNum, startDate, endDate, createdAt) |
ascending | string | Нет | Направление сортировки (true для возрастания, false для убывания) |
tagId | string | Нет | Фильтр по ID тега |
limit | string | Нет | Количество результатов на странице (например, "25"). Максимум: 50. |
offset | string | Нет | Количество результатов для пропуска при постраничной навигации (например, "50"). |
| Параметр | Тип | Описание |
|---|
markets | array | Массив объектов рынков |
↳ id | string | ID рынка |
↳ question | string | Вопрос рынка |
↳ conditionId | string | ID условия |
↳ slug | string | Slug рынка |
↳ endDate | string | Дата окончания |
↳ image | string | URL изображения рынка |
↳ outcomes | string | JSON строка исходов |
↳ outcomePrices | string | JSON строка цен исходов |
↳ volume | string | Общий объем |
↳ liquidity | string | Общая ликвидность |
↳ active | boolean | Активен ли рынок |
↳ closed | boolean | Закрыт ли рынок |
↳ volumeNum | number | Объем в виде числа |
↳ liquidityNum | number | Ликвидность в виде числа |
↳ clobTokenIds | array | ID токенов CLOB |
Получение деталей конкретного прогнозного рынка по ID или slug
| Параметр | Тип | Обязательный | Описание |
|---|
marketId | string | Нет | ID рынка (например, "0x1234...abcd" в формате ID условия). Обязателен, если не указан slug. |
slug | string | Нет | Slug рынка (например, "will-trump-win"). URL-дружественный идентификатор. Обязателен, если не указан marketId. |
| Параметр | Тип | Описание |
|---|
market | object | Объект рынка с деталями |
↳ id | string | ID рынка |
↳ question | string | Вопрос рынка |
↳ conditionId | string | ID условия |
↳ slug | string | Slug рынка |
↳ resolutionSource | string | Источник разрешения |
↳ endDate | string | Дата окончания |
↳ startDate | string | Дата начала |
↳ image | string | URL изображения рынка |
↳ icon | string | URL иконки рынка |
↳ description | string | Описание рынка |
↳ outcomes | string | JSON строка исходов |
↳ outcomePrices | string | JSON строка цен исходов |
↳ volume | string | Общий объем |
↳ liquidity | string | Общая ликвидность |
↳ active | boolean | Активен ли рынок |
↳ closed | boolean | Закрыт ли рынок |
↳ archived | boolean | Архивирован ли рынок |
↳ volumeNum | number | Объем в виде числа |
↳ liquidityNum | number | Ликвидность в виде числа |
↳ clobTokenIds | array | ID токенов CLOB |
↳ acceptingOrders | boolean | Принимает ли заказы |
↳ negRisk | boolean | Отрицательный ли риск |
Получение списка событий от Polymarket с возможностью фильтрации
| Параметр | Тип | Обязательный | Описание |
|---|
closed | string | Нет | Фильтр по статусу закрытия (true/false). Используйте false только для открытых событий. |
order | string | Нет | Поле для сортировки (например, volume, liquidity, startDate, endDate, createdAt) |
ascending | string | Нет | Направление сортировки (true для возрастания, false для убывания) |
tagId | string | Нет | Фильтр по ID тега |
limit | string | Нет | Количество результатов на странице (например, "25"). Максимум: 50. |
offset | string | Нет | Количество результатов для пропуска при постраничной навигации (например, "50"). |
| Параметр | Тип | Описание |
|---|
events | array | Массив объектов событий |
↳ id | string | ID события |
↳ ticker | string | Тикер события |
↳ slug | string | Slug события |
↳ title | string | Название события |
↳ description | string | Описание события |
↳ startDate | string | Дата начала |
↳ endDate | string | Дата окончания |
↳ image | string | URL изображения события |
↳ icon | string | URL иконки события |
↳ active | boolean | Активно ли событие |
↳ closed | boolean | Закрыто ли событие |
↳ archived | boolean | Архивировано ли событие |
↳ liquidity | number | Общая ликвидность |
↳ volume | number | Общий объем |
↳ markets | array | Массив рынков в этом событии |
Получение деталей конкретного события по ID или slug
| Параметр | Тип | Обязательный | Описание |
|---|
eventId | string | Нет | ID события (например, "12345" или UUID формат). Обязателен, если не указан slug. |
slug | string | Нет | Slug события (например, "2024-presidential-election"). URL-дружественный идентификатор. Обязателен, если не указан eventId. |
| Параметр | Тип | Описание |
|---|
event | object | Объект события с деталями |
↳ id | string | ID события |
↳ ticker | string | Тикер события |
↳ slug | string | Slug события |
↳ title | string | Название события |
↳ description | string | Описание события |
↳ startDate | string | Дата начала |
↳ creationDate | string | Дата создания |
↳ endDate | string | Дата окончания |
↳ image | string | URL изображения события |
↳ icon | string | URL иконки события |
↳ active | boolean | Активно ли событие |
↳ closed | boolean | Закрыто ли событие |
↳ archived | boolean | Архивировано ли событие |
↳ liquidity | number | Общая ликвидность |
↳ volume | number | Общий объем |
↳ openInterest | number | Открытый интерес |
↳ commentCount | number | Количество комментариев |
↳ markets | array | Массив рынков в этом событии |
Получение доступных тегов для фильтрации рынков от Polymarket
| Параметр | Тип | Обязательный | Описание |
|---|
limit | string | Нет | Количество результатов на странице (например, "25"). Максимум: 50. |
offset | string | Нет | Количество результатов для пропуска при постраничной навигации (например, "50"). |
| Параметр | Тип | Описание |
|---|
tags | array | Массив объектов тегов |
↳ id | string | ID тега |
↳ label | string | Метка тега |
↳ slug | string | Slug тега |
↳ createdAt | string | Временная метка создания |
↳ updatedAt | string | Временная метка последнего обновления |
Поиск рынков, событий и профилей на Polymarket
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Поисковый запрос (например, "presidential election", "bitcoin price"). |
limit | string | Нет | Количество результатов на странице (например, "25"). Максимум: 50. |
page | string | Нет | Номер страницы для постраничной навигации (например, "2"). 1-индексированный. |
cache | string | Нет | Включить кэширование (true/false) |
eventsStatus | string | Нет | Фильтр событий по статусу |
limitPerType | string | Нет | Ограничить результаты по типу (markets, events, profiles) |
eventsTag | string | Нет | Фильтр по тегам событий (через запятую) |
sort | string | Нет | Поле для сортировки |
ascending | string | Нет | Направление сортировки (true для возрастания, false для убывания) |
searchTags | string | Нет | Включить теги в результаты поиска (true/false) |
searchProfiles | string | Нет | Включить профили в результаты поиска (true/false) |
recurrence | string | Нет | Фильтр по типу повторения |
excludeTagId | string | Нет | Исключить события с этими ID тегов (через запятую) |
keepClosedMarkets | string | Нет | Включить закрытые рынки в результаты (0 или 1) |
| Параметр | Тип | Описание |
|---|
results | object | Результаты поиска, содержащие массивы markets, events, tags и profiles |
↳ markets | array | Массив соответствующих объектов рынков |
↳ events | array | Массив соответствующих объектов событий |
↳ tags | array | Массив соответствующих объектов тегов |
↳ profiles | array | Массив соответствующих объектов профилей |
Получение серий (групп связанных рынков) от Polymarket
| Параметр | Тип | Обязательный | Описание |
|---|
limit | string | Нет | Количество результатов на странице (например, "25"). Максимум: 50. |
offset | string | Нет | Количество результатов для пропуска при постраничной навигации (например, "50"). |
| Параметр | Тип | Описание |
|---|
series | array | Массив объектов серий |
↳ id | string | ID серии |
↳ ticker | string | Тикер серии |
↳ slug | string | Slug серии |
↳ title | string | Название серии |
↳ seriesType | string | Тип серии |
↳ recurrence | string | Паттерн повторения |
↳ image | string | URL изображения серии |
↳ icon | string | URL иконки серии |
↳ active | boolean | Активна ли серия |
↳ closed | boolean | Закрыта ли серия |
↳ archived | boolean | Архивирована ли серия |
↳ featured | boolean | Является ли серия избранной |
↳ volume | number | Общий объем |
↳ liquidity | number | Общая ликвидность |
↳ eventCount | number | Количество событий в серии |
Получение конкретной серии (группы связанных рынков) по ID от Polymarket
| Параметр | Тип | Обязательный | Описание |
|---|
seriesId | string | Да | ID серии (например, "12345" или UUID формат). |
| Параметр | Тип | Описание |
|---|
series | object | Объект серии с деталями |
↳ id | string | ID серии |
↳ ticker | string | Тикер серии |
↳ slug | string | Slug серии |
↳ title | string | Название серии |
↳ seriesType | string | Тип серии |
↳ recurrence | string | Паттерн повторения |
↳ image | string | URL изображения серии |
↳ icon | string | URL иконки серии |
↳ active | boolean | Активна ли серия |
↳ closed | boolean | Закрыта ли серия |
↳ archived | boolean | Архивирована ли серия |
↳ featured | boolean | Является ли серия избранной |
↳ volume | number | Общий объем |
↳ liquidity | number | Общая ликвидность |
↳ commentCount | number | Количество комментариев |
↳ eventCount | number | Количество событий в серии |
↳ events | array | Массив событий в этой серии |
Получение сводки стакана заявок для конкретного токена
| Параметр | Тип | Обязательный | Описание |
|---|
tokenId | string | Да | ID токена CLOB из массива clobTokenIds рынка (например, "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |
| Параметр | Тип | Описание |
|---|
orderbook | object | Стакан заявок с массивами bids и asks |
↳ market | string | Идентификатор рынка |
↳ asset_id | string | ID токена актива |
↳ hash | string | Хэш стакана заявок |
↳ timestamp | string | Временная метка |
↳ bids | array | Ордера на покупку |
↳ price | string | Цена покупки |
↳ size | string | Размер покупки |
↳ asks | array | Ордера на продажу |
↳ price | string | Цена продажи |
↳ size | string | Размер продажи |
↳ min_order_size | string | Минимальный размер ордера |
↳ tick_size | string | Минимальный шаг цены |
↳ neg_risk | boolean | Отрицательный ли риск |
Получение рыночной цены для конкретного токена и стороны
| Параметр | Тип | Обязательный | Описание |
|---|
tokenId | string | Да | ID токена CLOB из массива clobTokenIds рынка (например, "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |
side | string | Да | Сторона ордера: "buy" или "sell". |
| Параметр | Тип | Описание |
|---|
price | string | Рыночная цена |
Получение средней цены для конкретного токена
| Параметр | Тип | Обязательный | Описание |
|---|
tokenId | string | Да | ID токена CLOB из массива clobTokenIds рынка (например, "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |
| Параметр | Тип | Описание |
|---|
midpoint | string | Средняя цена |
Получение исторических данных о ценах для конкретного рыночного токена
| Параметр | Тип | Обязательный | Описание |
|---|
tokenId | string | Да | ID токена CLOB из массива clobTokenIds рынка (например, "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |
interval | string | Нет | Продолжительность, заканчивающаяся текущим временем (1m, 1h, 6h, 1d, 1w, max). Взаимоисключающий с startTs/endTs. |
fidelity | number | Нет | Разрешение данных в минутах (например, 60 для ежечасно) |
startTs | number | Нет | Начальная временная метка (Unix секунды UTC) |
endTs | number | Нет | Конечная временная метка (Unix секунды UTC) |
| Параметр | Тип | Описание |
|---|
history | array | Массив записей истории цен |
↳ t | number | Unix временная метка |
↳ p | number | Цена на момент временной метки |
Получение цены последней сделки для конкретного токена
| Параметр | Тип | Обязательный | Описание |
|---|
tokenId | string | Да | ID токена CLOB из массива clobTokenIds рынка (например, "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |
| Параметр | Тип | Описание |
|---|
price | string | Цена последней сделки |
side | string | Сторона последней сделки (BUY или SELL) |
Получение спреда между ценой покупки и продажи для конкретного токена
| Параметр | Тип | Обязательный | Описание |
|---|
tokenId | string | Да | ID токена CLOB из массива clobTokenIds рынка (например, "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |
| Параметр | Тип | Описание |
|---|
spread | object | Значение спреда между ценой покупки и продажи |
↳ spread | string | Значение спреда |
Получение минимального шага цены для конкретного токена
| Параметр | Тип | Обязательный | Описание |
|---|
tokenId | string | Да | ID токена CLOB из массива clobTokenIds рынка (например, "71321045679252212594626385532706912750332728571942532289631379312455583992563"). |
| Параметр | Тип | Описание |
|---|
tickSize | string | Минимальный шаг цены |
Получение пользовательских позиций от Polymarket
| Параметр | Тип | Обязательный | Описание |
|---|
user | string | Да | Адрес кошелька пользователя |
market | string | Нет | ID условий для фильтрации позиций (например, "0x1234...abcd,0x5678...efgh"). Взаимоисключающий с eventId. |
eventId | string | Нет | ID события для фильтрации позиций (например, "12345"). Взаимоисключающий с market. |
sizeThreshold | string | Нет | Порог минимального размера позиции (по умолчанию: 1) |
redeemable | string | Нет | Фильтр только для погашаемых позиций (true/false) |
mergeable | string | Нет | Фильтр только для объединяемых позиций (true/false) |
sortBy | string | Нет | Поле для сортировки (TOKENS, CURRENT, INITIAL, CASHPNL, PERCENTPNL, TITLE, RESOLVING, PRICE, AVGPRICE) |
sortDirection | string | Нет | Направление сортировки (ASC или DESC) |
title | string | Нет | Поисковый фильтр по названию |
limit | string | Нет | Количество результатов на странице (например, "25"). |
offset | string | Нет | Количество результатов для пропуска при постраничной навигации (например, "50"). |
| Параметр | Тип | Описание |
|---|
positions | array | Массив объектов позиций |
↳ proxyWallet | string | Адрес прокси-кошелька |
↳ asset | string | ID токена актива |
↳ conditionId | string | ID условия |
↳ size | number | Размер позиции |
↳ avgPrice | number | Средняя цена |
↳ initialValue | number | Начальная стоимость |
↳ currentValue | number | Текущая стоимость |
↳ cashPnl | number | Прибыль/убыток в денежном выражении |
↳ percentPnl | number | Прибыль/убыток в процентах |
↳ totalBought | number | Всего куплено |
↳ realizedPnl | number | Реализованная прибыль/убыток |
↳ percentRealizedPnl | number | Реализованная прибыль/убыток в процентах |
↳ curPrice | number | Текущая цена |
↳ redeemable | boolean | Погашаема ли позиция |
↳ mergeable | boolean | Объединяема ли позиция |
↳ title | string | Название рынка |
↳ slug | string | Slug рынка |
↳ icon | string | URL иконки рынка |
↳ eventSlug | string | Slug события |
↳ outcome | string | Название исхода |
↳ outcomeIndex | number | Индекс исхода |
↳ oppositeOutcome | string | Название противоположного исхода |
↳ oppositeAsset | string | ID токена противоположного актива |
↳ endDate | string | Дата окончания |
↳ negativeRisk | boolean | Отрицательный ли риск |
Получение истории сделок от Polymarket
| Параметр | Тип | Обязательный | Описание |
|---|
user | string | Нет | Адрес кошелька пользователя для фильтрации сделок |
market | string | Нет | ID рынка/условия для фильтрации сделок (например, "0x1234...abcd"). Взаимоисключающий с eventId. |
eventId | string | Нет | ID события для фильтрации сделок (например, "12345"). Взаимоисключающий с market. |
side | string | Нет | Фильтр направления сделки (BUY или SELL) |
takerOnly | string | Нет | Фильтр только для сделок тейкера (true/false, по умолчанию: true) |
filterType | string | Нет | Тип фильтра (CASH или TOKENS) - требует filterAmount |
filterAmount | string | Нет | Порог суммы фильтра - требует filterType |
limit | string | Нет | Количество результатов на странице (например, "50"). По умолчанию: 100, максимум: 10000. |
offset | string | Нет | Количество результатов для пропуска при постраничной навигации (например, "100"). |
| Параметр | Тип | Описание |
|---|
trades | array | Массив объектов сделок |
↳ proxyWallet | string | Адрес прокси-кошелька |
↳ side | string | Сторона сделки (BUY или SELL) |
↳ asset | string | ID токена актива |
↳ conditionId | string | ID условия |
↳ size | number | Размер сделки |
↳ price | number | Цена сделки |
↳ timestamp | number | Unix временная метка |
↳ title | string | Название рынка |
↳ slug | string | Slug рынка |
↳ icon | string | URL иконки рынка |
↳ eventSlug | string | Slug события |
↳ outcome | string | Название исхода |
↳ outcomeIndex | number | Индекс исхода |
↳ name | string | Имя трейдера |
↳ pseudonym | string | Псевдоним трейдера |
↳ bio | string | Биография трейдера |
↳ profileImage | string | URL изображения профиля |
↳ profileImageOptimized | string | URL оптимизированного изображения профиля |
↳ transactionHash | string | Хэш транзакции |
Получение активности в блокчейне для пользователя, включая сделки, разделения, объединения, погашения, награды и конвертации
| Параметр | Тип | Обязательный | Описание |
|---|
user | string | Да | Адрес кошелька пользователя (с префиксом 0x) |
limit | string | Нет | Максимальное количество результатов для возврата (например, "50"). По умолчанию: 100, максимум: 500. |
offset | string | Нет | Количество результатов для пропуска при постраничной навигации (например, "100"). По умолчанию: 0, максимум: 10000. |
market | string | Нет | ID условий через запятую (например, "0x1234...abcd,0x5678...efgh"). Взаимоисключающий с eventId. |
eventId | string | Нет | ID событий через запятую (например, "12345,67890"). Взаимоисключающий с market. |
type | string | Нет | Фильтр типа активности: TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION, MAKER_REBATE |
start | number | Нет | Начальная временная метка (Unix секунды) |
end | number | Нет | Конечная временная метка (Unix секунды) |
sortBy | string | Нет | Поле для сортировки: TIMESTAMP, TOKENS или CASH (по умолчанию: TIMESTAMP) |
sortDirection | string | Нет | Направление сортировки: ASC или DESC (по умолчанию: DESC) |
side | string | Нет | Фильтр стороны сделки: BUY или SELL (применяется только к сделкам) |
| Параметр | Тип | Описание |
|---|
activity | array | Массив записей активности |
↳ proxyWallet | string | Адрес прокси-кошелька пользователя |
↳ timestamp | number | Unix временная метка активности |
↳ conditionId | string | ID условия рынка |
↳ type | string | Тип активности (TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION) |
↳ size | number | Размер в токенах |
↳ usdcSize | number | Размер в USDC |
↳ transactionHash | string | Хэш транзакции блокчейна |
↳ price | number | Цена (для сделок) |
↳ asset | string | ID токена/актива |
↳ side | string | Сторона сделки (BUY/SELL) |
↳ outcomeIndex | number | Индекс исхода |
↳ title | string | Название рынка |
↳ slug | string | Slug рынка |
↳ icon | string | URL иконки рынка |
↳ eventSlug | string | Slug события |
↳ outcome | string | Название исхода |
↳ name | string | Отображаемое имя пользователя |
↳ pseudonym | string | Псевдоним пользователя |
↳ bio | string | Биография пользователя |
↳ profileImage | string | URL изображения профиля пользователя |
↳ profileImageOptimized | string | URL оптимизированного изображения профиля пользователя |
