alvo-api-quickstart, the stable payload marker.
Tutorial · API quickstart
One GET that returns data, not an empty documentation tour.
The quickstart endpoint reads the live market price layer through the API and returns a compact payload: request, endpoint links, source/freshness and the latest trading day with hourly sample.
GET /api/quickstartDAM/IDM1-24 sample hours
Tutorial · API quickstart
What comes back
month, market, zone and number of sample hours.
Links to /api/quickstart and /api/market/prices for the same request.
source, freshness, unit, days and latestDay.sampleHours.
Sequence
1. Choose the base
Production proxy: https://alvo.energy/api. Locally, the Nest API runs on http://localhost:3004.
2. Make the GET
market=DAM, zone=IPS and hours=6 give a compact payload for the first check.
3. Check freshness
Do not build a decision when freshness says stale/unavailable or latestDay is empty.
4. Expand the request
After quickstart, move to /api/market/prices for the full monthly book.
Guardrails
No-store
Quickstart replies with Cache-Control: no-store so integrations see the current state.
Read access
The endpoint has a read access guard; production may require an API key or Bearer token.
Market honesty
The payload exposes source/freshness; do not label stale data as live.
Tutorial · API quickstart
Snippets
curl
Protected tenants add x-alvo-api-key; the open demo may answer without a key.
ALVO_API_URL="https://alvo.energy/api" curl -s "$ALVO_API_URL/quickstart?market=DAM&zone=IPS&hours=6" \ -H "x-alvo-api-key: $ALVO_API_KEY"
fetch
Minimal server-side JavaScript example with no caching.
const base = "https://alvo.energy/api";
const params = new URLSearchParams({
market: "DAM",
zone: "IPS",
hours: "6"
});
const response = await fetch(`${base}/quickstart?${params}`, {
headers: { "x-alvo-api-key": process.env.ALVO_API_KEY ?? "" },
cache: "no-store"
});
console.log(await response.json());Need the full contract?
OpenAPI describes the rest of the REST surface: prices, forecast, risk, audit and deterministic AI brief.