Skip to content

Getting Started

You've read the Introduction, picked the challenge types you want to tackle, and had your Forecaster Application accepted — you're ready to ship your first forecast. This page is the API-side checklist from that point on.

Rulebook

The Participation Rulebook remains the authoritative reference for rules and payment conditions.

Pick your environment

Environment URL Purpose
Playground https://playground.predico.inesctec.pt/ Integrate & test safely.
Production https://predico.inesctec.pt/ Live, scored submissions.

Both environments expose the same API — change the host in your client to switch.

First-submission checklist

Work through the API Guides section in order:

Step What it does
1. Authenticate Exchange your credentials for a JWT. Access token TTL is 1 h; cache the refresh token.
2. List open sessions and their challenges Pick the challenge you want to target and note its gate_closure.
3. Download raw measurements Pull enough history to train/validate your model.
4. Prepare your forecast Train your models and create your forecasts.
5. Submit your forecast Submit Q10, Q50, and Q90 before gate_closure. All three quantiles are required; they must satisfy Q10 ≤ Q50 ≤ Q90.
6. Review your scores Check results after the evaluation phase — or use the web dashboard.

Prefer a rolling forecast over per-session submissions? Skip steps 2–4 and use the continuous-forecast flow instead.

Will my day qualify?

Submitting at one gate closure is rarely enough on its own. To qualify for Intraday, every slot of every timestamp must be filled — typically you need a cadence of intraday submissions plus a D+1 (or D+N) commitment for the same target day. For D+1 / D+N, you must submit your full Q10/Q50/Q90 to every opened session of that target day (D+1 opens at 10:00 CET/CEST). See Evaluation for details.

More resources