> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coinversa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Get an API key and your first response in 5 minutes.

## 1. Get an API key

<Steps>
  <Step title="Sign in">
    Go to [developers.coinversa.ai](https://developers.coinversa.ai) and sign in (Privy — email, wallet, or social).
  </Step>

  <Step title="Create a key">
    Open **Keys** in the portal sidebar and click **Create key**. Give it a name (e.g. "local-dev"). Copy the key now — it's shown once.
  </Step>

  <Step title="Pick a tier">
    All accounts start on **Free** (30 req/min, 1,000 req/day). Upgrade later in **Billing** if you need higher limits — see [pricing](/pricing).
  </Step>
</Steps>

## 2. Make your first request

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.coinversa.ai/api/public/v1/pulse/stats \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import httpx

  r = httpx.get(
      "https://api.coinversa.ai/api/public/v1/pulse/stats",
      headers={"X-API-Key": "YOUR_API_KEY"},
  )
  print(r.json())
  ```

  ```javascript Node theme={null}
  const res = await fetch("https://api.coinversa.ai/api/public/v1/pulse/stats", {
    headers: { "X-API-Key": process.env.COINVERSAA_API_KEY },
  });
  console.log(await res.json());
  ```

  ```go Go theme={null}
  req, _ := http.NewRequest("GET", "https://api.coinversa.ai/api/public/v1/pulse/stats", nil)
  req.Header.Set("X-API-Key", os.Getenv("COINVERSAA_API_KEY"))
  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()
  io.Copy(os.Stdout, resp.Body)
  ```
</CodeGroup>

You should see global market stats (total traders, total volume, data coverage period). If you get a 401, your key is wrong or inactive. If you get a 429, check the rate-limit headers — see [authentication](/authentication#rate-limit-headers).

## 3. (Optional) Wire it into your AI agent

If you're building an AI agent rather than calling the API directly, the MCP server gives Claude, Cursor, and Perplexity tool access using the same key — no HTTP code on your side. Building an app, dashboard, or script instead? You're done after step 2; skip to [What's next](#whats-next). Not sure which fits? See [Choose your path](/#choose-your-path).

Pick your client:

<Columns cols={2}>
  <Card title="Claude.ai (web)" icon="globe" href="/mcp/setup#claude-ai">
    Custom connector — paste URL + key.
  </Card>

  <Card title="Claude Desktop" icon="desktop" href="/mcp/setup#claude-desktop">
    Edit `claude_desktop_config.json`.
  </Card>

  <Card title="Cursor" icon="code" href="/mcp/setup#cursor">
    One-click deeplink install.
  </Card>

  <Card title="Perplexity" icon="magnifying-glass" href="/mcp/setup#perplexity">
    Custom connector — URL + header.
  </Card>
</Columns>

## What's next

* Browse the [API reference](/api-reference) — every endpoint has a "Try it" panel.
* Read [concepts](/concepts/markets) to understand symbol formats, cohort tiers, and the cross-market asset model.
* See [authentication](/authentication) for rate-limit behavior, tier gates, and error shapes.