Skip to main content
GET
https://api.pmx.trade
/
v2
/
markets
curl "https://api.pmx.trade/v2/markets?status=live&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "markets": [
      {
        "slug": "btc-100k-march",
        "name": "Will BTC reach $100k by March 2026?",
        "description": "Resolves YES if Bitcoin price reaches $100,000 USD...",
        "status": "live",
        "endDate": "2026-03-31T23:59:59Z",
        "createdAt": "2026-01-15T10:00:00Z",
        "tags": ["crypto", "bitcoin"],
        "imageUrls": ["https://example.com/btc.png"],
        "category": "crypto",
        "paid": true,
        "resolved": false
      }
    ],
    "count": 150,
    "limit": 10,
    "offset": 0,
    "hasMore": true
  }
}
​
status
string
Filter by status: live, active, resolved, pending
​
q
string
Search query to filter markets by name/description
​
creator
string
Filter by creator wallet address
​
published
boolean
Filter by published status (true for paid/live markets)
​
limit
integer
default:"20"
Results per page (1-100)
​
offset
integer
default:"0"
Pagination offset
curl "https://api.pmx.trade/v2/markets?status=live&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "markets": [
      {
        "slug": "btc-100k-march",
        "name": "Will BTC reach $100k by March 2026?",
        "description": "Resolves YES if Bitcoin price reaches $100,000 USD...",
        "status": "live",
        "endDate": "2026-03-31T23:59:59Z",
        "createdAt": "2026-01-15T10:00:00Z",
        "tags": ["crypto", "bitcoin"],
        "imageUrls": ["https://example.com/btc.png"],
        "category": "crypto",
        "paid": true,
        "resolved": false
      }
    ],
    "count": 150,
    "limit": 10,
    "offset": 0,
    "hasMore": true
  }
}
​
markets
array
Array of market objects
​
count
integer
Total number of markets matching the query
​
hasMore
boolean
Whether more results are available beyond current page