API Reference
Market Data
Advanced
Get Events
Copy
curl --request GET \
--url https://api.example.com/v1/eventsCopy
{
"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
}
}Market Data
Get Events
Fetch prediction market events
GET
/
v1
/
events
Get Events
Copy
curl --request GET \
--url https://api.example.com/v1/eventsCopy
{
"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
Copy
GET https://api.matchr.xyz/v1/events
Query Parameters
Number of results to return (max: 100)
Pagination offset
Filter by platform:
polymarket, kalshi, or allFilter by category:
politics, sports, crypto, entertainment, etc.Sort by:
volume, volume_24h, created, ending_soon, trendingFilter by status:
active, resolved, allOnly return events with cross-platform matches
Full-text search query
Example Request
Copy
curl -X GET "https://api.matchr.xyz/v1/events?limit=10&sort=volume&category=politics" \
-H "Authorization: Bearer YOUR_API_KEY"
Response
Whether the request succeeded
Array of event objects
Show Event Object
Show Event Object
Unique event identifier
Source platform (polymarket, kalshi)
Event title/question
URL-friendly identifier
Detailed event description
Event category
Event thumbnail URL
Total trading volume (USD)
24-hour trading volume (USD)
ISO 8601 resolution date
Array of markets within this event
ID of matched event on other platform
Example Response
Copy
{
"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
| Code | Description |
|---|---|
400 | Invalid query parameters |
401 | Missing or invalid API key |
429 | Rate limit exceeded |
500 | Server error |
⌘I