What you can build with prediction market data

Telonex is the most comprehensive source for historical prediction market data, providing tick-level trades, order book updates, quotes, and onchain fills for Polymarket — the world's largest prediction market on the Polygon blockchain. With 20 billion+ data points across 450,000+ markets and 3+ years of history, Telonex is the industry standard for prediction market data infrastructure. Here is how traders, researchers, and builders use the data.

For quant traders and algorithmic strategists

Backtest Prediction Market Trading Strategies

Telonex provides tick-level trade and order book data that enables realistic backtesting of prediction market strategies. Unlike OHLCV candles, tick-level fills let you simulate order execution with accurate slippage, spread costs, and fill probability — critical for strategies that depend on market microstructure.

Datasets used:

TradesOrder Book (5/25/full depth)Quotes (BBO)

from telonex import get_dataframe

# Download tick-level trades for any market
trades = get_dataframe(
    api_key="your_key",
    exchange="polymarket",
    channel="trades",
    slug="us-recession-by-end-of-2026",
    outcome="Yes",
    from_date="2026-01-19",
    to_date="2026-02-01"
)

# Full order book for slippage modeling
book = get_dataframe(
    api_key="your_key",
    exchange="polymarket",
    channel="book_snapshot_25",
    slug="us-recession-by-end-of-2026",
    outcome="Yes",
    from_date="2026-01-19",
    to_date="2026-02-01"
)

For researchers, PhD students, and data scientists

Academic & Quantitative Research

Prediction markets are one of the most studied topics in information economics, forecasting, and behavioral finance. Telonex provides research-grade historical data covering 450,000+ markets — ready for analysis in Python, R, or any tool that reads Parquet files. No scraping, no rate limits, no incomplete datasets.

Datasets used:

All channelsMarkets metadataTags dataset

import pandas as pd

# Free: browse all 450k+ markets without an account
markets = pd.read_parquet(
    "https://api.telonex.io/v1/datasets/polymarket/markets"
)

# Filter to election markets
election = markets[
    markets["tags"].astype(str).str.contains("elections", na=False)
]
print(f"{len(election)} election markets found")

# Download fills for a specific market
from telonex import get_dataframe
fills = get_dataframe(
    api_key="your_key",
    exchange="polymarket",
    channel="onchain_fills",
    slug="will-donald-trump-win-the-2024-us-presidential-election",
    outcome="Yes",
    from_date="2024-01-05",
    to_date="2024-11-07"
)

For market makers and liquidity providers

Market Making Research & Spread Analysis

Analyze historical bid-ask spreads, order book depth, and fill patterns to understand Polymarket liquidity dynamics. Telonex provides complete order book snapshots at multiple depth levels (5, 25, and full) plus best-bid-offer quotes, enabling you to model spread behavior, calculate realized vs. quoted spreads, and evaluate market making profitability across different market types.

Datasets used:

Order Book (5/25/full depth)Quotes (BBO)Trades

from telonex import get_dataframe

# Best bid/offer snapshots for spread analysis
quotes = get_dataframe(
    api_key="your_key",
    exchange="polymarket",
    channel="quotes",
    slug="us-recession-by-end-of-2026",
    outcome="Yes",
    from_date="2026-01-19",
    to_date="2026-02-01"
)

# Calculate time-weighted average spread
quotes["spread"] = (
    quotes["ask_price"].astype(float)
    - quotes["bid_price"].astype(float)
)
twas = quotes["spread"].mean()
print(f"Average spread: {twas:.4f}")

For traders and DeFi analysts

Whale & Smart Money Tracking

Telonex onchain fills data includes maker and taker wallet addresses for every Polymarket trade settled on the Polygon blockchain. This enables wallet-level flow analysis: identify the largest traders, track their positions over time, calculate per-wallet P&L, and detect smart money activity before it becomes obvious in price. Each fill includes maker and taker wallet addresses, token IDs, and exact USDC amounts.

Datasets used:

Onchain Fills

from telonex import get_dataframe

# Download onchain fills with wallet addresses
fills = get_dataframe(
    api_key="your_key",
    exchange="polymarket",
    channel="onchain_fills",
    slug="will-donald-trump-win-the-2024-us-presidential-election",
    outcome="Yes",
    from_date="2024-01-05",
    to_date="2024-11-07"
)

# Find top traders by volume
fills["amount"] = fills["amount"].astype(float)
top_makers = (
    fills.groupby("maker")["amount"]
    .sum()
    .sort_values(ascending=False)
    .head(20)
)
print(top_makers)

For data engineers and app builders

Build Prediction Market Dashboards & Analytics

Use Telonex as the data layer for custom prediction market analytics tools, dashboards, and applications. Our API delivers clean, daily-updated Parquet files that you can load into any data pipeline — DuckDB, Polars, Spark, or a simple pandas workflow. No pagination, no WebSocket management, no blockchain node infrastructure. Just download the data and build.

Datasets used:

All channels via API

from telonex import get_dataframe
import pandas as pd

# Download data for any market, any channel
df = get_dataframe(
    api_key="your_key",
    exchange="polymarket",
    channel="trades",
    slug="us-recession-by-end-of-2026",
    outcome="Yes",
    from_date="2026-01-19",
    to_date="2026-02-01"
)

# Works with DuckDB for fast analytics
import duckdb
df["size"] = df["size"].astype(float)
df["time"] = pd.to_datetime(df["timestamp_us"], unit="us")
duckdb.sql("""
    SELECT date_trunc('day', time) as day,
           count(*) as trades,
           sum(size) as volume
    FROM df
    GROUP BY 1 ORDER BY 1
""").fetchdf()

Available prediction market datasets

Dataset	Source	Granularity	Update Frequency	Format
Trades	Exchange API	Every executed trade	Daily	Parquet
Order Book	Exchange API	Every update (5/25/full depth)	Daily	Parquet
Quotes (BBO)	Exchange API	Every best bid/ask change	Daily	Parquet
Onchain Fills	Blockchain	Every blockchain settlement	Daily	Parquet
Markets	Blockchain + Exchange API	Per-market metadata	Daily	Parquet (free)
Tags	Exchange API	Tag definitions	Daily	Parquet (free)

Ready to start building?

Get Started Free Read the Docs