Genesis Arbitrage

Genesis Arbitrage · · 14 мин чтения

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.

PolymarketKalshi
Группа рынковСобытие (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.

Когда нужен ключ

ЧтоPolymarketKalshi
Рынки, цены, стаканы (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 на Polymarket500 по 0,40 и 500 по 0,41200 + 205 = $405
NO на Kalshi600 по 0,55 и 400 по 0,56330 + 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
dutchYES на каждый исход одного события на одной площадке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 000Pro, 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.