Quickstart

Get your first forecast in under 5 minutes.

1. Get your API key

Contact the eomer.ai team to receive a Bearer token. Keys are issued per client and can be rotated at any time without downtime.

2. Watch the API workflow

This 51-second example forecasts the day-ahead electricity price in Germany. It shows API authentication, data input, forecast submission with external covariates, status polling, result download, holdout scoring, and the final forecast plot.

3. Check the API is up

curl https://eomer-api-cgeu.onrender.com/health

Expected response:

{
  "status": "ok",
  "version": "0.1.0",
  "timestamp": "2026-01-01T00:00:00+00:00",
  "checks": {
    "upload_dir": "ok",
    "output_dir": "ok"
  }
}

4. Submit a forecast job

Prepare a CSV file with at minimum three columns:

Column	Description
item_id	Series identifier (e.g. store_A)
timestamp	ISO-8601 datetime or date string
target	Numeric value to forecast

curl -X POST https://eomer-api-cgeu.onrender.com/forecast \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@data.csv" \
  -F "prediction_length=24" \
  -F "presets=eomer_pulse_nano"

The API returns immediately with a job ID and status pending:

{
  "job_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "status": "pending",
  "prediction_length": 24
}

5. Poll for completion

curl https://eomer-api-cgeu.onrender.com/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "Authorization: Bearer YOUR_API_KEY"

When status is completed, a download_url appears in the response.

6. Download the forecast

curl https://eomer-api-cgeu.onrender.com/jobs/3fa85f64-5717-4562-b3fc-2c963f66afa6/download \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o forecast.csv

The output CSV contains one row per (item_id, future_timestamp) pair with columns mean, 0.1, 0.5, 0.9 (10th, 50th, 90th quantile forecasts).

---

Available model presets

Retrieve the full list at any time:

curl https://eomer-api-cgeu.onrender.com/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Preset	Size	Best for
eomer_pulse_nano	Smallest	Fast prototyping, CI
eomer_pulse_mini	Small	Balanced speed and accuracy
eomer_pulse	Medium	Production workloads
eomer_horizon_core	Large	Complex workloads
eomer_horizon	Largest	High-capacity workloads
eomer_horizon_max	Ensemble	Maximum forecast quality

All presets are zero-shot - no training data required.