Fetch Markets

import pmxt

# API key optional — enables faster catalog-backed lookups
exchange = pmxt.Polymarket(
    pmxt_api_key="YOUR_PMXT_API_KEY",
)
result = exchange.fetch_markets(
    query="election",
    limit=10,
    status="active",
)

{
  "success": true,
  "error": {
    "message": "<string>",
    "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": {}
      }
    }
  ]
}

GET

api

{exchange}

fetchMarkets

import pmxt

# API key optional — enables faster catalog-backed lookups
exchange = pmxt.Polymarket(
    pmxt_api_key="YOUR_PMXT_API_KEY",
)
result = exchange.fetch_markets(
    query="election",
    limit=10,
    status="active",
)

{
  "success": true,
  "error": {
    "message": "<string>",
    "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

Search by keyword

Find all markets mentioning “bitcoin” on Polymarket:

import pmxt

# Optional: pass pmxt_api_key for ~100x faster catalog-backed lookups
api = pmxt.Polymarket()
markets = api.fetch_markets(query="bitcoin", limit=5)
for market in markets:
    print(market.title, market.yes.price)

import { Polymarket } from "pmxtjs";

// Optional: pass pmxtApiKey for ~100x faster catalog-backed lookups
const api = new Polymarket();
const markets = await api.fetchMarkets({ query: "bitcoin", limit: 5 });
markets.forEach((m) => console.log(m.title, m.yes.price));

curl "https://api.pmxt.dev/api/polymarket/fetchMarkets?query=bitcoin&limit=5" \
  -H "Authorization: Bearer $PMXT_API_KEY"

Filter by category

Get all sports markets on Kalshi:

import pmxt

api = pmxt.Kalshi()
markets = api.fetch_markets(category="Sports", limit=5)

import { Kalshi } from "pmxtjs";

const api = new Kalshi();
const markets = await api.fetchMarkets({ category: "Sports", limit: 5 });

curl "https://api.pmxt.dev/api/kalshi/fetchMarkets?category=Sports&limit=5" \
  -H "Authorization: Bearer $PMXT_API_KEY"

Filter by tags

Get markets tagged with elections and Trump:

import pmxt

api = pmxt.Polymarket()
markets = api.fetch_markets(tags=["Elections", "Trump"], limit=5)

import { Polymarket } from "pmxtjs";

const api = new Polymarket();
const markets = await api.fetchMarkets({
  tags: ["Elections", "Trump"],
  limit: 5,
});

curl "https://api.pmxt.dev/api/polymarket/fetchMarkets?tags=Elections&tags=Trump&limit=5" \
  -H "Authorization: Bearer $PMXT_API_KEY"

Filter by status

Find active markets on Limitless:

import pmxt

api = pmxt.Limitless()
markets = api.fetch_markets(
    status="active",
    limit=5,
)

import { Limitless } from "pmxtjs";

const api = new Limitless();
const markets = await api.fetchMarkets({
  status: "active",
  limit: 5,
});

curl "https://api.pmxt.dev/api/limitless/fetchMarkets?status=active&limit=5" \
  -H "Authorization: Bearer $PMXT_API_KEY"

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 Markets 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

Fetch Event Fetch Markets Paginated

Overview

System

Events & Markets

Trading

Orders & Positions

Cross Exchange

Order Book & Trades

Realtime

Data Feeds

Other

Enterprise

Fetch Markets

Use cases

Search by keyword

Filter by category

Filter by tags

Filter by status

Path Parameters

Query Parameters

Response

​Use cases

​Search by keyword

​Filter by category

​Filter by tags

​Filter by status

Path Parameters

Query Parameters

Response

Use cases

Search by keyword

Filter by category

Filter by tags

Filter by status