API Key Authentication

All requests to the elvah Market Data API require authentication using API keys. API keys identify your organization and track usage for billing and rate limiting purposes.

Header Configuration

Include your API key in every request using the x-api-key header:

POST /api/v1/market-data HTTP/1.1
Host: market-data.elvah.de
Content-Type: application/json
x-api-key: your-api-key-here

Obtaining API Keys

Production Access: Contact our partnerships team to request API credentials:

Demo Access: Demo API keys will be available for evaluation purposes with limited data access (maximum 3 sites per request).

Demo responses will include additional headers to indicate limited access:

X-Demo-Account: true
X-Demo-Limit: 3

Note: Demo account system is currently in development.


Rate Limiting

To ensure system stability and fair usage, all API requests are subject to rate limiting.

Current Limits

Request Rate: 240 requests per minute per API key

Rate Limit Headers

Rate limit information is included in response headers:

HTTP/1.1 200 OK
X-RateLimit-Limit: 240
X-RateLimit-Remaining: 239
X-RateLimit-Reset: 1640995200