Price
Получение текущих цен токенов.
GET /price
Возвращает лучшую доступную цену для одного токена. Параметр side=buy даёт цену, по которой можно купить (лучший ask), side=sell — цену продажи (лучший bid). Это самый быстрый способ узнать текущую котировку без загрузки всего ордербука.
| Параметр | Тип | Описание |
|---|---|---|
token_id | string | ID токена required |
side | string | buy или sell required |
curl "https://clob.polymarket.com/price?token_id=71321...&side=buy"
{"price": "0.65"}
GET /prices
Batch-версия /price — возвращает цены нескольких токенов одним запросом. Используйте для дашбордов и списков рынков, чтобы минимизировать количество запросов. Возвращает объект, где ключи — token_id, значения — цены.
curl "https://clob.polymarket.com/prices?token_ids=TOKEN_1,TOKEN_2&side=buy"
{"TOKEN_1": "0.65", "TOKEN_2": "0.35"}
GET /midpoint
Возвращает среднюю цену между лучшим bid и лучшим ask: (bid + ask) / 2. Midpoint считается более «честной» оценкой вероятности, так как не зависит от направления сделки. Используйте для аналитики и графиков.
curl "https://clob.polymarket.com/midpoint?token_id=71321..."
{"mid": "0.65"}
GET /spread
Возвращает спред — разницу между лучшим ask и лучшим bid. Узкий спред (0.01–0.02) означает ликвидный рынок, широкий (0.05+) — низкую ликвидность или высокую неопределённость. Полезно для оценки качества рынка и стоимости входа/выхода.
curl "https://clob.polymarket.com/spread?token_id=71321..."
{"spread": "0.02"}
Понимание цен
• side=buy — лучшая цена ask (цена покупки)
• side=sell — лучшая цена bid (цена продажи)
• Цены в долларах (0.65 = 65 центов = 65% вероятность)