Authentication

All API requests require an API key. Free accounts get 50 requests per day. Paid plans unlock Monte Carlo analysis, saved calculations, and higher rate limits.

Getting an API Key

Create a free account to get your API key:

curl -X POST https://elovane-api.smarttechinvest.com/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"name": "Your Name", "email": "you@example.com", "password": "min8chars"}'

The response includes your API key. Save it immediately -- it will not be shown again.

{
  "data": {
    "message": "Account created",
    "apiKeyPrefix": "elv_live...",
    "apiKey": "elv_live_a1b2c3d4e5f6..."
  },
  "meta": { "timestamp": "2026-03-19T00:00:00Z" }
}

Using Your API Key

Pass your API key in the X-API-Key header:

curl -X POST https://elovane-api.smarttechinvest.com/v1/calculate \
  -H "X-API-Key: elv_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"annualProductionPerKW":1400,"annualConsumptionKWh":10000,"utilityRate":0.15}'

Node.js

const response = await fetch(
  'https://elovane-api.smarttechinvest.com/v1/calculate',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': process.env.ELOVANE_API_KEY,
    },
    body: JSON.stringify({
      annualProductionPerKW: 1400,
      annualConsumptionKWh: 10000,
      utilityRate: 0.15,
    }),
  }
);
const data = await response.json();

Python

import requests
import os

response = requests.post(
    "https://elovane-api.smarttechinvest.com/v1/calculate",
    headers={"X-API-Key": os.environ["ELOVANE_API_KEY"]},
    json={
        "annualProductionPerKW": 1400,
        "annualConsumptionKWh": 10000,
        "utilityRate": 0.15,
    }
)
data = response.json()

Rate Limits

Rate limits vary by plan. Every response includes rate limit headers:

Header	Description
X-RateLimit-Limit	Maximum requests in the current window
X-RateLimit-Remaining	Requests remaining in the current window
X-RateLimit-Reset	UTC timestamp when the window resets

Limits by Plan

Plan	Daily Limit	Monthly Limit
Free	50	1,500
Pro	500	15,000
Developer	1,000	30,000
API Starter	1,000	30,000
API Business	10,000	300,000

Key Management

You can manage your API keys from the API Keys dashboard or via the API:

List Keys

curl https://elovane-api.smarttechinvest.com/v1/account/keys \
  -H "X-API-Key: elv_live_your_key"

Rotate Key

curl -X POST https://elovane-api.smarttechinvest.com/v1/account/keys/rotate \
  -H "X-API-Key: elv_live_your_key"

Rotation revokes your old key and issues a new one. Update your integrations immediately.

Delete Key

curl -X DELETE https://elovane-api.smarttechinvest.com/v1/account/keys/:id \
  -H "X-API-Key: elv_live_your_key"

Security Best Practices

•Never expose your API key in client-side code or public repositories.
•Use environment variables (ELOVANE_API_KEY) to store keys.
•Rotate your key immediately if you suspect it has been compromised.
•Use separate API keys for development and production environments.
•Monitor rate limit headers (X-RateLimit-Remaining) to avoid hitting limits unexpectedly.