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.
Request
- Base URL: https://api.pdata.world
- URL: https://api.pdata.world/api/v1/markets/{source}/{market_id}
- Auth: none declared
Path parameters
Platform ID: polymarket / kalshi / manifold / myriad / limitless / predict / opinion / gemini.
Market ID native to the source. Composite key with source.
Response
Successful Response
Venue the market comes from: polymarket, kalshi, manifold, myriad, limitless, predict, opinion or gemini.
The venue's own market id; unique within source.
Id of the parent event (same source). Null for orphan markets.
The venue's URL slug or ticker for the market, if any.
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.
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.
Resolution rules / description text as published by the venue.
Image URL published by the venue.
Icon URL published by the venue.
Outcome labels in venue order, usually ["Yes", "No"]; other pairs exist (e.g. ["Over", "Under"], two team names).
Price of each outcome in outcomes order, in [0, 1] (0.62 = 62 cents on the dollar).
Implied probability of the first outcome (usually YES), in [0, 1]. The venue's own probability where it publishes one, else outcome_prices[0].
Best ask minus best bid on the first outcome, in price units [0, 1]. Null when the venue publishes no order book.
The venue's own active flag.
True once the venue has closed the market to trading (it may or may not have resolved yet; see result).
When the market opened, as the venue reports it (UTC).
Scheduled close or expiry, as the venue reports it (UTC).
When the venue actually closed the market (UTC).
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.
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.
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.
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.
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.
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.
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.
Liquidity as the venue reports it, in the venue's own unit.
pdata topic categories of the parent event (e.g. Politics, Sports). Empty for orphan markets and uncategorised events.
Countries the market concerns, full English names (at most 3), assigned by pdata's AI tagging. Empty when none applies or not yet tagged.
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.
When pdata last fetched this row from the venue (UTC).
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.
Public page for this market on the venue's own website. Null when the venue's URL pattern needs data this row lacks.
Title of the parent event. Use it with question when the question is only an outcome label. Null for orphan markets.
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.