---
title: "Get Summary"
method: GET
path: "/api/v1/summary"
tags: ["summary"]
---

# Get Summary

`GET /api/v1/summary`

## Request

- Base URL: `https://api.pdata.world`
- URL: `https://api.pdata.world/api/v1/summary`
- Auth: none declared

Use when an agent needs platform-level context before drilling into individual markets: one row per platform (Polymarket, Kalshi, Manifold, Myriad, Limitless, Predict, Opinion, Gemini) carrying 24h notional volume, active event and market counts, and that platform's category mix. Takes no parameters and returns the whole picture in one small response, which makes it the cheapest way to answer 'how big is X relative to Y' or 'which platform covers this topic'. Volumes are in each platform's native units — Manifold reports play-money mana, not USD — so do not sum across platforms without saying so.

## Response `200`

Successful Response

- SummaryOut
  - `sources` SourceSummary[], required: One entry per venue.
    - `source` string, required: Venue: polymarket, kalshi, manifold, myriad, limitless, predict, opinion or gemini.
    - `volume_24hr_total` number, required: The venue's 24-hour trading volume: the sum of its events' volume_24hr, open and recently closed, a grouped Kalshi game counted once. In the venue's own unit and not converted across venues: shares for Polymarket and contracts for Kalshi (each pays $1 at resolution), play-money mana for Manifold, and each other venue's figure as it reports it. Do not add it across venues.
    - `events_active` integer, required: Top-level events the venue still has open for trading: a Kalshi game pdata groups from sibling events counts once.
    - `markets_active` integer, required: Markets the venue still has open for trading.
    - `markets_with_volume` integer, required: Open markets that traded in the last 24 hours (volume_24hr > 0).
    - `events_with_volume` integer, required: Open top-level events that traded in the last 24 hours. Use it where markets_with_volume is 0 because the venue reports volume per event (Gemini).
    - `categories` object, required: volume_24hr_total split into four buckets, Crypto, Sports, Prices (price-derivative titles) and Other, in the venue's unit. An event goes to the first bucket that fits, in that order. Empty for a venue with no open events.
    - `computed_at` string, date-time, required: When pdata last recomputed these figures (UTC), at the end of each of the venue's ingest cycles.
  - `grand_total_volume_24hr` number, required: Sum of volume_24hr_total over every platform except play-money ones (Manifold's mana is left out). The platforms count volume in different units — Polymarket shares, Kalshi contracts, stablecoin amounts elsewhere — so this is an order-of-magnitude figure, not a dollar total.
  - `_meta` ResponseMetaList: Agent metadata for list/aggregate responses (no cite_as).
    - `attribution` string: Who aggregated this data, under which licence, and whose data it is.
    - `canonical_url` string, required: Stable URL for this resource: the pdata.world page, or the API URL for list responses.
    - `as_of` string, date-time: When this response was generated (UTC).
    - `docs` string: API documentation.

---

[API](https://skmtc.dev/pdata/apis/pdata-backend.md) · [All operations](https://skmtc.dev/pdata/apis/pdata-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/pdata/apis/pdata-backend/revisions/4c9bf3856786?raw)