API Polymarket и Kalshi: цены, стаканы и арбитраж между площадками
Коротко
- Polymarket и Kalshi отдают рынки, цены и стаканы через официальные REST API без ключа. Ключ и подпись запроса нужны для ордеров, а у Kalshi — ещё и для WebSocket.
- Цена контракта — доля доллара: 0,42 — это 42¢ и около 42 % вероятности по оценке рынка. Цену покупки нужного объёма показывает только стакан.
- Для арбитража между площадками события сопоставляют, сверяют правила и даты итогов, проходят по стаканам и вычитают комиссии. Эндпоинт
/predictions/arbitrageв Genesis API отдаёт уже посчитанные связки, сделки вы делаете сами.
API Polymarket и API Kalshi — официальные программные интерфейсы двух площадок рынков предсказаний: через них программа получает рынки, цены контрактов YES и NO и стаканы заявок, а с ключом и подписью — выставляет ордера. Рыночные данные обеих площадок читаются без ключа. Для арбитража между ними одних цен мало: события нужно сопоставить, а прибыль посчитать по стаканам с комиссиями. Готовые связки отдаёт эндпоинт /predictions/arbitrage в Genesis API.
Как устроены данные рынков предсказаний
Рынок предсказаний торгует контрактами на исход события. Каждый рынок — вопрос с ответом «да» или «нет»: контракт YES приносит $1, если событие случилось, NO — если не случилось. Как площадки подводят итоги и почему цены расходятся, разобрано в статье «Рынки предсказаний: как работают Polymarket и Kalshi» и в уроке «Что такое рынки предсказаний». Здесь — как те же сущности выглядят в API.
| Polymarket | Kalshi | |
|---|---|---|
| Группа рынков | Событие (event) с одним или несколькими рынками | Серия, в ней события (event) |
| Рынок | Бинарное условие с исходами Yes и No | Бинарный рынок с тикером |
| Исход в API | У Yes и у No свои ID токенов | Стороны YES и NO одного рынка |
| Цена | От $0,00 до $1,00 | Строка в долларах, например "0.4200" |
| Стакан | Биды и аски каждого исхода | Только биды YES и биды NO |
Цена — доля доллара: 0,42 означает 42¢ за контракт, который при нужном исходе принесёт $1. Поэтому цену читают как вероятность по оценке рынка, здесь — около 42 %. На сайте Polymarket показана середина между лучшими бидом и аском, а при спреде шире $0,10 — цена последней сделки (документация Polymarket). Для расчёта сделки берут стакан.
Стакан: биды, аски и зеркальные цены
Стакан — список заявок на покупку (биды) и продажу (аски) с ценой и количеством. У Polymarket стакан свой у каждого исхода, его запрашивают по token_id. Kalshi отдаёт только биды обеих сторон: бид YES по цене X равен аску NO по $1,00 − X (документация Kalshi).
Условный пример: лучший бид NO на Kalshi — 0,58. Значит, YES продаётся по 1 − 0,58 = 0,42, то есть за 42¢.
Официальные API Polymarket и Kalshi
Polymarket
Данные Polymarket отдают три REST API и потоки WebSocket (обзор API). Рыночные данные, включая цены и стаканы CLOB, открыты без ключа.
| API | Что даёт |
|---|---|
| Gamma API | События и рынки: метаданные, даты, ID исходов |
| CLOB API | Цены и стаканы; с ключами — ордера |
| Data API | Позиции и активность кошельков, история цен |
| WebSocket | Канал market — стаканы и цены; канал user — ордера и сделки аккаунта |
Для ордеров нужна двухступенчатая авторизация в CLOB: подпись кошелька (L1) выдаёт ключи CLOB (L2), которыми подписывают торговые запросы. ID исхода для стакана берут из Gamma API: у рынков версии v1 — из строки JSON clobTokenIds, у v2 — из positionIds; индекс 0 — YES, 1 — NO (поля рынка). Вместо прямых запросов можно взять официальный SDK для Python — пакет polymarket-client.
Kalshi
У Kalshi для рынков предсказаний есть REST API (Trade API v2), WebSocket и FIX. Рекомендованный хост REST — external-api.kalshi.com, прежний api.elections.kalshi.com тоже поддерживается, для тестов есть демо-среда (адреса сред). Серии, события, рынки, стаканы и сделки открыты без ключа.
Торговый запрос подписывают закрытым ключом (Ed25519 или RSA): ID ключа, время и подпись идут в заголовках KALSHI-ACCESS-KEY, KALSHI-ACCESS-TIMESTAMP и KALSHI-ACCESS-SIGNATURE (API-ключи Kalshi). Условия рынка, включая правила итогов, приходят текстом в полях rules_primary и rules_secondary, лучшие цены — в yes_bid_dollars, yes_ask_dollars, no_bid_dollars и no_ask_dollars.
Когда нужен ключ
| Что | Polymarket | Kalshi |
|---|---|---|
| Рынки, цены, стаканы (REST) | Без ключа | Без ключа |
| Поток стаканов (WebSocket) | Канал market — без ключа | Только с ключом, даже для публичных каналов |
| Ордера | Подпись кошелька и ключи CLOB | Запрос, подписанный закрытым ключом |
Стакан без ключа: curl и Python
# Polymarket: стакан одного исхода по token_id
curl "https://clob.polymarket.com/book?token_id=$TOKEN_ID"
# Kalshi: стакан рынка по тикеру
K=https://external-api.kalshi.com/trade-api/v2
curl "$K/markets/$TICKER/orderbook"
Polymarket вернёт bids и asks — уровни с price и size в виде строк, а также tick_size и min_order_size. Kalshi вернёт объект orderbook_fp с массивами yes_dollars и no_dollars, где уровень — пара «цена в долларах, число контрактов».
Сколько стоит покупка нужного объёма, видно только при проходе по уровням. Функция идёт по аскам Polymarket от лучшего и возвращает лучшую, среднюю и худшую цену:
import requests
CLOB = "https://clob.polymarket.com"
def walk_asks(token_id: str, shares: float):
"""Лучшая, средняя и худшая цена покупки shares акций.
Комиссия площадки здесь не учтена.
"""
r = requests.get(f"{CLOB}/book", params={"token_id": token_id},
timeout=10)
r.raise_for_status()
left, cost, prices = shares, 0.0, []
for level in reversed(r.json()["asks"]): # лучший аск — последний
price, size = float(level["price"]), float(level["size"])
take = min(left, size)
cost += take * price
prices.append(price)
left -= take
if left <= 1e-9:
return prices[0], round(cost / shares, 4), prices[-1]
return None # стакана не хватило на весь объём
print(walk_asks("TOKEN_ID_YES", 1000))
Средняя цена здесь — VWAP ордера: чем глубже покупка заходит в стакан, тем дальше она от лучшей цены. Эта разница и есть проскальзывание, а объём заявок рядом с лучшей ценой — глубина рынка.
Что мешает арбитражу между Polymarket и Kalshi
Арбитраж прогнозов между площадками — покупка YES на одной и NO на другой, когда вместе они стоят меньше $1: если итоги совпадут, одна из ног принесёт $1 при любом исходе. Сравнить две цены через официальные API просто, но сделкой связка становится только после пяти проверок.
| Проверка | В чём трудность |
|---|---|
| Сопоставление событий | Вопросы сформулированы по-разному, у рынков разные ID и устройство: событие с рынками у Polymarket, серия и события у Kalshi |
| Правила итогов | Источник, формулировка и оговорки могут отличаться при одинаковом заголовке |
| Даты итогов | Рынки закрываются в разные дни, деньги заняты до более поздней даты |
| Комиссии | Свои формулы: на Polymarket платит только тейкер, у Kalshi тип комиссии задан для серии |
| Глубина стакана | По лучшей цене продаётся ограниченное число контрактов |
На Polymarket комиссию платит только тейкер, сумма зависит от цены акции и категории рынка (комиссии Polymarket). У Kalshi тип комиссии и множитель лежат в описании серии, в полях fee_type и fee_multiplier (серия в API Kalshi). Деньги нужны заранее на обеих площадках, а доступ к каждой зависит от страны пользователя и её правил.
Условный пример: YES на Polymarket, NO на Kalshi
Условный пример: рынок «Событие X произойдёт до 31 декабря» есть на обеих площадках с одинаковыми правилами, до итогов 46 дней. Нужно 1 000 акций каждой стороны.
| Нога | Уровни стакана | Стоимость |
|---|---|---|
| YES на Polymarket | 500 по 0,40 и 500 по 0,41 | 200 + 205 = $405 |
| NO на Kalshi | 600 по 0,55 и 400 по 0,56 | 330 + 224 = $554 |
Аски NO на Kalshi получаются из бидов YES: бид YES 0,45 на 600 контрактов — это аск NO по 0,55, бид 0,44 на 400 — аск по 0,56.
По лучшим ценам пара стоит 0,40 + 0,55 = 0,95: запас 5¢ на акцию, или 0,05 / 0,95 = 5,26 % к вложенному. Средние цены прохода по стаканам — 0,405 и 0,554, вместе 0,959, и запас сжался до 4,1¢. Комиссии в примере — $6 на Polymarket и $17 на Kalshi, всего $23.
Прибыль считают за вычетом стоимости обеих ног и комиссий, годовую доходность (APR) — от срока до итогов:
В примере: 1 000 − 959 − 23 = $18 прибыли, 18 / 982 × 100 = 1,83 % к вложенному и 1,83 × 365 / 46 = 14,5 % годовых. От 5,26 % на лучших ценах после стаканов и комиссий осталась треть.
Если итоги совпадут, одна из ног принесёт $1 000 при любом исходе: вложено $982, вернётся на $18 больше. Если правила разойдутся и проиграют обе ноги, минус составит все $982.
Арбитраж прогнозов в Genesis API
Эндпоинт /predictions/arbitrage отдаёт связки, для которых эта работа уже сделана. Рынки Polymarket, Kalshi, Limitless, Predict.fun и Opinion сопоставлены, каждая нога пройдена по стакану с комиссией, посчитаны прибыль в $ и %, APR и срок до итогов. Это данные страницы «Арбитраж прогнозов» в JSON.
mode | Что в выдаче | Тарифы API |
|---|---|---|
exact | Точные пары событий двух площадок, режим по умолчанию | Start, Pro, Max |
dutch | YES на каждый исход одного события на одной площадке | Start, Pro, Max |
llm | Пары событий, сверенные ИИ | Pro, Max |
sport | Букмекерские вилки 13 площадок, только прематч | Pro, Max |
Связка из примера выше в ответе выглядела бы так, поля сокращены:
{
"kind": "cross",
"match": "exact",
"title": "Will event X happen by December 31?",
"days_left": 46,
"shares": 1000,
"size_usd": 959,
"fees_usd": 23,
"profit_usd": 18,
"profit_pct": 1.83,
"apr_pct": 14.5,
"risks": [],
"legs": [
{
"platform": "polymarket",
"side": "yes",
"price_best": 0.4,
"price_avg": 0.405,
"price_worst": 0.41,
"cost_usd": 405,
"fee_usd": 6
},
{
"platform": "kalshi",
"side": "no",
"price_best": 0.55,
"price_avg": 0.554,
"price_worst": 0.56,
"cost_usd": 554,
"fee_usd": 17
}
]
}
В ноге side — что купить: yes, no или bet, ставка у букмекера. price_best, price_avg и price_worst — лучшая, средняя и худшая цена прохода по стакану, cost_usd и fee_usd — стоимость и комиссия ноги, url — ссылка на рынок. apr_pct равен null, если до итогов меньше суток.
Коды в risks отмечают то, что расчёт не проверит: rules_differ — правила итогов на площадках могут отличаться, end_mismatch — расходятся даты итогов. В режиме sport у связки с ногой у букмекера profit_usd = null: лимит ставки неизвестен. Вилки разобраны в статье «API коэффициентов букмекеров».
Отбирают связки параметрами min_profit_pct, min_profit_usd, min_apr, max_days, platform и category. Все фильтры и поля — в инструкции «Рынки предсказаний и вилки в Genesis API». Без кода те же связки видны на странице сервиса, её колонки и метки описаны в инструкции «Арбитраж прогнозов».
Состояние площадок, аналитика и сделки
| Эндпоинт | Что отдаёт | Тарифы API |
|---|---|---|
/predictions/platforms | Режим потока площадок (ws, rest, down), время котировок и полного прохода, число рынков | Start, Pro, Max |
/predictions/analytics | Открытый интерес и объём, движения цен за 1 ч и 24 ч, потоки денег | Pro, Max |
/predictions/smart-money | Крупные сделки и киты за сутки, insider-паттерны, концентрация позиций | Pro, Max |
/predictions/trades | Лента сделок Polymarket: live — от $1 000 и умные кошельки от $100, today и 7d — тейкеры от $5 000 | Pro, Max |
/predictions/traders | Топ-300 трейдеров Polymarket по PnL за 30 дней, 7 дней или всё время | Pro, Max |
/predictions/platforms запрашивают вместе со связками: если поток площадки в down, её цены в связках могли устареть. К сделке в ленте приложены метки кошелька (tags), признак insider, роль taker или maker и текущие bid_now и ask_now исхода. Метка insider описывает паттерн поведения кошелька и ничего не доказывает.
На Trial эти эндпоинты отвечают 403 plan_restricted. Start стоит $50 в месяц и обновляет данные раз в 30 с, Pro — $100 и 10 с, Max — $200 и 5 с. Сравнение — на странице «Тарифы Genesis API», те же экраны на сайте — «Аналитика» и «Умные деньги».
Python: связки exact с min_profit_pct и max_days
Скрипт раз в meta.freshness_sec секунд берёт связки exact с прибылью от 1 % и итогами не позже чем через 60 дней. Связки с площадкой в down он пропускает, остальные печатает с ценами прохода по стакану. Ключ берётся из переменной окружения GENESIS_API_KEY, как его получить — в быстром старте.
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PARAMS = {"mode": "exact", "min_profit_pct": 1, "max_days": 60}
def get(path, params=None):
while True:
r = requests.get(f"{API}{path}", headers=HEADERS,
params=params, timeout=10)
if r.status_code in (429, 503):
wait = int(r.headers.get("Retry-After", "5"))
if wait > 60: # кончилась квота периода
raise SystemExit(f"Пауза {wait} с: квота исчерпана")
time.sleep(wait)
continue
r.raise_for_status() # 403 — эндпоинт или режим вне тарифа
return r.json()
while True:
feeds = get("/predictions/platforms")["data"]["platforms"]
down = {p["platform"] for p in feeds if p["mode"] == "down"}
body = get("/predictions/arbitrage", PARAMS)
for b in body["data"]:
if any(leg["platform"] in down for leg in b["legs"]):
continue # цены этой площадки могли устареть
print(f"{b['profit_pct']}% · ${b['profit_usd']} · "
f"APR {b['apr_pct']} · {b['days_left']} дн. · "
f"{b['title'][:40]}")
for leg in b["legs"]:
print(f" {leg['platform']} {leg['side']}: "
f"{leg['price_best']} / {leg['price_avg']} / "
f"{leg['price_worst']}, комиссия ${leg['fee_usd']}")
if b["risks"]:
print(" риски:", ", ".join(b["risks"]))
time.sleep(body["meta"]["freshness_sec"])
За цикл уходит два вызова. На Start это 2 × 86 400 / 30 = 5 760 вызовов в сутки и 5 760 × 30 = 172 800 за 30 дней при квоте 2 млн. Ответ с фильтрами приходит без ETag, поэтому экономят здесь интервалом опроса: чаще meta.freshness_sec новых данных не будет. Подробнее — в инструкциях «Лимиты Genesis API» и «Ответы и ошибки».
Вопросы и ответы
Есть ли у Polymarket официальный API?
Да. Gamma API отдаёт события и рынки, CLOB API — цены, стаканы и ордера, Data API — позиции, активность и историю цен, обновления стаканов идут по WebSocket. Рыночные данные читаются без ключа, для ордеров нужны подпись кошелька и ключи CLOB. Описание — в документации Polymarket.
Нужен ли ключ, чтобы читать рынки Kalshi?
Для REST — нет: серии, события, рынки, стаканы и сделки открыты без ключа (быстрый старт Kalshi). Ключ нужен для ордеров и для подключения к WebSocket, даже если вам нужны только публичные каналы.
Можно ли торговать через Genesis API?
Нет. Genesis API только читает данные и ордеров не ставит. Связку вы открываете сами на площадках по ссылкам из legs[].url. Автоматическая торговля через официальные API Polymarket и Kalshi находится вне Genesis API и остаётся на ваш риск.
Как часто обновляются данные?
Genesis API отдаёт новый снимок раз в meta.freshness_sec: 30 с на Start, 10 с на Pro и 5 с на Max. Насколько свежи котировки самих площадок, показывают quotes_at и full_scan_at в /predictions/platforms.
Какой тариф Genesis API нужен для арбитража Polymarket и Kalshi?
Start: в нём режимы exact и dutch и состояние площадок. Режимы llm и sport, аналитика, умные деньги, сделки и рейтинг трейдеров открыты на Pro и Max.