Load Markets

Load and cache all markets from the exchange into this.markets and this.marketsBySlug. Subsequent calls return the cached result without hitting the API again. This is the correct way to paginate or iterate over markets without drift. Because fetchMarkets() always hits the API, repeated calls with different offset values may return inconsistent results if the exchange reorders or adds markets between requests. Use loadMarkets() once to get a stable snapshot, then paginate over Object.values(exchange.markets) locally.

POST /api/{exchange}/loadMarkets

Python

Polymarket

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

200

{
  "success": true,
  "error": {
    "message": "<string>",
    "code": "HOSTED_TRADING_ERROR",
    "retryable": true,
    "exchange": "<string>",
    "detail": {}
  },
  "data": {}
}

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.

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

Body

application/json

args · boolean[]

Maximum array length: 1

credentials · object

Optional authentication credentials for exchange operations.

Show child attributes

Response

200 - application/json

Load 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