К основному содержанию
скилл CX Codex

polymarket-api · agiprolabs — скилл для Claude Code: торговля на бирже прогнозов

Скилл polymarket-api для работы с API Polymarket — децентрализованной биржи прогнозов на блокчейне Polygon. Даёт доступ к данным рынков, книге заказов и механике расчётов через Gamma, CLOB и Data API.

MIT 351 установок ★ 582 обновлён 2026-09-03

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add agiprolabs/claude-trading-skills --skill polymarket-api -a claude-code
Открыть на GitHub

Что делает polymarket-api

Polymarket — это рынок предсказаний на Polygon mainnet, где каждый контракт представлен парой токенов YES/NO (ERC-1155), обеспеченных USDC 1:1. Цены колеблются от 0.00 до 1.00 USDC, а комиссия за тейкер равна нулю. Скилл покрывает весь стек: чтение метаданных рынков через Gamma API (без аутентификации), доступ к книге заказов через CLOB API с подписью EIP-712, исторические сделки из Data API и реал-тайм подписки через WebSocket.

Главная сложность — модель идентификаторов: нужно различать condition_id (хеш контракта на цепи), clob_token_ids (пару YES/NO токенов), token_id (один исход для запросов к книге) и event_id (группировку рынков). Ошибка здесь приводит к тихим неправильным ответам. Скилл использует официальный SDK py-clob-client, который берёт на себя вывод ключей API, управление учётными данными и подпись ордеров — попытки вручную реализовать EIP-712 уязвимы для ошибок.

Второе ограничение — гео: из США API заблокирован, нужен SOCKS5 прокси. После разрешения рынка выигрышные токены должны быть выкуплены вручную через вызов redeemPositions() на цепи; они не проходят автоматически на кошелёк. Расчёты по погоде привязаны к часовому поясу метрополя по местному времени (с переводом на летнее время), что отличается от Kalshi.

Какие задачи решает

  • запустить бота для торговли на Polymarket с использованием py-clob-client
  • получить текущие цены и книгу заказов для конкретного рынка прогнозов
  • подписать ордер на куплю/продажу через EIP-712 и отправить его на CLOB
  • подписаться на обновления цен и сделки в реал-тайме через WebSocket
  • разобраться с моделью идентификаторов и не перепутать condition_id с token_id

Примеры запросов агенту

  • Получи все открытые рынки погоды и выведи топ-5 по объёму
  • Подпиши ордер на покупку YES-токена за 0.65 USDC на рынке с condition_id XYZ
  • Подпишись на WebSocket и логируй каждое изменение цены для токена ABC

Как установить polymarket-api

1Через Skills CLI (Vercel)

npx skills add agiprolabs/claude-trading-skills --skill polymarket-api -a claude-code

2Вручную: положить файлы

~/.claude/skills/polymarket-api/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/polymarket-api/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о polymarket-api

Как установить polymarket-api в Claude Code?

Выполни npx skills add agiprolabs/claude-trading-skills --skill polymarket-api -a claude-code, затем открой ~/.claude/skills/polymarket-api/SKILL.md — там подробная документация API и примеры кода.

Что делает polymarket-api?

Даёт доступ ко всем API Polymarket: чтение рынков (Gamma, без аутентификации), доступ к книге заказов и размещение ордеров (CLOB с EIP-712), исторические сделки (Data API) и реал-тайм подписки (WebSocket). Основан на официальном SDK py-clob-client.

В чём главная разница между Polymarket и Kalshi?

Polymarket работает на блокчейне Polygon с на-цепными расчётами через UMA оракл (потенциальный риск споров), Kalshi — это традиционная бирже с CFTC-CCP клирингом. Погоду Polymarket разрешает по местному времени через Weather Underground, Kalshi — по LST без перевода на летнее время через NWS.

Исходный текст

SKILL.md · MIT
---
name: polymarket-api
description: Polymarket exchange mechanics — on-chain Polygon CTF, Gamma/CLOB/Data APIs, EIP-712 auth, identifier model, WebSocket, settlement, and geo/KYC constraint
---

# Polymarket API

Polymarket is a **prediction market on Polygon mainnet**. Every market is a pair of YES/NO **ERC-1155** tokens issued by the Conditional Token Framework (CTF), collateralized 1:1 in USDC. Off-chain CLOB matching, on-chain settlement, **zero taker fees**. Prices are in [0.00, 1.00] USDC; YES + NO ≈ 1.0 per market.

---

> **Before you write any API code — read the live docs first.**
>
> - Docs: https://docs.polymarket.com
> - Official Python SDK: https://github.com/Polymarket/py-clob-client
>
> Polymarket endpoints and auth flows have changed without notice. Prefer the official `py-clob-client` SDK over hand-rolled HTTP; it handles EIP-712 derivation, API credential management, and order signing. Only hand-roll when the SDK doesn't expose what you need.

---

## Identifier model

You will juggle four distinct IDs — get them confused and queries silently return wrong data.

| ID | What it is |
|----|-----------|
| `condition_id` | On-chain hex ID of the market (the CTF condition) |
| `clob_token_ids` | The YES/NO **pair** of ERC-1155 token IDs — a two-element list |
| `token_id` | A **single** outcome token — what you pass to order-book and WebSocket queries |
| `event_id` | Parent grouping (e.g. all brackets for "NYC high today") |

---

## Quick Start

### 1. Read markets — Gamma API (no auth required)

```python
import httpx

# CRITICAL: default sort is OLDEST-first — always override or you silently get closed markets
events = httpx.get("https://gamma-api.polymarket.com/events", params={
    "tag_id": 103040,        # category tag (e.g. weather)
    "order": "endDate",
    "ascending": "false",    # must be string "false", not bool
    "closed": "false",
}).json()

# Each event → markets[], each market has:
#   condition_id, clob_token_ids (YES/NO pair), question, outcomes, outcomePrices
for event in events:
    for mkt in event.get("markets", []):
        yes_token, no_token = mkt["clobTokenIds"]  # split the pair here
        print(mkt["question"], mkt["outcomePrices"])
```

**Pagination:** `limit=100&offset=N`, step by 100.

### 2. Order book and trading — CLOB API (EIP-712 auth)

```bash
uv pip install py-clob-client
```

```python
import os
from py_clob_client.client import ClobClient

client = ClobClient(
    "https://clob.polymarket.com",
    chain_id=137,                                     # Polygon mainnet
    key=os.environ["POLYMARKET_PRIVATE_KEY"],          # wallet private key — env only, NEVER hardcode
    signature_type=2,                                  # 2 = Gnosis Safe proxy (Polymarket UI accounts)
                                                       # 0 = direct EOA you fully control
)
# Derives API key/secret/passphrase from the wallet signature — call once per session
client.set_api_creds(client.create_or_derive_api_creds())

token_id = "<yes_token_from_clob_token_ids>"
book = client.get_order_book(token_id)     # bids/asks for one outcome token
price = client.get_price(token_id, side="BUY")
```

`signature_type=2` is for the proxy/Safe accounts the Polymarket web UI creates (the funder address is the Safe). Use `signature_type=0` for a raw EOA you control directly. Read the live SDK docs — the type you choose affects how orders are signed on-chain.

Wallet env vars: `POLYMARKET_PRIVATE_KEY`, `POLYMARKET_FUNDER`. Never hardcode keys.

---

## API surface overview

| API | Host | Auth | Purpose |
|-----|------|------|---------|
| Gamma | `https://gamma-api.polymarket.com` | none | Events/markets/conditions/prices metadata |
| CLOB | `https://clob.polymarket.com` | EIP-712 | Order book, order placement/cancel |
| Data | `https://data-api.polymarket.com` | none | Historical trades |
| WebSocket | `wss://ws-subscriptions-clob.polymarket.com/ws/` | none (market) / JWT (user) | Real-time book + trade ticks |

Chain: Polygon mainnet `chain_id=137`. Collateral: USDC.e at `0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174`.

---

## WebSocket

```python
# Connect to: wss://ws-subscriptions-clob.polymarket.com/ws/market
# Subscribe message:
{"type": "market", "assets_ids": ["<token_id>", "<token_id2>"]}
```

Event types: `book` (full snapshot on subscribe), `price_change` (delta updates), `last_trade_price`.

For user-level order/fill events, connect to `/ws/user` with a JWT derived from your API credentials.

---

## On-chain settlement and redemption

Polymarket weather markets resolve via **Weather Underground** ("History" tab), on the metro's **local clock with DST**, midnight-to-midnight. This differs from Kalshi, which uses LST (no DST) and NWS CLI — see `kalshi-weather-markets` for the divergence.

After resolution, winning tokens **must be redeemed manually on-chain**:

```python
# Call CTF contract redeemPositions() — the SDK or direct web3.py call
# Winnings are NOT auto-swept to your wallet
```

Disputes on the international book escalate to the **UMA optimistic oracle** (token-holder vote). This is a real resolution-divergence risk vs. Kalshi's CFTC-CCP settlement — factor it into any cross-venue comparison.

---

## US geo / KYC constraint

US persons are **blocked** from Polymarket. API calls from a US IP typically require a **SOCKS5 proxy** from an allowed jurisdiction (use a `USE_PROXY` env flag pattern; never hardcode the proxy address). This constraint — combined with on-chain capital lockup and USDC/USD friction — is why most Kalshi/Polymarket arbitrage is not executable at retail scale.

---

## Cross-references

- For strategy, sizing, and backtesting that apply across venues: `prediction-market-strategy`
- For the Kalshi counterpart (RSA-PSS auth, REST host, tickers, order schema): `kalshi-api`
- For weather settlement specifics (WU local-clock+DST vs Kalshi LST, KLGA vs KNYC station): `kalshi-weather-markets`

---

## Files

### References
- `references/clob-and-gamma-apis.md` — Full API surface, all endpoints, EIP-712 auth detail, pagination, order schema, trading-parameter defaults
- `references/settlement-and-ops.md` — WU/UMA resolution, `redeemPositions`, truth-source priority (IEM > WU > Open-Meteo), known-bad dates, geo/KYC, host-segregation, two-exchange architecture notes

© agiprolabs · MIT · agiprolabs/claude-trading-skills

Похожие скиллы

Все скиллы по теме «Финансы и бизнес» →

Сначала — polymarket-api от других авторов.

polymarket-api agentmc15 Скилл polymarket-api помогает настроить работу с Polymarket: подключить биржевой стакан CLOB, получать данные через Gamma API и рассчитывать комиссии для торговых ботов. CX Codex +1 973установок web3-polymarket Polymarket Скилл web3-polymarket для работы с Polymarket на Polygon: авторизация, ордера, данные рынков, WebSocket и газлесс-транзакции. CX Codex +1 611установок nothing-ever-happens-polymarket-bot reason-machines Скилл nothing-ever-happens-polymarket-bot помогает настроить асинхронного Python-бота для Polymarket: он ищет отдельные рынки без спорта и покупает исход «No» по заданному порогу. CX Codex +1 433установок polymarket-copy-trading-bot reason-machines Скилл polymarket-copy-trading-bot для Claude Code настраивает TypeScript-бота для копирования сделок с чужого кошелька на Polymarket через CLOB API в сети Polygon. Автоматизирует покупку исходов. CX Codex +1 812установок polymarket starchild Скилл ищет рынки Polymarket, показывает позиции и помогает размещать или отменять ордера через Privy EOA-кошелёк. CX Codex +1 237установок polymarket-live-executor mjunaidca Скилл polymarket-live-executor выполняет реальные сделки на Polymarket через ордера BUY и SELL. Каждая операция требует подтверждения человека. CX Codex +1 170установок polymarket-monitor polymarket-skills Скилл polymarket-monitor следит за рынками Polymarket по расписанию и печатает JSON-алерты, когда цена уходит за порог, плюс снапшоты стакана. CX Codex +1 220установок

Из того же набора68

Весь набор →
cost-basis-engine Скилл cost-basis-engine считает себестоимость криптосделок методами FIFO, LIFO, HIFO, specific ID и средней стоимости, чтобы сравнить налоговую нагрузку по каждому. CX Codex +1 471установок regulatory-reporting Скилл regulatory-reporting превращает историю сделок с криптовалютой в строки для форм IRS 8949 и Schedule D. Пригодится трейдерам при подготовке годовой отчётности. CX Codex +1 470установок raptor-dex Скилл raptor-dex для Claude Code настраивает и вызывает селф-хостед агрегатор DEX на Solana без лимитов API. Ищет маршруты обмена по 25+ биржам и отправляет транзакции через TPU. CX Codex +1 463установок prediction-market-strategy Скилл prediction-market-strategy для Claude Code: слой стратегии, расчёта ставки и бэктеста для бинарных prediction-рынков Kalshi, Polymarket, ForecastEx. Отбирает сделки по net edge, а не по проценту угаданных исходов. CX Codex +1 366установок kalshi-api Скилл kalshi-api для Claude Code описывает подпись RSA-PSS, схему ордеров и стакан YES/NO в API биржи Kalshi. Даёт справочную основу для написания торгового кода под этот API. CX Codex +1 355установок kalshi-weather-markets Скилл kalshi-weather-markets разбирает дневные температурные контракты Kalshi: структуру тикеров, расчёт вероятностей из прогноза, правила расчёта и подводные камни. CX Codex +1 352установок kalshi-crypto-index-markets Скилл kalshi-crypto-index-markets для Claude Code разбирает дневные и часовые диапазонные рынки Kalshi для BTC, ETH, S&P 500 и Nasdaq-100. Оценивает вероятности и время решения. CX Codex +1 346установок prediction-market-live-ops Скилл prediction-market-live-ops для автоматизированной торговли на prediction markets (Kalshi). Включает бэктест-методику, live-правила безопасности и протоколы проверки гипотез, основанные на реальной кампании с реальными деньгами. CX Codex +1 194установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой