Skip to content

Market Discovery

Find active prediction markets on Polymarket — no authentication required.

Search markets

Terminal window
polygolem discover search --query "btc 5m" --limit 10
polygolem discover search --query "ethereum" --limit 5

Discover crypto markets

Find active crypto prediction markets with asset and interval filtering:

Terminal window
# Bitcoin 5-minute up/down markets
polygolem discover crypto --asset BTC --interval 5m --limit 10
# Ethereum markets with CLOB price enrichment
polygolem discover crypto --asset ETH --interval 15m --enrich
# All crypto markets
polygolem discover crypto --limit 50

Returns token IDs, outcomes, prices, and optionally live CLOB price/spread data.

Resolve the current window directly

For time-windowed markets (5m, 15m, 1h, 4h), use deterministic slug resolution instead of search — faster and immune to search index lag:

Terminal window
# Exact current BTC 5m window
polygolem discover crypto-window --asset BTC --interval 5m
# With live CLOB price and spread
polygolem discover crypto-window --asset ETH --interval 15m --enrich

This hits the event directly by its deterministic slug (btc-updown-5m-<unix_timestamp>) and returns the active market with token IDs.

List all 6 active 5-minute crypto markets

Scan every supported crypto asset and return the current 5m window for each:

Terminal window
# All 6 markets at once
polygolem discover crypto-5m
# With live CLOB price and spread (slower, one API call per market)
polygolem discover crypto-5m --enrich

Assets scanned: BTC, ETH, SOL, XRP, BNB, DOGE, HYPE. Returns token IDs, outcomes, condition IDs, and window boundaries for every active market in a single JSON response.

Stream crypto markets

Subscribe to live WebSocket events for crypto markets:

Terminal window
polygolem stream crypto --asset BTC --interval 5m --max-messages 100
polygolem stream crypto --asset ETH --custom-features

Get crypto market snapshots

Fetch current CLOB snapshots (price, spread, midpoint, tick size) for crypto markets:

Terminal window
polygolem marketdata crypto --asset BTC --interval 5m --limit 10
polygolem marketdata crypto --asset SOL --limit 5

Get market details

Terminal window
polygolem discover market --id "0xbd31dc8a..." # by Gamma ID
polygolem discover market --slug "will-btc-..." # by slug

Enrich a market

Joins Gamma metadata with CLOB data in one call:

Terminal window
polygolem discover enrich --id "0x..."

Returns: question, outcomes, prices, best bid/ask, spread, volume, tick size, fee rate, neg risk status, orderbook snapshot.

Using the Go SDK

import "github.com/TrebuchetDynamics/polygolem/pkg/marketresolver"
resolver := marketresolver.NewResolver("")
result := resolver.ResolveTokenIDs(ctx, "BTC", "5m")
// result.Status = "available"
// result.UpTokenID = "123..."
// result.DownTokenID = "456..."

Gamma API Methods

MethodDescription
MarketsList markets with filters
EventsList events with filters
SearchCross-entity search (markets, events, profiles, tags)
TagsList tags, get by ID/slug, related tags
SeriesList series, get by ID
TeamsList sports teams
CommentsList comments, get by ID/user
ProfilesGet public profile by wallet
SportsMarketTypesList valid sports market types
MarketByTokenResolve market from CLOB token ID
EventsKeyset / MarketsKeysetKeyset pagination variants