Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.eventgraph.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Get your API key

Generate a free API key instantly — no signup required: 
curl -X POST "https://app.eventgraph.ai/api/v1/keys?name=my-app&email=you@example.com"
Response: 
{
  "data": {
    "key": "eg_live_a1b2c3d4e5f6...",
    "key_prefix": "eg_live_a1b2...",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "my-app",
    "email": "you@example.com",
    "tier": "free",
    "daily_limit": 1000,
    "monthly_limit": 10000
  },
  "meta": {
    "warning": "Store this key securely. It will not be shown again."
  },
  "timestamp": "2025-01-15T12:00:00Z"
}
Your API key is shown once in the response. We only store a hash — the key cannot be retrieved later. Save it immediately.

​
Using your key

Pass the key in the X-API-Key header: 
curl "https://app.eventgraph.ai/api/v1/markets?page_size=5" \
  -H "X-API-Key: eg_live_a1b2c3d4e5f6..."
Or as a query parameter (not recommended for production): 
curl "https://app.eventgraph.ai/api/v1/markets?api_key=eg_live_a1b2c3d4e5f6..."

​
API endpoints

​
Free tier

MethodEndpointDescription
POST/api/v1/keysGenerate a new API key
GET/api/v1/statusAPI health and data freshness
GET/api/v1/marketsList markets across all platforms
GET/api/v1/eventsList events with filtering
GET/api/v1/searchSearch events and markets by title

​
Pro tier ($49/mo)

Everything in Free, plus:
MethodEndpointDescription
GET/api/v1/arbitrageCross-platform spread opportunities
GET/api/v1/compareSide-by-side market comparison
GET/api/v1/markets/{id}/historyHistorical price data
GET/api/v1/usageYour API usage stats

​
Enterprise (custom)

All endpoints, unlimited rate limits, dedicated support.

​
Rate limits

PlanRequests / dayRequests / monthRate / minute
Free ($0)1,00010,00030
Pro ($49/mo)50,000500,000300
Enterprise (custom)UnlimitedUnlimited1,000
When you exceed limits, the API returns 429 Too Many Requests: 
{
  "error": "daily_limit_exceeded",
  "message": "Daily limit of 1,000 requests reached. Resets at midnight UTC.",
  "limit": 1000,
  "used": 1000,
  "tier": "free",
  "upgrade_url": "https://eventgraph.ai/pricing"
}

​
Key management

​
List your keys

curl "https://app.eventgraph.ai/api/v1/keys" \
  -H "X-API-Key: eg_live_a1b2c3d4e5f6..."

​
Revoke a key

curl -X DELETE "https://app.eventgraph.ai/api/v1/keys/{key_id}" \
  -H "X-API-Key: eg_live_a1b2c3d4e5f6..."

​
Plans

Free

  • 1,000 requests / day
  • 10,000 requests / month
  • Markets, events, search, status
  • All platforms: Polymarket, Kalshi, Limitless, Opinion
  • Community support

Pro — $49/mo

  • 50,000 requests / day
  • 500,000 requests / month
  • Arbitrage detection + comparison
  • Historical price data
  • Usage analytics
  • Priority support (24h SLA)

Enterprise — Custom

  • Unlimited requests
  • All endpoints
  • Custom rate limits
  • Dedicated support
  • SLA guarantee

​
Upgrade to Pro

Upgrade via App — $49/mo

Open the pricing page and click Upgrade to Pro. Enter your email or existing API key — you’ll be redirected to Stripe checkout instantly.

Upgrade via API

Already have a key? Call POST /api/v1/checkout with your key in the header to get a Stripe checkout URL back.

​
Programmatic upgrade

curl -X POST "https://app.eventgraph.ai/api/v1/checkout" \
  -H "X-API-Key: eg_live_your_free_key"
Response: 
{
  "checkout_url": "https://checkout.stripe.com/pay/cs_live_...",
  "session_id": "cs_live_..."
}
Open checkout_url in a browser to complete payment. Your API key is automatically upgraded to Pro after the Stripe session completes — no key rotation needed.