Skip to content

Tinkerforge/api.warp-charger.com

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

api.warp-charger.com

Public API server used by WARP Chargers and Energy Managers to obtain day-ahead electricity prices and temperature forecasts.

Live at https://api.warp-charger.com

API Endpoints

Day-Ahead Prices

GET /v1/day_ahead_prices/<country>/<resolution>

Returns day-ahead electricity spot prices sourced from the ENTSO-E Transparency Platform.

Parameter Values Description
country de, lu, at Bidding zone (DE and LU share a zone)
resolution 15min, 60min Price interval granularity

Example:

curl https://api.warp-charger.com/v1/day_ahead_prices/de/15min

Response:

{
  "first_date": 1771455600,
  "prices": [8780, 8330, ...],
  "next_date": 1771590600
}
  • first_date -- UTC unix timestamp of the first price interval
  • prices -- array of integers in centicent/MWh (multiply by 0.00001 for EUR/kWh)
  • next_date -- UTC unix timestamp indicating when fresh data should be available

Temperature Forecast

GET /v1/temperatures/<lat>/<lon>

Returns hourly temperature forecast covering today and tomorrow using the DWD ICON model (via Open-Meteo). Data is aligned to local midnight of the geographic timezone derived from the coordinates.

Parameter Range Description
lat -90 to 90 Latitude (decimal degrees)
lon -180 to 180 Longitude (decimal degrees)

Example:

curl https://api.warp-charger.com/v1/temperatures/51.93/8.63

Response:

{
  "first_date": 1771369200,
  "temperatures": [82, 79, 76, ...]
}
  • first_date -- UTC unix timestamp of local midnight today
  • temperatures -- flat array of 47-49 integers in 10ths of a degree Celsius (e.g. 123 = 12.3 C). Array size varies due to DST transitions: 47 (spring forward), 48 (normal), or 49 (fall back).

Setup

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

An ENTSO-E API key must be placed in entsoe.key (single line, no trailing newline).

Run in development mode:

python main.py

Run in production (behind a reverse proxy):

./start.sh

Tests:

./run_all_tests.sh

Repository Overview

Software

  • esp32-firmware Please report any issues concerning WARP hard- and software here! Source code of the ESP32 firmware shared between all WARP Chargers and Energy Managers
  • tfjson SAX style JSON serializer and deserializer
  • tfmodbustcp Modbus TCP server and client implementation
  • tfocpp OCPP 1.6 implementation
  • tftools Miscellaneous tools and helpers
  • esp32-remote-access Source code of the my.warp-charger.com remote access server
  • warp-charger The source code of (docs.)warp-charger.com and the printed manual, released firmwares, datasheets and documents, as well as some tools and hardware design files
  • api.warp-charger.com Serves APIs that are used by WARP Chargers to obtain relevant public information like day ahead prices
  • vislog.warp-charger.com Visualizes WARP Charger logs and EVSE debug protocols
  • dbus-warp-charger Integrates WARP Chargers into a Victron Energy Venus OS device (e.g. Cerbo GX)

WARP Charger Hardware

  • esp32-brick Hardware design files of the ESP32 Brick
  • evse-bricklet Firmware source code and hardware design files of the EVSE Bricklet
  • rs485-bricklet Firmware source code and hardware design files of the RS485 Bricklet

WARP2 Charger Hardware

  • esp32-ethernet-brick Hardware design files of the ESP32 Ethernet Brick
  • evse-v2-bricklet Firmware source code and hardware design files of the EVSE 2.0 Bricklet
  • nfc-bricklet Firmware source code and hardware design files of the NFC Bricklet

WARP3 Charger Hardware

WARP Energy Manager Hardware

WARP Energy Manager 2.0 Hardware

Forked/patched projects

About

API that can be used by WARP Charger to access public information (e.g. day ahead prices)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors