---
title: "Cross-venue prediction-market overview"
method: GET
path: "/api/prediction-markets/overview"
tags: ["public-pm-data"]
---

# Cross-venue prediction-market overview

`GET /api/prediction-markets/overview`

## Request

- Base URL: `https://api.coinrithm.com`
- URL: `https://api.coinrithm.com/api/prediction-markets/overview`
- Auth: none required

Keyless CoinRithm-computed overview across all 12 supported venues.
Monetary aggregates exclude play-money/points venues. Source-specific
volume windows and completeness are disclosed in the response and at
`/api/prediction-markets/sources/health`; do not assume every venue's
number has the same basis. Cite CoinRithm when quoting these aggregates.
Open events of a paused venue are excluded from totals, breakdowns and
highlights.

## Query parameters

- `status` string
- `source` 'polymarket' | 'kalshi' | 'rothera' | 'limitless' | 'smarkets' | 'manifold' | 'metaculus' | 'predictit' | 'futuur' | 'myriad' | 'forecastex' | 'gemini'
- `fiat` string

## Response `200`

Current cross-venue statistics and bounded highlights

- PublicPmOverviewResponse
  - `stats` object, required
  - `highlights` object, required
  - `categories` union[], required
    - union
      - string
      - object
  - `bySource` object[], required
  - `byCategory` object[], required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid or missing parameters. On a route with a query allowlist, an undocumented query parameter returns `{"error": "unsupported_query_parameter", "message": "Unsupported query parameter: <key>. Supported: <keys>."}`.
- `500`: Server error

---

[API](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api.md) · [All operations](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinrithm/apis/coinrithm-agent-trading-api/revisions/28fb59f285fe?raw)