polymarket-api-py 0.1.0

Pydantic models for the Polymarket Gamma and Data APIs.

polymarket-api-py

Pydantic models for the Polymarket Gamma and Data APIs (read-only, no auth).

Install

uv add polymarket-api-py

Requires Python 3.14+.

Usage

import asyncio
import httpx

from polymarket.gamma import BASE_URL
from polymarket.gamma.models import Market


async def list_open_markets(limit: int = 10) -> list[Market]:
    async with httpx.AsyncClient(base_url=BASE_URL, timeout=30.0) as http:
        r = await http.get("/markets", params={"limit": limit, "closed": False})
        r.raise_for_status()
        return [Market.model_validate(x) for x in r.json()]


asyncio.run(list_open_markets())

Regenerating models

The [regen] extra brings in datamodel-code-generator. The entrypoint reads vendored specs from specs/ and rewrites polymarket/{api}/models.py.

uv sync --extra regen
uv run polymarket-regen                  # default APIs from cached specs
uv run polymarket-regen --refetch        # re-download specs first
uv run polymarket-regen --refetch clob   # one API only
uv run polymarket-regen --list           # show known APIs

Known APIs: gamma, data, clob, relayer, bridge. Only gamma and data are generated by default.

License

MIT - see LICENSE.