All API requests require authentication. Pass your API key as a Bearer token in the Authorization header.
Bearer token
Authorization: Bearer rk_free_your_key_here
curl https://api.rekko.ai/v1/markets \
-H "Authorization: Bearer rk_free_your_key_here"
Key prefixes
| Prefix | Plan |
|---|
rk_free_ | Free tier |
rk_pro_ | Pro subscription |
Getting a key
Sign up at the dashboard or via the API:
curl -X POST https://api.rekko.ai/v1/customers/signup \
-H "Content-Type: application/json" \
-d '{"email": "you@example.com", "name": "Your Name"}'
Your API key is shown only once in the signup response. Store it securely.
Key rotation
Rotate your key from the dashboard. The old key is revoked immediately.
Error responses
| Status | Meaning |
|---|
401 Unauthorized | Missing or invalid API key |
403 Forbidden | Valid key but insufficient tier for this endpoint |
429 Too Many Requests | Rate limit or monthly quota exceeded |
{
"detail": "Invalid or expired API key"
}
Alternative auth methods
RapidAPI
If you subscribe via RapidAPI, use RapidAPI’s standard headers instead of a Bearer token. Rekko validates the x-rapidapi-proxy-secret automatically.
x402 Micropayments
For crypto-native agents, you can pay per-request with USDC on Base L2. See x402 payments. 
