nextpoly-data-provider 0.3.0

Data provider for Python - Query data from local DuckDB

polymarket-provider

Polymarket data provider for Python, built with Rust and PyO3.

Features

• Query Polymarket on-chain data (order filled events, FPMM transactions)
• Query Polymarket off-chain data (markets, market tokens)
• Query timeseries data for trading analysis
• Time-travel queries with simulation_time parameter
• Built on DuckDB for fast local queries
• Python 3.11+ support with abi3 compatibility

Installation

pip install polymarket-provider

uv

uv add polymarket-provider
# or
uv pip install polymarket-provider

Quick Start

from polymarket_provider import DataProvider

# Create provider with default DB paths
provider = DataProvider()

# Query markets
markets = provider.off_chain.markets(limit=10)
for market in markets:
    print(f"{market.question}: {market.outcome}")

# Query on-chain events
orders = provider.on_chain.order_filled_events(limit=10)

# Query time series data
ts = provider.trading.get_timeseries(token_id="...")

Time Travel Queries

from datetime import datetime, timezone

# Query data as of a specific time
ts = int(datetime(2024, 1, 1, tzinfo=timezone.utc).timestamp())
provider = DataProvider(simulation_time=ts)

# Or set it later
provider.set_simulation_time(ts)

Requirements

• Python 3.11+
• Local DuckDB database files

Type stubs

Type stubs live next to the package in crates/provider/polymarket_provider/*.pyi.

To build the extension with maturin and verify stubs against runtime objects:

uv --version
cargo run -p xtask -- stub-check

stub-check uses uv run in crates/provider, creating .venv if needed and installing maturin, mypy, ruff, and ty automatically. Pass --debug to skip --release.

Publishing

maturin publish --release

License

MIT