Base URL: https://app.eventgraph.ai/api/v1
Step 1 — Get your API key
Generate a free key with a single request (no signup required):
curl -X POST "https://app.eventgraph.ai/api/v1/keys?name=my-app&email=you@example.com"
{
"data": {
"key": "eg_live_a1b2c3d4e5f6...",
"key_prefix": "eg_live_a1b2...",
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "my-app",
"tier": "free",
"daily_limit": 1000,
"monthly_limit": 10000
},
"meta": {
"warning": "Store this key securely. It will not be shown again."
}
}
Save the key value immediately — it’s shown once and cannot be retrieved later.
Step 2 — Check API status
Verify your key works and see data freshness:
curl "https://app.eventgraph.ai/api/v1/status" \
-H "X-API-Key: YOUR_KEY"
Step 3 — List prediction markets
Fetch markets across all platforms with pagination:
curl "https://app.eventgraph.ai/api/v1/markets?page_size=2" \
-H "X-API-Key: YOUR_KEY"
{
"data": [
{
"id": "will-jesus-christ-return-before-2027",
"title": "Will Jesus Christ return before 2027?",
"platform": "polymarket",
"yes_price": 0.0385,
"no_price": 0.9615,
"volume": 57477936.82,
"volume_24h": 112866.95,
"status": "open",
"url": "https://polymarket.com/event/will-jesus-christ-return-before-2027/..."
},
{
"id": "will-lebron-james-win-the-2028-us-presidential-election",
"title": "Will LeBron James win the 2028 US Presidential Election?",
"platform": "polymarket",
"yes_price": 0.0065,
"no_price": 0.9935,
"volume": 47810479.72,
"volume_24h": 829374.11,
"status": "open"
}
],
"meta": {
"total": 15547,
"page": 1,
"page_size": 2,
"total_pages": 7774
}
}
Step 4 — Browse events
Events group related markets together:
curl "https://app.eventgraph.ai/api/v1/events?page_size=2" \
-H "X-API-Key: YOUR_KEY"
{
"data": [
{
"id": "democratic-presidential-nominee-2028",
"title": "Democratic Presidential Nominee 2028",
"platform": "polymarket",
"category": "world elections",
"market_count": 128,
"total_volume": 1056714561.46,
"volume_24h": 5276090.4,
"status": "open"
},
{
"id": "2026-fifa-world-cup-winner-595",
"title": "2026 FIFA World Cup Winner",
"platform": "polymarket",
"category": "sports",
"market_count": 60,
"total_volume": 672045224.12,
"volume_24h": 11903251.51,
"status": "open"
}
],
"meta": {
"total": 2939,
"page": 1,
"page_size": 2,
"total_pages": 1470
}
}
Step 5 — Search by keyword
Find events and markets matching a search term:
curl "https://app.eventgraph.ai/api/v1/search?q=bitcoin&page_size=2" \
-H "X-API-Key: YOUR_KEY"
{
"data": {
"events": [
{
"id": "what-price-will-bitcoin-hit-before-2027",
"title": "What price will Bitcoin hit in 2026?",
"platform": "polymarket",
"category": "bitcoin",
"market_count": 34,
"total_volume": 31619466.75,
"status": "open"
},
{
"id": "what-price-will-bitcoin-hit-in-april-2026",
"title": "What price will Bitcoin hit in April?",
"platform": "polymarket",
"category": "bitcoin",
"market_count": 20,
"total_volume": 28262608.78,
"status": "open"
}
]
}
}
Next steps
Authentication
API key management, rate limits, and tier details
Platforms
Platform-specific data coverage and notes
Arbitrage (Pro)
Cross-platform price discrepancy scanner
Compare (Pro)
Side-by-side market comparison across platforms
