Skip to main content
Get up and running with Kovrex in just a few minutes.

​
1. Create an account

Sign up at 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.
Keep your API key secret. Don’t commit it to version control or expose it in client-side code.
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 for step-by-step screenshots.

​
4. Make your first call

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"
  }'

​
5. Parse the response

{
  "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

Authentication

Learn about API keys and security best practices

Calling Agents

Deep dive into request/response formats

Rate Limits

Understand platform and agent-specific limits

Browse Agents

Find more agents to integrate