Skip to content
Polygolem

Polygolem

Polygolem is production-safe Polymarket infrastructure for Go developers. A single binary + Go SDK for trading on Polymarket V2 through deposit wallets. No Python. No npm. No opaque wrappers.

New to Polymarket? It is a prediction-market exchange: users trade YES/NO shares on real-world outcomes, and prices roughly express market-implied probabilities. Polygolem wraps the public data APIs, CLOB trading API, WebSocket streams, Polygon contracts, and deposit-wallet relayer.

Read-only by default. No credentials needed to start.

Why Polygolem instead of official SDKs?

Use Polymarket’s official Python/TypeScript SDKs when those ecosystems fit your stack. Use Polygolem when you need Go: one compiled binary, no Python/npm runtime in the signing path, read-only defaults, fixture-tested V2 deposit-wallet signing, and operator-friendly CLI workflows.

Start with the safest path

The documentation is organized by job-to-be-done, not by package name. Use the Docs Map if you need a full route through the site.

Polymarket API map

Learn what Gamma, CLOB, Data API, Stream, Relayer, and contracts each do.

Docs Map

Pick a route by audience: operator, bot developer, protocol auditor, or tool builder.

No-wallet market data

Health checks, market search, crypto-window discovery, order books, and streams.

Paper trading

Simulate orders against live CLOB prices before connecting a wallet.

Deposit-wallet trading

The POLY_1271-only path: derive, deploy, approve, fund, then trade.

Wallet intelligence

Read-only wallet dossiers, formula-versioned scores, and candidate alerts.

Agent/API surfaces

MCP/OpenAPI, Go SDK embedding, protocol fixtures, and read-only integration points.

Known limitations

  • Live trading can lose funds; use paper mode and preflight checks first.
  • New-user deposit-wallet setup can require one-time browser login.
  • Only deposit-wallet / POLY_1271 trading is supported for new production accounts.
  • pkg/experimental/ APIs can change before promotion.

Trading requires a deposit wallet (type 3 / POLY_1271). EOA, proxy, and Safe are blocked for new API users by Polymarket’s CLOB V2. Polygolem handles the full deposit wallet lifecycle: derive, deploy via relayer, fund, approve, trade.

Terminal window
polygolem discover crypto --asset BTC --interval 5m --enrich

Who This Is For

  • Bot developers building automated trading strategies in Go
  • Quant developers who want deterministic, compiled infrastructure with type safety
  • Operators running headless trading systems that need auditability and local signing
  • Engineers embedding Polymarket data and execution into larger Go services

If you are writing a Polymarket bot in Python or TypeScript, the official CLOB clients are the right choice. If you are building in Go, or you want a single static binary with fixture-tested V2 deposit-wallet signing, polygolem focuses on that path with documented tests, fixtures, and live validation evidence.

What can you do?

  • Search markets — find active prediction markets by keyword, tag, or sport
  • Discover crypto markets — filter by asset (BTC, ETH, SOL) and interval (5m, 15m, 1h) with live CLOB enrichment
  • Read order books — get real-time bid/ask depth, midpoints, spreads
  • Stream live events — subscribe to WebSocket market data for crypto or any market
  • Check market readiness — tick sizes, fee rates, neg risk status
  • Bridge assets — check supported chains, create deposit addresses, use the SDK for quotes/status
  • Paper trade — simulate orders against live market data
  • Build bots — use the Go SDK to create automated strategies

No credentials needed

Everything is read-only by default. No API keys, no wallet, no risk. Just market data.

Terminal window
# Check API health
polygolem health


# All 7 active 5m crypto markets with live prices
polygolem discover crypto-5m --enrich


# Search markets
polygolem discover search --query "btc 5m"


# Discover crypto markets with live prices
polygolem discover crypto --asset BTC --interval 5m --enrich


# Stream crypto market events live
polygolem stream crypto --asset ETH --max-messages 50


# Paper trade the current window
polygolem paper trade --asset BTC --interval 5m --side up --size 1


# Get enriched market data (Gamma + CLOB merged)
polygolem discover enrich --id "0x..."

Ready to go deeper?

Docs Map

Installation

Quick Start

Polymarket API Overview

Market Discovery

Orderbook Data

Wallet Intelligence

Deposit Wallet Lifecycle

Headless Enable Trading

Redeem Winners

Safety Model

Signature Types