> ## Documentation Index
> Fetch the complete documentation index at: https://docs.probalytics.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Unified prediction market data platform

# Probalytics

Clean, unified prediction market data. One API. Multiple access methods.

Aggregate data from Polymarket, Kalshi, and more into a single normalized dataset. Choose how you access it: REST API, raw SQL, the Python client, or bulk exports.

<CardGroup cols={2}>
  <Card title="REST API" icon="code" href="/docs/quickstart#rest-api">
    Query via HTTP with auth
  </Card>

  <Card title="SQL (ClickHouse)" icon="database" href="/docs/quickstart#sql-clickhouse">
    Direct database connection
  </Card>

  <Card title="Python Client" icon="python" href="/docs/python-client/overview">
    Typed models and dataframes
  </Card>

  <Card title="File Downloads" icon="arrow-down" href="/docs/file-downloads/overview">
    Parquet exports
  </Card>
</CardGroup>

## The Problem

<Warning>
  Prediction market data is fragmented across exchanges with different APIs, formats, and schemas. Polymarket needs blockchain indexing. Kalshi has its own REST API. Building cross-platform analysis means maintaining multiple integrations and handling data inconsistencies.
</Warning>

What we solved:

* ✓ Unified API across exchanges
* ✓ Normalized data schema
* ✓ Historical data back to platform launch
* ✓ Continuous updates
* ✓ Multiple access methods for your workflow

## Data Available

Three core datasets, continuously updated:

<CardGroup cols={2}>
  <Card title="Markets" icon="chart-line">
    Every prediction market question: title, outcomes, category, status, open/close dates, resolution data, current prices
  </Card>

  <Card title="Fills" icon="handshake">
    Every executed trade: price, size, taker side, timestamp, taker/maker IDs
  </Card>

  <Card title="Orderbook snapshots" icon="layer-group">
    Full bid/ask depth per outcome, captured when the book changes. Polymarket and Kalshi
  </Card>
</CardGroup>

<Tip>
  Historical records go back to each platform's launch. Data refreshes every 5 minutes.
</Tip>

## Supported Exchanges

| Exchange       | Type                 | Coverage                            | Status      |
| -------------- | -------------------- | ----------------------------------- | ----------- |
| **Polymarket** | Blockchain (Polygon) | Markets, fills, orderbook snapshots | Live ✓      |
| **Kalshi**     | US-regulated         | Markets, fills, orderbook snapshots | Live ✓      |
| **Metaculus**  | Forecasting platform | Questions, predictions              | Coming soon |

## Access Methods

Choose what fits your workflow:

### REST API

Query via HTTP with simple authentication. Best for: production applications, quick integrations.

* Authentication: API key in header
* Rate limited: 3,000 requests per 10 seconds
* Response format: JSON

### SQL (ClickHouse)

Direct database connection. Best for: data analysis, batch operations, complex queries, dashboards.

* Connect from: Python, Node.js, Go, DBeaver, etc.
* Full SQL support: aggregations, joins, window functions
* Performance: optimized for analytics

### File Downloads

Bulk Parquet exports. Best for: local analysis, research, backups, data science pipelines.

* Format: Parquet
* Frequency: weekly (fills), monthly (markets)
* See [File Downloads](/docs/file-downloads/overview)

## Use Cases

<CardGroup cols={2}>
  <Card title="Trading" icon="rocket">
    Build bots, alerts, dashboards. Track prices across platforms. Detect opportunities.
  </Card>

  <Card title="Research" icon="microscope">
    Market efficiency analysis. Forecast accuracy studies. Information aggregation patterns.
  </Card>

  <Card title="Arbitrage" icon="arrows-left-right">
    Find price spreads. Match markets across exchanges. Identify inefficiencies.
  </Card>

  <Card title="Backtesting" icon="chart-area">
    Test strategies against historical data. Validate models. Performance analysis.
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="play" href="/docs/quickstart">
    Get working code in 2 minutes
  </Card>

  <Card title="SQL Guide" icon="database" href="/docs/sql-guide/overview">
    Tables, schemas, queries
  </Card>

  <Card title="File Downloads" icon="arrow-down" href="/docs/file-downloads/overview">
    Bulk Parquet exports
  </Card>

  <Card title="Tutorials" icon="graduation-cap" href="/docs/tutorials/track-price-spreads">
    Real examples: arbitrage, analysis, pipelines
  </Card>
</CardGroup>

## Need Help?

* **Quick question?** Check [Troubleshooting](/docs/troubleshooting)
* **Still stuck?** Email [support@probalytics.io](mailto:support@probalytics.io) or join our [Discord](#)
* **Found a bug?** [GitHub Issues](#)