hass.tibber_prices/docs/user/versioned_docs/version-v0.25.0b0/glossary.md

comments
false

Glossary

Quick reference for terms used throughout the documentation.

A

API Token

Your personal access key from Tibber. Get it at developer.tibber.com.

Attributes

Additional data attached to each sensor (timestamps, statistics, metadata). Access via state_attr() in templates.

B

Best Price Period

Automatically detected time window with favorable electricity prices. Ideal for scheduling dishwashers, heat pumps, EV charging.

Binary Sensor

Sensor with ON/OFF state (e.g., "Best Price Period Active"). Used in automations as triggers.

C

Currency Display Mode

Configurable setting for how prices are shown. Choose base currency (€, kr) or subunit (ct, øre). Smart defaults apply: EUR → subunit, NOK/SEK/DKK → base.

Coordinator

Home Assistant component managing data fetching and updates. Polls Tibber API every 15 minutes.

D

Dynamic Icons

Icons that change based on sensor state (e.g., battery icons showing price level). See Dynamic Icons.

F

Flex (Flexibility)

Configuration parameter controlling how strict period detection is. Higher flex = more periods found, but potentially at higher prices.

I

Interval

15-minute time slot with fixed electricity price (00:00-00:15, 00:15-00:30, etc.).

L

Level

Price classification within a day (LOWEST, LOW, NORMAL, HIGH, HIGHEST). Based on daily min/max prices.

M

Min Distance

Threshold requiring periods to be at least X% below daily average. Prevents detecting "cheap" periods during expensive days.

P

Peak Price Period

Time window with highest electricity prices. Use to avoid heavy consumption.

Price Info

Complete dataset with all intervals (yesterday, today, tomorrow) including enriched statistics.

Q

Quarter-Hourly

15-minute precision (4 intervals per hour, 96 per day).

R

Rating

Statistical price classification (VERY_CHEAP, CHEAP, NORMAL, EXPENSIVE, VERY_EXPENSIVE). Based on 24h averages and thresholds.

Relaxation

Automatic loosening of period detection filters when target period count isn't met. Ensures you always get usable periods.

S

State

Current value of a sensor (e.g., price in ct/kWh, "ON"/"OFF" for binary sensors).

State Class

Home Assistant classification for long-term statistics (MEASUREMENT, TOTAL, or none).

T

Trailing Average

Average price over the past 24 hours from current interval.

Leading Average

Average price over the next 24 hours from current interval.

V

Volatility

Measure of price stability (LOW, MEDIUM, HIGH). High volatility = large price swings = good for timing optimization.

---

💡 See Also:

• Core Concepts - In-depth explanations
• Sensors - How sensors use these concepts
• Period Calculation - Deep dive into period detection