List Markets - PMX Docs

Query parameters

status

string

Filter by market status: active, resolved, or cancelled. Omit to return all markets.

creator

string

Filter by creator wallet address. Returns only markets created by this wallet.

expired

boolean

If true, returns only markets where the resolution time has passed but the market is still active (not yet resolved).

limit

integer

Maximum number of markets to return. Used for pagination.

offset

integer

Number of markets to skip. Used for pagination. Combine with limit to page through results.

includeBroken

boolean

If true, includes markets with uninitialized mints in results. These markets have _broken: true and cannot be traded. Defaults to false.

Response

success

boolean

pagination

object

Present when limit or offset query params are used.

Show Pagination object

data

array

Array of market objects. Markets with uninitialized mints are automatically filtered out.

Show Market object

integer

Market ID

title

string

Market title

description

string

Full market description

status

string

active, resolved, or cancelled

marketType

string

pool or amm

winningOutcome

string

unresolved, yes, or no

winningSide

string

Canonical winning side (YES or NO). Only present for resolved markets.

yesTicker

string

First outcome ticker (e.g. UP, FLIP)

noTicker

string

Second outcome ticker (e.g. DOWN, NOFLIP)

yesMint

string

First outcome token mint address

noMint

string

Second outcome token mint address

yesReserve

number

First outcome reserve (raw units)

yesReserveHuman

number

First outcome reserve in USDC (raw / 1e6)

noReserve

number

Second outcome reserve (raw units)

noReserveHuman

number

Second outcome reserve in USDC (raw / 1e6)

odds

object

Implied probabilities { yes, no }

tradeFeeBps

integer

Trade fee in basis points

creator

string

Creator’s wallet address

createdAt

number

Unix timestamp (seconds)

resolutionTime

number

Unix timestamp for resolution

mintsInitialized

boolean

true if YES/NO token mints are properly initialized. Markets with false are broken and cannot be traded.

# All active markets
curl "https://api.pmx.trade/v2/markets?status=active"

# All markets
curl "https://api.pmx.trade/v2/markets"

{
  "success": true,
  "data": [
    {
      "id": 1,
      "title": "BTC above $95000 by Mar 1 12:00 UTC",
      "description": "Will BTC be above $95,000 at the resolution time?",
      "status": "active",
      "marketType": "amm",
      "winningOutcome": "unresolved",
      "yesTicker": "YES",
      "noTicker": "NO",
      "yesMint": "8xK3...abc",
      "noMint": "9yL4...def",
      "yesReserve": 3500000,
      "noReserve": 6500000,
      "odds": { "yes": 0.65, "no": 0.35 },
      "tradeFeeBps": 200,
      "creator": "7xKX...abc",
      "createdAt": 1717200000,
      "resolutionTime": 1735689600,
      "mintsInitialized": true
    }
  ]
}

Markets with uninitialized mints (where yesMint or noMint is 11111111111111111111111111111111) are automatically excluded from list results. These are broken markets where the init-mints step was never completed.

Orderbook (CLOB)

​Query parameters

​Response

Query parameters

Response