Skip to main content

Tutorial · API quickstart

Your first GET checks service status.

GET /api/health returns aggregate service and freshness status without sign-in. It does not return market prices or forecasts. Market data through the API works in a signed-in browser session; there are no separate keys for external clients yet.

GET /api/healthPublic statusSign in for data

What comes back

state

Overall state: operational, degraded, or outage.

services

Aggregate state for the workspace, API, market data, and decision support.

dataFreshness

Status of source groups, not prices or hourly observations.

updatedAt

When this public status was assembled.

Sequence

1. Open the route

Public URL: https://alvo.energy/api/health.

2. Make the GET

Run the curl command or the fetch example on an Alvo page.

3. Read the status

Check state and services; an outage may produce HTTP 503.

4. Enter the product

Sign in for market data.

Guardrails

Status only

/api/health returns no prices, forecasts, or tradable signals.

Snippets

curl

Public status needs no session or API key; this is not a market-data request.

curl -i https://alvo.energy/api/health
fetch

Run this JavaScript on an Alvo page, on the same origin.

// Run on an Alvo page in your browser.
const response = await fetch("/api/health", { cache: "no-store" });
const status = await response.json();
console.log(response.status, status.state, status.services);

Need the full contract?

The developer page explains signed-in access, OpenAPI, and the integration boundary.

Read developer docs