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.

Which program am I in?

Each challenge targets a resource (an asset or portfolio) that belongs to exactly one program, e.g. Elia or 50Hertz. The program sets which horizons exist, the gate hours, and the reward amounts. Check Programs for your resource's program before planning submissions: the rest of this guide describes mechanics shared by all programs. For the live, upcoming openings of your resource, use the Schedule page in your dashboard (https://predico.inesctec.pt/schedule, login required).

Will my day qualify?

Qualification depends on the horizons your program publishes (see Programs). On programs that publish Intraday, every slot of every timestamp must be filled: typically 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 (gate hours are program-specific). For a D+1-only program (e.g. 50Hertz), submitting your full Q10/Q50/Q90 to the single opened D+1 session is enough to qualify that day. See Evaluation for details.

More resources