Polyoxide

Python SDK for Polymarket APIs, powered by Rust via PyO3 and maturin.

Every client comes in async and sync variants. Async methods return Python awaitables; sync methods block via an internal Tokio runtime and release the GIL while waiting.

Async	Sync	API	Description
`Gamma`	`GammaSync`	Gamma	Market data, events, series, tags, comments, sports, search, users
`ClobClient`	`ClobClientSync`	CLOB	Order book, prices, spreads, trade history, fee rates
`DataApi`	`DataApiSync`	Data	User positions/trades/activity, leaderboard, holders, volume, open interest

Installation

pip install polyoxide

Wheels are published for Linux (x86_64, aarch64), macOS (x86_64, aarch64), and Windows (x86_64).

Quick Start

Async (Gamma -- market data)

import asyncio
from polyoxide import Gamma

async def main():
    gamma = Gamma()
    markets = await gamma.markets().list(limit=5, open=True)
    for m in markets:
        print(f"{m.question}  --  {m.slug}")

asyncio.run(main())

Sync (Gamma)

from polyoxide import GammaSync

gamma = GammaSync()
markets = gamma.markets().list(limit=5, open=True)
for m in markets:
    print(f"{m.question}  --  {m.slug}")

CLOB (order book data)

from polyoxide import ClobClientSync

clob = ClobClientSync()
book = clob.markets().order_book("TOKEN_ID")
print(book.bids, book.asks)

spread = clob.markets().spread("TOKEN_ID")
print(spread)

Data API (user positions and leaderboard)

import asyncio
from polyoxide import DataApi

async def main():
    data = DataApi()

    # Leaderboard
    leaders = await data.leaderboard().get(limit=10, time_period="WEEK")
    for t in leaders:
        print(t.user_name, t.pnl)

    # User positions
    positions = await data.user("0xADDRESS").list_positions(limit=5)
    for p in positions:
        print(p.title, p.size)

asyncio.run(main())

Client API Reference

Gamma / GammaSync

Constructed with optional base_url, timeout_ms, and pool_size keyword arguments.

Namespace	Methods
`.markets()`	`get(id)`, `get_by_slug(slug)`, `list(...)`, `tags(id)`
`.events()`	`get(id)`, `get_by_slug(slug)`, `list(...)`, `tags(id)`, `tweet_count(id)`, `comment_count(id)`
`.series()`	`get(id)`, `list(...)`
`.tags()`	`get(id)`, `get_by_slug(slug)`, `list(...)`, `get_related(id)`, `get_related_by_slug(slug)`
`.comments()`	`get(id)`, `list(...)`, `by_user(address)`
`.sports()`	`list()`, `market_types()`, `list_teams(...)`
`.search()`	`public_search(query, ...)`
`.user()`	`get(address)`
`.health()`	`ping()`

ClobClient / ClobClientSync

No arguments required (uses public/unauthenticated endpoints).

Namespace Methods

.markets() get(condition_id), get_by_token_ids(token_ids), list(), order_book(token_id), price(token_id, side), midpoint(token_id), prices_history(token_id), neg_risk(token_id), fee_rate(token_id), tick_size(token_id), spread(token_id), last_trade_price(token_id), live_activity(condition_id), simplified(), sampling(), sampling_simplified(), calculate_price(token_id, side, amount)

.health() ping(), server_time()

Namespace	Methods
`.markets()`	`get(condition_id)`, `get_by_token_ids(token_ids)`, `list()`, `order_book(token_id)`, `price(token_id, side)`, `midpoint(token_id)`, `prices_history(token_id)`, `neg_risk(token_id)`, `fee_rate(token_id)`, `tick_size(token_id)`, `spread(token_id)`, `last_trade_price(token_id)`, `live_activity(condition_id)`, `simplified()`, `sampling()`, `sampling_simplified()`, `calculate_price(token_id, side, amount)`
`.health()`	`ping()`, `server_time()`

DataApi / DataApiSync

Constructed with optional base_url, timeout_ms, and pool_size keyword arguments.

Namespace	Methods
`.user(address)`	`list_positions(...)`, `positions_value(...)`, `closed_positions(...)`, `trades(...)`, `activity(...)`, `traded()`
`.trades()`	`list(...)`
`.holders()`	`list(markets, ...)`
`.open_interest()`	`get(...)`
`.live_volume()`	`get(event_id)`
`.leaderboard()`	`get(...)`
`.builders()`	`leaderboard(...)`, `volume(...)`
`.health()`	`ping()`

Result Objects

All response objects expose named properties matching the upstream JSON fields, plus:

.to_dict() -- convert to a plain Python dict
str(obj) -- JSON string representation
repr(obj) -- type-annotated representation

Error Handling

All exceptions inherit from PolyoxideError:

from polyoxide import PolyoxideError, ApiError, RateLimitError

try:
    markets = gamma.markets().list()
except RateLimitError:
    print("slow down")
except ApiError as e:
    print(f"API error: {e}")
except PolyoxideError as e:
    print(f"something else: {e}")

Exception	When
`ApiError`	API returned an error response
`AuthenticationError`	Invalid or missing credentials
`ValidationError`	Request parameters failed validation
`RateLimitError`	Rate limit exceeded (HTTP 429)
`NetworkError`	Connection failure
`TimeoutError`	Request timed out

Async Support

Async clients (Gamma, ClobClient, DataApi) use pyo3-async-runtimes to bridge Rust futures into Python awaitables. They work with asyncio.run(), await, and any asyncio-compatible event loop.

Sync clients (GammaSync, ClobClientSync, DataApiSync) execute on a shared background Tokio runtime and release the GIL while blocking, so they are safe to use from threaded Python code.

Type Stubs

A .pyi stub file is included at python/polyoxide/__init__.pyi for editor autocomplete and type checking.

Building from Source

Requires Rust and Python 3.9+.

pip install maturin
maturin develop --release

License

Licensed under either of MIT or Apache-2.0 at your option.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

polyoxide-0.29.0.tar.gz (366.2 kB view details)

Uploaded Aug 26, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

polyoxide-0.29.0-cp39-abi3-win_amd64.whl (3.4 MB view details)

Uploaded Aug 26, 2026 CPython 3.9+Windows x86-64

polyoxide-0.29.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (3.2 MB view details)

Uploaded Aug 26, 2026 CPython 3.9+manylinux: glibc 2.17+ x86-64

polyoxide-0.29.0-cp39-abi3-macosx_11_0_arm64.whl (2.9 MB view details)

Uploaded Aug 26, 2026 CPython 3.9+macOS 11.0+ ARM64

polyoxide-0.29.0-cp39-abi3-macosx_10_12_x86_64.whl (3.1 MB view details)

Uploaded Aug 26, 2026 CPython 3.9+macOS 10.12+ x86-64

File details

Details for the file polyoxide-0.29.0.tar.gz.

File metadata

Download URL: polyoxide-0.29.0.tar.gz
Upload date: Aug 26, 2026
Size: 366.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: maturin/1.15.0

File hashes

Hashes for polyoxide-0.29.0.tar.gz
Algorithm	Hash digest
SHA256	`a3782dc1b27d17958479bbdf9fe160d03fef45b89dd9ae1edb812ef3323211c8`
MD5	`eeacadb1f4d9e0da58e0ac469b1aba67`
BLAKE2b-256	`c7846f7285d5ec47a59a85df216a08a17ebbadb7e80bb62e249bdaf50cf56aab`

See more details on using hashes here.

File details

Details for the file polyoxide-0.29.0-cp39-abi3-win_amd64.whl.

File metadata

Download URL: polyoxide-0.29.0-cp39-abi3-win_amd64.whl
Upload date: Aug 26, 2026
Size: 3.4 MB
Tags: CPython 3.9+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: maturin/1.15.0

File hashes

Hashes for polyoxide-0.29.0-cp39-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`e08ad9fbf7b2025ab5a818b05719a22b6a12432570ff7f4ff1384ee84e470e09`
MD5	`35ec0b81b3b2415f0d5db5c559712e13`
BLAKE2b-256	`f447f6b68546eef6c4be9f8cbdd87f2b25ffeffc2898f869688c2290476dac2c`

See more details on using hashes here.

File details

Details for the file polyoxide-0.29.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: polyoxide-0.29.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Aug 26, 2026
Size: 3.2 MB
Tags: CPython 3.9+, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: maturin/1.15.0

File hashes

Hashes for polyoxide-0.29.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`ebf24dd535cb17ad79ecabf4e7cacae754fe372b1e6d13bbac171fd83df5d135`
MD5	`73a2f48a50b888cbeba1a2f4157a5ed4`
BLAKE2b-256	`b261c6354a921a29bd519f0dcf391a59b0b3a02fe7642dd20626864dd1a230bf`

See more details on using hashes here.

File details

Details for the file polyoxide-0.29.0-cp39-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: polyoxide-0.29.0-cp39-abi3-macosx_11_0_arm64.whl
Upload date: Aug 26, 2026
Size: 2.9 MB
Tags: CPython 3.9+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: maturin/1.15.0

File hashes

Hashes for polyoxide-0.29.0-cp39-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`4c46992c971c3adf2cfb290850c6f92dcffa9eddbd108180050bf56a0dc47ee7`
MD5	`41e63bbbc0904f0f3823292f91f6ec54`
BLAKE2b-256	`65b6b3b7d1dc7008edc941f1f12bddf64a9176509d2be2f0cfd4c4078be9376c`

See more details on using hashes here.

File details

Details for the file polyoxide-0.29.0-cp39-abi3-macosx_10_12_x86_64.whl.

File metadata

Download URL: polyoxide-0.29.0-cp39-abi3-macosx_10_12_x86_64.whl
Upload date: Aug 26, 2026
Size: 3.1 MB
Tags: CPython 3.9+, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: maturin/1.15.0

File hashes

Hashes for polyoxide-0.29.0-cp39-abi3-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`7a54ebe9a2e76c2511eaad6fd8aa4bebbc3e6c7b668efb97e761b8f53a765ac0`
MD5	`25ab9b3902e3a810afbe8ef98144df9c`
BLAKE2b-256	`cb8e9dd1857150bf077cd2d2b7be6a89304d833c84d158f0fc3dc6efb881ea19`