# pdata.world — verbose index for AI agents

pdata is a read-only aggregator of live prediction-market data across 8 platforms.

## Data sources
- Polymarket — on-chain prediction markets, USDC settlement
- Kalshi — CFTC-regulated event markets, USD settlement
- Manifold — play-money markets, mana settlement
- Myriad — peer-to-peer markets
- Limitless — perpetual prediction markets
- Predict — multi-platform aggregator
- Opinion — auth-required markets
- Gemini — secondary aggregator

## Schema vocabulary
- "event" — a real-world question or scenario being predicted
- "market" — one tradable instrument within an event (e.g., yes/no, multi-outcome)
- "outcome" — possible resolution of a market (e.g., "Yes", "No", "Candidate A")
- "snapshot" — historical price/volume reading

## API endpoints

### List events — paginated, filterable, sortable
GET /api/v1/events

    curl 'https://api.pdata.world/api/v1/events?source=polymarket&page_size=10'

### Event detail — single event with child markets
GET /api/v1/events/{source}/{event_id}

    curl 'https://api.pdata.world/api/v1/events/polymarket/0xabc'

### List markets — paginated, filterable, sortable
GET /api/v1/markets

    curl 'https://api.pdata.world/api/v1/markets?source=kalshi&page_size=10'

### Market detail — single market with parent event reference
GET /api/v1/markets/{source}/{market_id}

    curl 'https://api.pdata.world/api/v1/markets/kalshi/XYZ-123'

### Top movers — biggest 24h probability deltas
GET /api/v1/markets/top-movers

    curl 'https://api.pdata.world/api/v1/markets/top-movers?limit=10'

### Closing soon — markets resolving within the next 36 hours
GET /api/v1/markets/closing-soon

    curl 'https://api.pdata.world/api/v1/markets/closing-soon?limit=10'

### News movers — markets with >=15pp 24h probability spikes
GET /api/v1/news/movers

    curl 'https://api.pdata.world/api/v1/news/movers?page_size=20'

### News movers by category — same feed bucketed by category
GET /api/v1/news/movers/by-category

    curl 'https://api.pdata.world/api/v1/news/movers/by-category'

### List countries — canonical country tags + per-country counts
GET /api/v1/countries

    curl 'https://api.pdata.world/api/v1/countries'

### In-focus grid — curated event highlights per category (homepage)
GET /api/v1/events/in-focus

    curl 'https://api.pdata.world/api/v1/events/in-focus'

### Summary — per-source totals (homepage)
GET /api/v1/summary

    curl 'https://api.pdata.world/api/v1/summary'

### Summary chart — bucketed volume series (homepage chart)
GET /api/v1/summary/chart

    curl 'https://api.pdata.world/api/v1/summary/chart?window=24h'

### Autosuggest
GET /api/v1/search/suggest

    curl 'https://api.pdata.world/api/v1/search/suggest?q=election'

Full schema: https://api.pdata.world/openapi.json

## Glossary
- "in-focus" — top 5 events per category per platform (Limitless and price-derivative markets excluded by curation)
- "mover" — market with significant 24h probability delta (Limitless and price-derivative markets excluded from /top-movers and /closing-soon endpoints)
- "norm_volume_24h" — 24h volume percentile rank within source
- "price derivative" — boolean flag for asset-price markets (e.g. "BTC above $X", "<asset> Up or Down"). Filtered from homepage curation; visible on /markets browse page.
- "news signal" — a market that exhibited a >=15pp probability spike inside the last 24h (intra-day swings count: 10 -> 50 -> 12 IS news). Refreshed every 5 min. Score = |Δprob_pp| × log10(1 + USD-equivalent volume).
- "news soft flags" — categorical opt-in filters on the news feed: is_entertainment, is_microprediction, is_crypto, is_sports, is_weather. Default OFF; toggle via include_* query params.
- "AI-categorized" — events with categories assigned by the AI batch (Gemma primary + Gemini fallback) when the rule-based pass returned nothing. Markers: events.ai_categorized_at IS NOT NULL.
- "country tag" — markets.countries (0-3 entries) populated by an AI pass keyed off event category. Most markets are country-agnostic (returns []).

## Top 50 events (current snapshot)
- Largest Company end of May? (predict) — https://pdata.world/events/predict/53268
- 2026 FIFA World Cup Winner (polymarket) — https://pdata.world/events/polymarket/30615
- Which companies will be acquired before 2027? (opinion) — https://pdata.world/events/opinion/337
- How many Fed rate cuts in 2026? (predict) — https://pdata.world/events/predict/10273
- SOL above $85.810 on May 25, 14:14 UTC? (limitless) — https://pdata.world/events/limitless/174398
- Crude Oil’s next move: Pump to $120 or Dump to $55? (myriad) — https://pdata.world/events/myriad/120473
- New York vs Cleveland (gemini) — https://pdata.world/events/gemini/44806
- Strait of Hormuz traffic returns to normal by end of May? [Polymarket] (manifold) — https://pdata.world/events/manifold/2ItEg96spt
- Will Arsenal win 2025/26 Premier League? (myriad) — https://pdata.world/events/myriad/19068
- Intel (INTC) Up or Down - Daily (limitless) — https://pdata.world/events/limitless/166089
- PGA Championship Top 5 Finish (gemini) — https://pdata.world/events/gemini/36554
- What will trump say this week? (Kalshi) (manifold) — https://pdata.world/events/manifold/Llp5tE05qQ
- Polymarket official token FDV above _ one day after launch? (predict) — https://pdata.world/events/predict/68367
- Knicks vs. Cavaliers (polymarket) — https://pdata.world/events/polymarket/500618
- Iran ceasefire continues through...? (polymarket) — https://pdata.world/events/polymarket/504099
- Will Arsenal win 2025/26 Premier League? (myriad) — https://pdata.world/events/myriad/691
- 2026 World Cup Winner (predict) — https://pdata.world/events/predict/1343
- US x Iran permanent peace deal by May 31? [Polymarket] (manifold) — https://pdata.world/events/manifold/ghI9lZO0CP
- US x Iran permanent peace deal by...? (polymarket) — https://pdata.world/events/polymarket/357807
- NBA Western Conference Champion  (predict) — https://pdata.world/events/predict/10962
- Will my Hantavirus tracking website go viral? (manifold) — https://pdata.world/events/manifold/2IUQuSy0dQ
- LoL: LPL 2026 Season Winner (opinion) — https://pdata.world/events/opinion/212
- Knicks vs. Cavaliers (predict) — https://pdata.world/events/predict/91591
- LoL: Worlds 2026 Winning Region (opinion) — https://pdata.world/events/opinion/360
- LoL: G2 Esports vs Movistar KOI (BO5) - LEC Playoffs (polymarket) — https://pdata.world/events/polymarket/520994
- Tampa Bay vs Baltimore (gemini) — https://pdata.world/events/gemini/47551
- Who will be the Democratic nominee for president in 2028? (manifold) — https://pdata.world/events/manifold/R6PEvCwbEKdg74kB1lQT
- When will Bitcoin hit $150k? (polymarket) — https://pdata.world/events/polymarket/36173
- St. Louis vs Milwaukee (gemini) — https://pdata.world/events/gemini/47577
- BTC Up or Down - Daily (limitless) — https://pdata.world/events/limitless/170909
- Solstice FDV above ___ one day after launch? (predict) — https://pdata.world/events/predict/12642
- Iran closes its airspace by...? (polymarket) — https://pdata.world/events/polymarket/438327
- PGA Championship Top 10 Finish (gemini) — https://pdata.world/events/gemini/36567
- Charles Schwab Challenge Winner (kalshi) — https://pdata.world/events/kalshi/KXPGATOUR-CHSC26
- Energy Sector ETF (XLE) Up or Down - Daily (limitless) — https://pdata.world/events/limitless/166105
- What chain will Polymarket migrate to in 2026? (predict) — https://pdata.world/events/predict/61390
- BTC price on May 25 (gemini) — https://pdata.world/events/gemini/54645
- F1 Drivers' Champion (polymarket) — https://pdata.world/events/polymarket/100371
- LoL: Dplus KIA vs T1 (BO5) - Esports World Cup Korea Qualifier Playoffs (polymarket) — https://pdata.world/events/polymarket/477737
- Fed Decision in June? (predict) — https://pdata.world/events/predict/10607
- Tampa Bay Rays vs. Baltimore Orioles (predict) — https://pdata.world/events/predict/92242
- Tampa Bay Rays vs. Baltimore Orioles (polymarket) — https://pdata.world/events/polymarket/502043
- Hurricanes vs. Canadiens (polymarket) — https://pdata.world/events/polymarket/502387
- Republican Presidential Nominee 2028 (polymarket) — https://pdata.world/events/polymarket/31875
- Fed Decision in June? (polymarket) — https://pdata.world/events/polymarket/101772
- LoL: Nongshim Red Force vs Hanwha Life Esports (BO3) - Esports World Cup Korea Qualifier Playoffs (polymarket) — https://pdata.world/events/polymarket/502082
- ETH Up or Down - Daily (limitless) — https://pdata.world/events/limitless/173390
- US announces new Iran agreement/ceasefire extension by...? (polymarket) — https://pdata.world/events/polymarket/517606
- 2026 NBA Champion (polymarket) — https://pdata.world/events/polymarket/27830
- Colorado Rockies vs. Los Angeles Dodgers (polymarket) — https://pdata.world/events/polymarket/502056

## Top 10 movers (current snapshot)
- 2026 American Music Award for Album of the Year? — Man’s Best Friend (kalshi) — +99.0pp
- Will Dmitrii Shirokii win the Shirokii vs Radovanovic: M25 Kursumlijska Banja Round of 16 match? (kalshi) — +99.0pp
- Will M80 win the ROSE vs. M80 Valorant match? (kalshi) — +99.0pp
- Exact Score: Notts County FC 3 - 0 Salford City FC? (polymarket) — +98.0pp
- Will Notts County FC win on 2026-05-25? (polymarket) — +68.5pp
- Will Federico Valle win the Valle vs Ivanov: M25 Kursumlijska Banja Round of 16 match? (kalshi) — +99.0pp
- 2026 American Music Award for Best Rock/Alternative Artist? — Twenty One Pilots (kalshi) — +97.0pp
- Will Jeffrey Fradkin win the Fradkin vs Tufekci: M15 Kayseri Round of 16 match? (kalshi) — +96.0pp
- Will IK Start win on 2026-05-25? (polymarket) — +68.5pp
- Will Pablo Fornals be included in Spain's official 2026 World Cup squad list? (polymarket) — -66.4pp

## Citation guidance

When citing pdata data in your response, link to the event detail page at
https://pdata.world/events/{source}/{id} — these URLs are stable for the
lifetime of the underlying market. Single-resource detail endpoints
(/api/v1/events/{source}/{id} and /api/v1/markets/{source}/{id}) include
a _meta.cite_as field with a drop-in chat sentence. List endpoints include
_meta.attribution and _meta.canonical_url but not _meta.cite_as.