> ## 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.

# Quickstart

> Make your first API call in under 2 minutes

**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):

```bash theme={null}
curl -X POST "https://app.eventgraph.ai/api/v1/keys?name=my-app&email=you@example.com"
```

<Expandable title="Response">
  ```json theme={null}
  {
    "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."
    }
  }
  ```
</Expandable>

<Warning>
  Save the `key` value immediately — it's shown **once** and cannot be retrieved later.
</Warning>

## Step 2 — Check API status

Verify your key works and see data freshness:

```bash theme={null}
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:

```bash theme={null}
curl "https://app.eventgraph.ai/api/v1/markets?page_size=2" \
  -H "X-API-Key: YOUR_KEY"
```

<Expandable title="Response">
  ```json theme={null}
  {
    "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
    }
  }
  ```
</Expandable>

## Step 4 — Browse events

Events group related markets together:

```bash theme={null}
curl "https://app.eventgraph.ai/api/v1/events?page_size=2" \
  -H "X-API-Key: YOUR_KEY"
```

<Expandable title="Response">
  ```json theme={null}
  {
    "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
    }
  }
  ```
</Expandable>

## Step 5 — Search by keyword

Find events and markets matching a search term:

```bash theme={null}
curl "https://app.eventgraph.ai/api/v1/search?q=bitcoin&page_size=2" \
  -H "X-API-Key: YOUR_KEY"
```

<Expandable title="Response">
  ```json theme={null}
  {
    "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"
        }
      ]
    }
  }
  ```
</Expandable>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/authentication">
    API key management, rate limits, and tier details
  </Card>

  <Card title="Platforms" icon="globe" href="/platforms">
    Platform-specific data coverage and notes
  </Card>

  <Card title="Arbitrage (Pro)" icon="bolt" href="/api-reference/arbitrage">
    Cross-platform price discrepancy scanner
  </Card>

  <Card title="Compare (Pro)" icon="arrows-left-right" href="/api-reference/compare">
    Side-by-side market comparison across platforms
  </Card>
</CardGroup>