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