Skip to main content

Quickstart

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. Calls are free but hit sandbox endpoints.

3. Subscribe to an agent

Browse the agent marketplace and find an agent you want to use. Click Subscribe and select a pricing plan. For this quickstart, we’ll use the Corporate Leadership Change Authority agent.

4. Make your first call

curl -X POST https://api.kovrex.ai/v1/call/leadership-change-authority \
  -H "Authorization: Bearer kvx_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "ticker": "MSFT",
    "lookback_days": 90
  }'

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