> ## Documentation Index > Fetch the complete documentation index at: https://pmxt.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # 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. ## OpenAPI ````yaml /api-reference/openapi.json post /api/{exchange}/loadMarkets openapi: 3.0.0 info: title: PMXT Hosted API description: >- One API for supported prediction markets. Hosted catalog search in under 10ms, a unified schema for supported venues, and venue-native trading where venues expose writes. version: 2.54.0 servers: - url: https://api.pmxt.dev description: Hosted PMXT (production) security: [] tags: - name: Hosted description: >- Requires a PMXT API key. These endpoints use the cross-venue catalog and have no local equivalent. - name: Local Only description: >- Executed locally by the SDK against the venue. Never proxied through PMXT servers. - name: Data Feeds description: >- Auxiliary price and oracle data feeds (Binance, Chainlink). CCXT-compatible method names and response shapes. paths: /api/{exchange}/loadMarkets: post: summary: Load Markets description: >- 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. operationId: loadMarkets parameters: - $ref: '#/components/parameters/ExchangeParam' requestBody: content: application/json: schema: title: LoadMarketsRequest type: object properties: args: type: array maxItems: 1 items: type: boolean credentials: $ref: '#/components/schemas/ExchangeCredentials' responses: '200': description: Load Markets response content: application/json: schema: allOf: - $ref: '#/components/schemas/BaseResponse' - type: object properties: data: type: object additionalProperties: $ref: '#/components/schemas/UnifiedMarket' security: [] x-codeSamples: - lang: python label: Polymarket source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Polymarket( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: Limitless source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Limitless( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: Kalshi source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Kalshi( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: KalshiDemo source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.KalshiDemo( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: Probable source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Probable( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: Baozi source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Baozi( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: Myriad source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Myriad( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: Opinion source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Opinion( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: Metaculus source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Metaculus( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: Smarkets source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Smarkets( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: PolymarketUS source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.PolymarketUS( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: Hyperliquid source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Hyperliquid( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: GeminiTitan source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.GeminiTitan( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: SuiBets source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.SuiBets( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: Rain source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Rain( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: python label: Hunch source: |- import pmxt # API key optional — enables faster catalog-backed lookups exchange = pmxt.Hunch( pmxt_api_key="YOUR_PMXT_API_KEY", ) result = exchange.load_markets() - lang: javascript label: Polymarket source: |- import { Polymarket } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Polymarket({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: Limitless source: |- import { Limitless } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Limitless({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: Kalshi source: |- import { Kalshi } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Kalshi({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: KalshiDemo source: |- import { KalshiDemo } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new KalshiDemo({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: Probable source: |- import { Probable } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Probable({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: Baozi source: |- import { Baozi } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Baozi({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: Myriad source: |- import { Myriad } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Myriad({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: Opinion source: |- import { Opinion } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Opinion({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: Metaculus source: |- import { Metaculus } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Metaculus({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: Smarkets source: |- import { Smarkets } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Smarkets({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: PolymarketUS source: |- import { PolymarketUS } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new PolymarketUS({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: Hyperliquid source: |- import { Hyperliquid } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Hyperliquid({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: GeminiTitan source: |- import { GeminiTitan } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new GeminiTitan({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: SuiBets source: |- import { SuiBets } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new SuiBets({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: Rain source: |- import { Rain } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Rain({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); - lang: javascript label: Hunch source: |- import { Hunch } from "pmxtjs"; // API key optional — enables faster catalog-backed lookups const exchange = new Hunch({ pmxtApiKey: "YOUR_PMXT_API_KEY", }); const result = await exchange.loadMarkets(); components: parameters: ExchangeParam: in: path name: exchange schema: type: string enum: - polymarket - kalshi - kalshi-demo - limitless - probable - baozi - myriad - opinion - metaculus - smarkets - polymarket_us - gemini-titan - hyperliquid - suibets - rain - hunch - router required: true description: The prediction market exchange to target. schemas: ExchangeCredentials: type: object description: Optional authentication credentials for exchange operations. properties: apiKey: type: string apiSecret: type: string description: Standard API secret for HMAC-authenticated exchanges passphrase: type: string description: Standard API passphrase for HMAC-authenticated exchanges apiToken: type: string description: 'Metaculus: `Authorization: Token ` for higher rate limits' privateKey: type: string description: Required for Polymarket L1 auth signatureType: oneOf: - type: number - type: string description: >- 0 = EOA, 1 = Poly Proxy, 2 = Gnosis Safe (Can also use 'eoa', 'polyproxy', 'gnosis_safe') funderAddress: type: string description: The address funding the trades (defaults to signer address) walletAddress: type: string baseUrl: type: string BaseResponse: type: object properties: success: type: boolean example: true error: $ref: '#/components/schemas/ErrorDetail' UnifiedMarket: type: object properties: marketId: type: string description: The unique identifier for this market eventId: type: string description: Link to parent event title: type: string description: The market title (e.g., "Will BTC close above $100k on Dec 31?"). description: type: string description: Long-form market description or resolution criteria. slug: type: string description: URL-friendly slug for the market. outcomes: type: array items: $ref: '#/components/schemas/MarketOutcome' description: The possible outcomes for this market. resolutionDate: type: string format: date-time description: >- When the market is scheduled to resolve. Optional because some venues do not publish a cutoff for every market (e.g. Opinion categorical children) — emit `undefined` rather than coercing to epoch. volume24h: type: number description: Trading volume over the past 24 hours (USD). volume: type: number description: Total / Lifetime volume liquidity: type: number description: Current market liquidity (USD). openInterest: type: number description: Total value of outstanding contracts (USD). url: type: string description: Canonical URL to view the market on the venue. image: type: string description: Optional image URL for the market. category: type: string description: >- Optional category label. Venue-defined — common values include "Sports", "Politics", "Crypto", "Economics", "Science", "Culture". Polymarket uses finer-grained categories like "Bitcoin", "Soccer", "Economic Policy"; Kalshi uses broader ones like "Sports" or "Mentions". tags: type: array items: type: string description: >- Optional list of tags. More granular than category — e.g. ["Crypto", "Crypto Prices", "Bitcoin"] or ["Politics", "Elections", "Trump"]. Tags vary by venue: Polymarket markets carry several, Kalshi typically one. tickSize: type: number description: Minimum price increment (e.g., 0.01, 0.001) status: type: string description: Venue-native lifecycle status (e.g. 'active', 'closed', 'archived'). contractAddress: type: string description: >- On-chain contract / condition identifier where applicable (Polymarket conditionId, etc.). sourceMetadata: type: object additionalProperties: {} description: >- Raw venue-specific metadata not captured by first-class fields (e.g. Kalshi series_ticker / series_title from the parent event, Polymarket series). Passed through verbatim so downstream consumers can recover anything the unified shape omits. Each venue populates what it has. sourceExchange: type: string description: >- The exchange/venue this market originates from (e.g. 'polymarket', 'kalshi'). Populated by the Router. 'yes': allOf: - $ref: '#/components/schemas/MarketOutcome' description: Convenience accessor for the YES outcome on a binary market. 'no': allOf: - $ref: '#/components/schemas/MarketOutcome' description: Convenience accessor for the NO outcome on a binary market. up: allOf: - $ref: '#/components/schemas/MarketOutcome' description: Convenience accessor for the UP outcome on a binary market. down: allOf: - $ref: '#/components/schemas/MarketOutcome' description: Convenience accessor for the DOWN outcome on a binary market. required: - marketId - title - description - outcomes - volume24h - liquidity - url ErrorDetail: type: object description: >- 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`. properties: message: type: string description: Human-readable error message. code: type: string description: >- Stable machine-readable error code. Hosted-mode errors use the `HostedTradingError` family (e.g. `INSUFFICIENT_ESCROW_BALANCE`, `BUILT_ORDER_EXPIRED`); pre-hosted local errors use the legacy family (e.g. `BAD_REQUEST`, `NOT_FOUND`). enum: - HOSTED_TRADING_ERROR - INSUFFICIENT_ESCROW_BALANCE - ORDER_SIZE_TOO_SMALL - INVALID_API_KEY - OUTCOME_NOT_FOUND - CATALOG_UNAVAILABLE - BUILT_ORDER_EXPIRED - INVALID_SIGNATURE - NO_LIQUIDITY - MISSING_WALLET_ADDRESS - BAD_REQUEST - AUTHENTICATION_ERROR - PERMISSION_DENIED - NOT_FOUND - ORDER_NOT_FOUND - MARKET_NOT_FOUND - EVENT_NOT_FOUND - RATE_LIMIT_EXCEEDED - INVALID_ORDER - INSUFFICIENT_FUNDS - VALIDATION_ERROR - NETWORK_ERROR - EXCHANGE_NOT_AVAILABLE - NOT_SUPPORTED retryable: type: boolean description: >- Hint for clients: when `true`, the same request may succeed on retry (e.g. transient network or rate-limit conditions); when `false`, the caller should not retry without modifying the request. exchange: type: string nullable: true description: >- Venue the error originated from, when known (e.g. 'polymarket', 'kalshi'). detail: type: object additionalProperties: {} nullable: true description: >- Free-form hosted-mode detail blob. Shape depends on `code` — e.g. for `INSUFFICIENT_ESCROW_BALANCE` it may include `{ requested, available }`; for `ORDER_SIZE_TOO_SMALL` it may include `{ min }`; for `BUILT_ORDER_EXPIRED` it may include `{ expiry }`. MarketOutcome: type: object properties: outcomeId: type: string description: >- Outcome ID for trading operations (CLOB Token ID for Polymarket, Market Ticker for Kalshi) marketId: type: string description: >- The market this outcome belongs to (set automatically when outcomes are built) label: type: string description: Human-readable outcome label (e.g., "Yes", "No", candidate name). price: type: number description: Probability between 0.0 and 1.0. priceChange24h: type: number description: >- Change in price over the past 24 hours, as an absolute probability delta. metadata: type: object additionalProperties: {} description: Exchange-specific metadata (e.g., clobTokenId for Polymarket) required: - outcomeId - label - price ````