# Energy API

> One REST API for energy commodity prices: natural gas (TTF, Henry Hub), electricity spot (OMIE), crude oil (Brent, WTI), and CO₂ emission allowances (EUA) — normalized from official market sources.

Energy API solves the fragmentation problem for developers who need energy market data. Instead of integrating OMIE, EEX, FRED/EIA, and other market operators separately — each with different formats, update schedules, and nomenclature — this API provides a single endpoint with normalized symbols, consistent JSON responses, and consolidated history.

The product is live at https://energy-api.com. Authentication uses an API key passed as the `api_key` query parameter. Paid plans start at $19.00/month with a 7-day free trial.

## Key pages

- [Homepage](https://energy-api.com): Product overview, pricing, and signup
- [API Documentation](https://energy-api.com/docs): Full endpoint reference with parameters and response examples
- [Blog](https://energy-api.com/blog): Guides and articles on energy market data and API integration
- [Pricing](https://energy-api.com/#pricing): Plan comparison (Starter, Pro, Business)

## Base URL

```
https://energy-api.com/api/v1
```

All requests require `?api_key=YOUR_API_KEY`.

## Authentication

Pass your API key as a query parameter on every request:

```
GET /api/v1/latest?symbols=BRENT_CRUDE,TTF_DA&api_key=YOUR_API_KEY
```

Keys are generated from the user dashboard at https://energy-api.com/dashboard. Keep your API key secret — never expose it in client-side JavaScript or public repositories. If compromised, rotate it immediately from the dashboard.

## Available Symbols

Symbols across 4 categories. Use `GET /symbols` to list all with metadata.

### Natural Gas (`category=gas`)

| Symbol | Name | Currency | Unit |
|--------|------|----------|------|
| TTF_DA | TTF Natural Gas Day-Ahead Price | EUR | €/MWh |
| TTF_FRONT_MONTH | TTF Natural Gas Front-Month Futures | EUR | €/MWh |
| HENRY_HUB | Henry Hub Natural Gas Spot Price | USD | USD/MMBtu |

### Electricity (`category=electricity`)

| Symbol | Name | Currency | Unit |
|--------|------|----------|------|
| OMIE_ES_DA | Spain Day-Ahead Electricity Price | EUR | €/MWh |
| OMIE_PT_DA | Portugal Day-Ahead Electricity Price | EUR | €/MWh |

### Crude Oil (`category=oil`)

| Symbol | Name | Currency | Unit |
|--------|------|----------|------|
| BRENT_CRUDE | Brent Crude Oil Spot Price | USD | USD/barrel |
| WTI_CRUDE | WTI Crude Oil Spot Price | USD | USD/barrel |

### CO₂ Carbon Allowances (`category=carbon`)

| Symbol | Name | Currency | Unit |
|--------|------|----------|------|
| EUA_SPOT | EU Emission Allowances Spot (EUA) | EUR | €/tCO₂ |
| EUA_CO2 | EU Carbon Permits Monthly Average | USD | USD/tCO₂ |

## Endpoints

### GET /api/v1/symbols
List all available symbols with metadata (name, category, currency, frequency, description).

**Parameters:**
- `category` — Filter by category: `gas`, `electricity`, `oil`, `carbon`
- `provider` — Filter by data source: `omie`, `fred`, `eex`
- `api_key` — Required

**Example:**
```
GET /api/v1/symbols?category=gas&api_key=YOUR_API_KEY
```

### GET /api/v1/latest
Get the most recent price for one or more symbols.

**Parameters:**
- `symbols` — Required. Comma-separated symbol list (e.g. `BRENT_CRUDE,TTF_DA`)
- `api_key` — Required

**Example:**
```
GET /api/v1/latest?symbols=BRENT_CRUDE,TTF_DA,EUA_SPOT&api_key=YOUR_API_KEY
```

**Response:**
```json
{
  "success": true,
  "date": "2026-06-09",
  "rates": {
    "BRENT_CRUDE": 71.42,
    "TTF_DA": 34.18,
    "EUA_SPOT": 77.35
  },
  "currencies": {
    "BRENT_CRUDE": "USD",
    "TTF_DA": "EUR",
    "EUA_SPOT": "EUR"
  }
}
```

### GET /api/v1/historical
Get prices for one or more symbols on a specific date.

**Parameters:**
- `date` — Required. Format: `YYYY-MM-DD`
- `symbols` — Required. Comma-separated symbol list
- `api_key` — Required

**Example:**
```
GET /api/v1/historical?date=2022-08-26&symbols=TTF_DA&api_key=YOUR_API_KEY
```

### GET /api/v1/timeseries
Get price history for one or more symbols over a date range.

**Parameters:**
- `start` — Required. Format: `YYYY-MM-DD`
- `end` — Required. Format: `YYYY-MM-DD`
- `symbols` — Required. Comma-separated symbol list
- `api_key` — Required

**Example:**
```
GET /api/v1/timeseries?start=2022-01-01&end=2022-12-31&symbols=TTF_DA,EUA_SPOT&api_key=YOUR_API_KEY
```

### GET /api/v1/fluctuation
Get price change statistics (start value, end value, change, change_pct) for a date range.

**Parameters:**
- `start` — Required. Format: `YYYY-MM-DD`
- `end` — Required. Format: `YYYY-MM-DD`
- `symbols` — Required. Comma-separated symbol list
- `api_key` — Required

**Example:**
```
GET /api/v1/fluctuation?start=2024-01-01&end=2024-12-31&symbols=BRENT_CRUDE,WTI_CRUDE&api_key=YOUR_API_KEY
```

### GET /api/v1/ohlc
Get OHLC (open/high/low/close) aggregation over a date range.

**Parameters:**
- `symbols` — Required. Comma-separated symbol list
- `period` — Aggregation period: `weekly`, `monthly` (default), `quarterly`
- `start` — Optional. Format: `YYYY-MM-DD`
- `end` — Optional. Format: `YYYY-MM-DD`
- `api_key` — Required

**Example:**
```
GET /api/v1/ohlc?symbols=EUA_SPOT&period=monthly&start=2023-01-01&end=2023-12-31&api_key=YOUR_API_KEY
```

## Data Sources

| Provider | Data | Update Frequency |
|----------|------|-----------------|
| OMIE | Spain/Portugal electricity spot | Daily (next-day prices published ~13:00 CET) |
| EEX | TTF gas, EUA CO₂ settlement prices | Daily (end-of-day) |
| FRED/EIA | Henry Hub gas, Brent, WTI crude | Daily |

## Pricing

Plans are metered by API call volume per month.

| Plan | Monthly Calls | Price |
|------|--------------|-------|
| Starter | 1,000 | $19/mo |
| Pro | 10,000 | $49/mo |
| Business | 100,000 | $149/mo |

Enterprise plans (>100,000 requests/month, custom SLA, dedicated support) available on request: hello@energy-api.com

## Contact

- Support: hello@energy-api.com
- Enterprise inquiries: hello@energy-api.com
- Website: https://energy-api.com
- Docs: https://energy-api.com/docs