parsimony-polymarket

Polymarket source for parsimony: prediction-market discovery and prices via the public Gamma and CLOB HTTP APIs.

Part of the parsimony-connectors monorepo. Distributed standalone on PyPI as parsimony-polymarket.

Connectors

The surface follows how a Polymarket question is actually navigated: search → event → market → price history.

Install

pip install parsimony-polymarket

Pulls in a compatible parsimony automatically. Verify discovery:

python -c "from parsimony import discover; print([p.name for p in discover.iter_providers()])"

Configuration

No environment variables required — Polymarket's Gamma and CLOB read APIs are public. There is no API key, so this package declares no secrets and no load(*, api_key=...) convenience.

Quick start

from parsimony_polymarket import CONNECTORS

# 1. Search events by topic.
events = CONNECTORS["polymarket_search_events"](query="inflation", limit=5)
event_slug = events.raw.iloc[0]["slug"]

# 2. Drill into the event's markets.
markets = CONNECTORS["polymarket_event"](slug=event_slug)
market_slug = markets.raw.iloc[0]["market_slug"]

# 3. Get the market's outcomes and their CLOB token ids.
outcomes = CONNECTORS["polymarket_market"](slug=market_slug)
token_id = outcomes.raw.iloc[0]["clob_token_id"]

# 4. Pull that outcome's probability time series.
history = CONNECTORS["polymarket_price_history"](token_id=token_id, interval="1w")
print(history.raw.head())

For multi-plugin composition:

from parsimony import discover

connectors = discover.load_all()

Provider

• Homepage: https://polymarket.com
• Gamma API: https://gamma-api.polymarket.com
• CLOB API: https://clob.polymarket.com

License

See LICENSE.