Skip to main content
GET
/
v1
/
events
{
  "success": true,
  "data": [
    {
      "id": "<string>",
      "platform": "<string>",
      "title": "<string>",
      "slug": "<string>",
      "description": "<string>",
      "category": "<string>",
      "image": "<string>",
      "volume": 123,
      "volume_24h": 123,
      "end_date": "<string>",
      "markets": [
        {}
      ],
      "matched_with": {}
    }
  ],
  "meta": {
    "page": 123,
    "limit": 123,
    "total": 123
  }
}

​
Get Events

Retrieve a list of prediction market events across all platforms.

​
Endpoint

GET https://api.matchr.xyz/v1/events

​
Query Parameters

​
limit
number
default:"20"
Number of results to return (max: 100)
​
offset
number
default:"0"
Pagination offset
​
platform
string
Filter by platform: polymarket, kalshi, or all
​
category
string
Filter by category: politics, sports, crypto, entertainment, etc.
​
sort
string
default:"volume"
Sort by: volume, volume_24h, created, ending_soon, trending
​
status
string
default:"active"
Filter by status: active, resolved, all
​
matched
boolean
Only return events with cross-platform matches
​
search
string
Full-text search query

​
Example Request

curl -X GET "https://api.matchr.xyz/v1/events?limit=10&sort=volume&category=politics" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
success
boolean
Whether the request succeeded
​
data
array
Array of event objects
​
meta
object
Pagination metadata

​
Example Response

{
  "success": true,
  "data": [
    {
      "id": "evt_123abc",
      "platform": "polymarket",
      "title": "Will Trump win the 2024 election?",
      "slug": "trump-wins-2024",
      "description": "This market resolves YES if Donald Trump...",
      "category": "politics",
      "image": "https://cdn.matchr.xyz/events/trump-2024.jpg",
      "volume": 15000000,
      "volume_24h": 500000,
      "end_date": "2024-11-05T00:00:00Z",
      "markets": [
        {
          "id": "mkt_yes123",
          "outcome": "Yes",
          "price": 0.52,
          "volume": 8000000
        },
        {
          "id": "mkt_no123",
          "outcome": "No",
          "price": 0.48,
          "volume": 7000000
        }
      ],
      "matched_with": "evt_kalshi_456"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 7234
  }
}

​
Error Codes

CodeDescription
400Invalid query parameters
401Missing or invalid API key
429Rate limit exceeded
500Server error