Overview

PolyNode API

PolyNode is a real-time data API for Polymarket. It runs a full Polygon node, decodes settlement transactions from the mempool (before they confirm on-chain), and serves them alongside live CLOB orderbooks, OHLCV candles, and enriched market metadata.

What Makes PolyNode Different

Mempool data: Decoded pending settlements ~2 seconds before on-chain confirmation. Nobody else offers this.
Combined data: Market metadata (question, slug, outcomes, images) enriched on every response. One call instead of Gamma API + CLOB API.
Real-time orderbooks: WebSocket streaming of CLOB orderbook updates with best bid/ask, spread, and full depth.
OHLCV candles: 6 resolutions (1m, 5m, 15m, 1h, 4h, 1d) built from live settlement data.
Self-hostable: Single Rust binary, under 2GB RAM. Run your own instance.

Architecture

Polygon P2P Network
    │
    ▼
Bor Node (mempool monitoring)
    │
    ▼
Rust API Server ← CLOB WebSocket (orderbooks)
    │
    ├── Redis (settlements, indexes, pub/sub)
    ├── State Engine (in-memory markets, orderbooks, candles)
    └── Archive Writer (JSONL daily files)
    │
    ▼
REST API + WebSocket (your application)

Endpoints Summary

Endpoint	Description
`GET /v1/markets`	Top markets by 24h volume
`GET /v1/markets/:token_id`	Market detail with orderbook
`GET /v1/markets/slug/:slug`	Lookup by URL slug
`GET /v1/markets/condition/:id`	Lookup by condition ID
`GET /v1/markets/list`	Filtered + paginated listing
`GET /v1/search?q=`	Full-text market search
`GET /v1/orderbook/:token_id`	Full CLOB orderbook
`GET /v1/stats/:token_id`	Market statistics + 24h OHLCV
`GET /v1/candles/:token_id`	OHLCV price candles
`GET /v1/status`	System status
`GET /v1/settlements/recent`	Recent decoded settlements
`GET /v1/settlements/wallet/:addr`	Settlements by wallet
`GET /v1/settlements/token/:id`	Settlements by token
`GET /v1/wallets/:addr`	Wallet activity summary
`POST /v1/keys`	Generate API key
`GET /ws`	WebSocket streaming

Next Steps

Quickstart — Generate a key and make your first request in 30 seconds.
Authentication — API key management and headers.
WebSocket — Real-time streaming with filtered subscriptions.