Skip to content
Polygolem

Gamma API

The Gamma API (https://gamma-api.polymarket.com) is Polymarket’s read-only metadata layer. It serves markets, events, search, tags, series, sports metadata, comments, and public profiles. No authentication required.

Polygolem wraps Gamma in two places:

  • internal/gamma — full typed HTTP client, used by every CLI command.
  • pkg/gamma — the public read-only surface that downstream Go consumers can import. Gamma response and query DTOs are exported from pkg/types.

The polygolem discover family is the CLI interface to Gamma:

Terminal window
polygolem discover search --query "btc 5m" --limit 10
polygolem discover markets --limit 20 --active
polygolem discover market --id    0xbd31dc8a...
polygolem discover market --slug  will-btc-be-above
polygolem discover enrich --id    0xbd31dc8a...   # joins Gamma + CLOB
polygolem discover tags --limit 100
polygolem discover series --limit 20
polygolem discover comments --entity-id 123 --entity-type market

Endpoint categories

CategoryEndpoints
MarketsList, by ID, by slug, by token ID
EventsList, by ID, by slug, keyset pagination
SearchCross-entity (markets, events, profiles, tags)
TagsList, by ID, by slug, related
SeriesList, by ID
SportsTeams, market types
CommentsList, by ID, by user
ProfilesPublic profile by wallet

Upstream