Introduction - Polymarket Data SDK

Welcome to polymarket-data, the community-maintained TypeScript SDK for Polymarket’s public APIs.

This SDK is built by independent contributors and is not officially affiliated with the Polymarket team. Always validate behaviour against Polymarket’s public documentation before deploying production systems.

Quickstart

Install the SDK, configure endpoints, and run your first health check.

What’s in the box?

Strong Typing

Every request/response is validated with Zod for runtime and IDE safety.

Live Examples

Examples are exercised against the live Polymarket APIs for accuracy.

Conceptual Diagram

The Polymarket constructor spins up two HTTP clients, one targeting the data endpoint and one for the gamma endpoint. Each method inherits common validation and error handling layers.

Ready to build?

Data API

Positions, trades, activity, holders, and value analytics.

Gamma API

Search, comments, series, markets, and events intelligence.

Happy building—and thanks for contributing to the broader Polymarket ecosystem.