OddsPipe Python SDK

Python client for the OddsPipe prediction market API.

Install

pip install oddspipe

Quick start

from oddspipe import OddsPipe

client = OddsPipe(api_key="your-api-key")

# List top markets by volume
markets = client.markets(limit=10)
for m in markets["items"]:
    print(m["title"], m["spread"])

# Search for a market
results = client.search("Trump", platform="polymarket")

# Get OHLCV candlesticks
candles = client.candlesticks(market_id=123, interval="1h", limit=100)
for c in candles["candles"]:
    print(c["timestamp"], c["close"], c["volume"])

# Find cross-platform price divergences
spreads = client.spreads(min_spread=0.03)
for item in spreads["items"]:
    print(item["polymarket"]["title"], item["spread"]["yes_diff"])

# Most-traded matched pairs first (default sort="spread": largest divergence first)
liquid = client.spreads(sort="volume", min_score=95, limit=5)

# Cross-platform spread for a single market
spread = client.spread(market_id=123)
print(spread["sources"])
print(spread["spread"])

API reference

Error handling

from oddspipe import OddsPipe, OddsPipeError

client = OddsPipe(api_key="your-key")
try:
    client.market(999999)
except OddsPipeError as e:
    print(e.status_code)  # 404
    print(e.body)         # {"detail": "Market not found"}

A few older markets hold more than one contract on the same venue. For those, history(), candlesticks() and spread() raise OddsPipeError with status 409 instead of mixing contracts; pick one with source_id=:

try:
    candles = client.candlesticks(market_id=123)
except OddsPipeError as e:
    if e.status_code != 409:
        raise
    first = e.body["detail"]["sources"][0]["source_id"]
    candles = client.candlesticks(market_id=123, source_id=first)