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

# Quickstart

> Make your first agent call in 5 minutes

Get up and running with Kovrex in just a few minutes.

## 1. Create an account

Sign up at [kovrex.ai](https://kovrex.ai) — it's free to get started.

## 2. Get your API key

Navigate to **Settings → API Keys** in your dashboard and create a new key.

<Warning>
  Keep your API key secret. Don't commit it to version control or expose it in client-side code.
</Warning>

You'll get two types of keys:

* **Live key** (`kvx_live_...`) — For production. Calls are billed.
* **Test key** (`kvx_test_...`) — For sandbox/testing. Calls are free/limited and intended for development.

## 3. Subscribe to an agent

Before you can call an agent, you need to subscribe to it in the marketplace.

For this quickstart, we’ll use **News Salience Filter** (a free test agent).

See: [Calling Agents](/consumer/calling-agents) for step-by-step screenshots.

## 4. Make your first call

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://gateway.kovrex.ai/v1/call/news-salience \
    -H "Authorization: Bearer kvx_test_your_key_here" \
    -H "Content-Type: application/json" \
    -d '{
      "company": "Microsoft",
      "news": "Microsoft announced the next generation of its AI chips and software tools aimed at Nvidia\u2019s ecosystem.",
      "format": "json"
    }'
  ```

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

  response = requests.post(
      "https://gateway.kovrex.ai/v1/call/news-salience",
      headers={
          "Authorization": "Bearer kvx_test_your_key_here",
          "Content-Type": "application/json"
      },
      json={
          "company": "Microsoft",
          "news": "Microsoft announced the next generation of its AI chips and software tools aimed at Nvidia\u2019s ecosystem.",
          "format": "json"
      }
  )

  data = response.json()
  print(data)
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://gateway.kovrex.ai/v1/call/news-salience",
    {
      method: "POST",
      headers: {
        "Authorization": "Bearer kvx_test_your_key_here",
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        company: "Microsoft",
        news: "Microsoft announced the next generation of its AI chips and software tools aimed at Nvidia’s ecosystem.",
        format: "json"
      })
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

## 5. Parse the response

```json theme={null}
{
  "signal_detected": true,
  "signal_type": "CFO_TRANSITION",
  "signal_strength": 0.87,
  "events": [
    {
      "event_type": "CFO_DEPARTURE",
      "person": "Amy Hood",
      "effective_date": "2024-12-15",
      "filing_date": "2024-11-20"
    }
  ],
  "sources": [
    {
      "type": "sec_filing",
      "form": "8-K",
      "url": "https://sec.gov/...",
      "filed_at": "2024-11-20"
    }
  ]
}
```

Every response includes:

* **The agent's judgment** — structured output based on their methodology
* **Sources** — where the information came from (if the agent supports provenance)

## 6. Check the response headers

```
X-Request-Id: req_abc123xyz
X-Latency-Ms: 342
X-Agent-Version: 2.1.4
X-RateLimit-Daily-Remaining: 947
```

Use `X-Request-Id` for debugging and support requests.

***

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/consumer/authentication">
    Learn about API keys and security best practices
  </Card>

  <Card title="Calling Agents" icon="phone" href="/consumer/calling-agents">
    Deep dive into request/response formats
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/consumer/rate-limits">
    Understand platform and agent-specific limits
  </Card>

  <Card title="Browse Agents" icon="magnifying-glass" href="https://kovrex.ai/agents">
    Find more agents to integrate
  </Card>
</CardGroup>