markets

Get Market

Use when an agent needs the full detail of a single market by its composite key (source + market_id). Returns the market with its parent event reference, current probability, volume, 24h delta, and historical chart points. Includes a _meta.cite_as field that the agent can drop directly into its reply.

get/api/v1/markets/{source}/{market_id}

Request

  • Base URL: https://api.pdata.world
  • URL: https://api.pdata.world/api/v1/markets/{source}/{market_id}
  • Auth: none declared

Path parameters

sourcestring required

Platform ID: polymarket / kalshi / manifold / myriad / limitless / predict / opinion / gemini.

market_idstring required

Market ID native to the source. Composite key with source.

Response

Successful Response

sourcestring required

Venue the market comes from: polymarket, kalshi, manifold, myriad, limitless, predict, opinion or gemini.

idstring required

The venue's own market id; unique within source.

event_idstring nullable

Id of the parent event (same source). Null for orphan markets.

slugstring nullable

The venue's URL slug or ticker for the market, if any.

questionstring nullable

The market's full question as the venue titles it. For outcomes of a multi-outcome event this can be a bare label (e.g. Phoenix Suns); pair it with event_title.

group_item_titlestring nullable

Short outcome label for display under an already-shown event title, e.g. Lakers for 'Will the Lakers win the 2026 NBA Championship?'. Null when the venue supplies no separate label.

descriptionstring nullable

Resolution rules / description text as published by the venue.

imagestring nullable

Image URL published by the venue.

iconstring nullable

Icon URL published by the venue.

outcomesstring[]

Outcome labels in venue order, usually ["Yes", "No"]; other pairs exist (e.g. ["Over", "Under"], two team names).

outcome_pricesnumber[]

Price of each outcome in outcomes order, in [0, 1] (0.62 = 62 cents on the dollar).

probabilitynumber nullable

Implied probability of the first outcome (usually YES), in [0, 1]. The venue's own probability where it publishes one, else outcome_prices[0].

spreadnumber nullable

Best ask minus best bid on the first outcome, in price units [0, 1]. Null when the venue publishes no order book.

activeboolean required

The venue's own active flag.

closedboolean required

True once the venue has closed the market to trading (it may or may not have resolved yet; see result).

start_datestring date-time nullable

When the market opened, as the venue reports it (UTC).

end_datestring date-time nullable

Scheduled close or expiry, as the venue reports it (UTC).

closed_timestring date-time nullable

When the venue actually closed the market (UTC).

resultstring nullable

Venue-reported resolution, as the venue wrote it: usually yes/no (case varies by venue), Kalshi scalar, Manifold CANCEL/MKT, or the winning outcome label for non-Yes/No pairs (e.g. over 2.5, Over, a team name). Polymarket publishes no result field; for it this is derived from its UMA resolution status resolved plus a settlement price >= 0.99. Null until the market resolves.

volumenumber nullable

Lifetime trading volume. Venue-reported, 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. Null when the venue publishes no per-market volume (Gemini reports it per event); 0 means genuinely no trading.

volume_24hrnumber nullable

Trading volume over the last 24 hours. Venue-reported, 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. Limitless publishes no 24h figure, so pdata derives it from its own snapshots.

prob_24h_changenumber nullable

Change in probability over the last 24 hours, as a fraction on the same [0, 1] scale (0.05 = up 5 percentage points; negative = fell): the current value minus the oldest snapshot recorded in the trailing 24h. Null when there is no price, no snapshot in that window, or the market closed >24h ago.

volume_24h_changenumber nullable

Current volume_24hr minus the oldest snapshot of it recorded in the trailing 24h, in the same venue unit (positive = more activity than a day earlier). Null when there is no usable history.

normalized_vol_24hrnumber nullable

volume_24hr on a 0-100 log scale within its venue. Computed as 100 x ln(v+1)^2 / ln(cap+1)^2, where cap is the venue's largest value (its second largest when the largest is over 5x it), so it compares magnitude across venues where raw volume units do not. Null when the input is null or 0.

normalized_volumenumber nullable

Lifetime volume on a 0-100 log scale within its venue. Computed as 100 x ln(v+1)^2 / ln(cap+1)^2, where cap is the venue's largest value (its second largest when the largest is over 5x it), so it compares magnitude across venues where raw volume units do not. Null when the input is null or 0.

liquiditynumber nullable

Liquidity as the venue reports it, in the venue's own unit.

categoriesstring[]

pdata topic categories of the parent event (e.g. Politics, Sports). Empty for orphan markets and uncategorised events.

countriesstring[]

Countries the market concerns, full English names (at most 3), assigned by pdata's AI tagging. Empty when none applies or not yet tagged.

updated_atstring date-time required

When pdata last wrote this row (UTC): on every fetch from the venue, and again when pdata recomputes a derived field such as 24h volume, so it can be later than fetched_at. It is not when the venue last changed the market.

fetched_atstring date-time required

When pdata last fetched this row from the venue (UTC).

added_atstring date-time nullable

When this market first appeared in pdata's database (UTC). Null for markets loaded with pdata's initial backfill, whose real first appearance is earlier.

urlstring nullable

Public page for this market on the venue's own website. Null when the venue's URL pattern needs data this row lacks.

event_titlestring nullable

Title of the parent event. Use it with question when the question is only an outcome label. Null for orphan markets.

chart_24hnumber[] nullable

Last-24h probability series in [0, 1], oldest first, at most 50 points. Null when fewer than 2 snapshots exist in the window.

Changes

No recorded changes to this operation across all 1 revision of this API.