Fetch Market

Fetch a single market by lookup parameters. Convenience wrapper around fetchMarkets() that returns a single result or throws MarketNotFound.

GET /api/{exchange}/fetchMarket

Python

Polymarket

import pmxt

# API key optional — enables faster catalog-backed lookups
exchange = pmxt.Polymarket(
    pmxt_api_key="YOUR_PMXT_API_KEY",
)
result = exchange.fetch_market(market_id="12345")

200

{
  "success": true,
  "error": {
    "message": "<string>",
    "code": "HOSTED_TRADING_ERROR",
    "retryable": true,
    "exchange": "<string>",
    "detail": {}
  },
  "data": {
    "marketId": "<string>",
    "title": "<string>",
    "description": "<string>",
    "outcomes": [
      {
        "outcomeId": "<string>",
        "label": "<string>",
        "price": 123,
        "marketId": "<string>",
        "priceChange24h": 123,
        "metadata": {}
      }
    ],
    "volume24h": 123,
    "liquidity": 123,
    "url": "<string>",
    "eventId": "<string>",
    "slug": "<string>",
    "resolutionDate": "2023-11-07T05:31:56Z",
    "volume": 123,
    "openInterest": 123,
    "image": "<string>",
    "category": "<string>",
    "tags": [
      "<string>"
    ],
    "tickSize": 123,
    "status": "<string>",
    "contractAddress": "<string>",
    "sourceMetadata": {},
    "sourceExchange": "<string>",
    "yes": {
      "outcomeId": "<string>",
      "label": "<string>",
      "price": 123,
      "marketId": "<string>",
      "priceChange24h": 123,
      "metadata": {}
    },
    "no": {
      "outcomeId": "<string>",
      "label": "<string>",
      "price": 123,
      "marketId": "<string>",
      "priceChange24h": 123,
      "metadata": {}
    },
    "up": {
      "outcomeId": "<string>",
      "label": "<string>",
      "price": 123,
      "marketId": "<string>",
      "priceChange24h": 123,
      "metadata": {}
    },
    "down": {
      "outcomeId": "<string>",
      "label": "<string>",
      "price": 123,
      "marketId": "<string>",
      "priceChange24h": 123,
      "metadata": {}
    }
  }
}

Faster with an API key — With a PMXT API key this endpoint is served from an indexed catalog (~10 ms) instead of proxying to the venue (~500 ms). No code changes required — same request, same response, just faster. Learn more.

Use cases

Look up by slug

Slugs are stable, human-readable identifiers that make your code self-documenting and resilient to ID changes. Use them whenever possible.

Python

import pmxt

# Optional: pass pmxt_api_key for ~100x faster catalog-backed lookups
api = pmxt.Polymarket()
market = api.fetch_market(slug="will-gavin-newsom-win-the-2028-us-presidential-election")
print(market.title, market.status)

Look up by market ID

When you already have a venue-native market ID (e.g. from a trade confirmation or webhook), pass it directly:

Python

import pmxt

api = pmxt.Polymarket()
market = api.fetch_market(market_id="46ac6f9c-c66a-48a5-8f12-beefd6e06221")
print(market.title, market.volume)

Read outcomes and prices

Every market carries an outcomes array and, for binary markets, yes / no convenience accessors with live prices:

Python

import pmxt

api = pmxt.Polymarket()
market = api.fetch_market(slug="will-gavin-newsom-win-the-2028-us-presidential-election")

# Binary shorthand
print(f"Yes {market.yes.price}  No {market.no.price}")

# Full outcomes list (works for multi-outcome markets too)
for outcome in market.outcomes:
    print(f"  {outcome.label}: {outcome.price}")

Path Parameters

exchange · enum<string> · required

The prediction market exchange to target.

Available options: polymarket, kalshi, kalshi-demo, limitless, probable, baozi, myriad, opinion, metaculus, smarkets, polymarket_us, gemini-titan, hyperliquid, suibets, rain, hunch, router

Query Parameters

limit · number

Maximum number of results to return

offset · number

Pagination offset — number of results to skip

sort · enum<string>

Sort order for results

Available options: volume, liquidity, newest

status · enum<string>

Filter by market status (default: 'active', 'inactive' and 'closed' are interchangeable)

Available options: active, inactive, closed, all

searchIn · enum<string>

Where to search (default: 'title')

Available options: title, description, both

query · string

For keyword search

slug · string

For slug/ticker lookup

marketId · string

Direct lookup by market ID

outcomeId · string

Reverse lookup -- find market containing this outcome

eventId · string

Find markets belonging to an event

page · number

For pagination (used by Limitless)

similarityThreshold · number

For semantic search (used by Limitless)

sourceExchange · string

Filter by source venue (e.g. 'polymarket', 'kalshi', 'myriad'). exchange is an alias.

exchange · string

Alias for sourceExchange.

Response

200 - application/json

Fetch Market response

success · boolean

Example:

true

error · object

Structured error envelope returned inside BaseResponse.error and ErrorResponse.error. Hosted-mode endpoints populate code, retryable, and optionally exchange / detail; legacy local-mode endpoints may still return only message.

Show child attributes

data · object

Show child attributes