Corrently.io

corrently · Data

Data No Auth Free & Open open_data

*Corrently - from italian corrente, which is energy* # Introduction The Corrently ecosystem gets maintained by [STROMDAO GmbH](https://www.stromdao.de/) to support green energy services for prosumers, grid operators, regulators, integrators or any other party with an emerging need of consensus driven management. As the [energy product Corrently](https://www.corrently.de/) got first launched in Germany parts of this documentation provide simple translations for better understanding. [Released SKD

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Get best hour (with most regional green energy) in a given timeframe.

Simple Wrapper around the GreenPowerIndex for easy integration into almost any SmartHome system that allows access to a JSON/REST Service This endpoint is designed to indicate if a device should be turned on or off. (Switch state).

https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/bestHour?key=YOUR_API_KEY&zip=10001&hours=1&timeframe=1

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/bestHour?key=YOUR_API_KEY&zip=10001&hours=1&timeframe=1"

import requests
params = {
    "key": "YOUR_API_KEY",
    "zip": "10001",
    "hours": "1",
    "timeframe": "1"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/bestHour",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/bestHour');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('zip', '10001');
url.searchParams.set('hours', '1');
url.searchParams.set('timeframe', '1');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/bestHour")
	q := baseURL.Query()
	q.Set("key", "YOUR_API_KEY")
	q.Set("zip", "10001")
	q.Set("hours", "1")
	q.Set("timeframe", "1")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/bestHour")
uri.query = URI.encode_www_form({
  "key" => "YOUR_API_KEY",
  "zip" => "10001",
  "hours" => "1",
  "timeframe" => "1"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/bestHour?" . http_build_query([
    "key" => "YOUR_API_KEY",
    "zip" => "10001",
    "hours" => "1",
    "timeframe" => "1"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Dispatch (Green Energy Distribution Schedule)

Dispatch of green energy has two aspects to consider: - Availability of gerneration facility (depends on weather and installed capacity) - Demand of energy Using the green power index (GrünstromIndex) we have received a tool to automate distribution of energy in order to prevent redispatch situa

https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/dispatch?key=YOUR_API_KEY&zip=10001

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/dispatch?key=YOUR_API_KEY&zip=10001"

import requests
params = {
    "key": "YOUR_API_KEY",
    "zip": "10001"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/dispatch",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/dispatch');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('zip', '10001');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/dispatch")
	q := baseURL.Query()
	q.Set("key", "YOUR_API_KEY")
	q.Set("zip", "10001")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/dispatch")
uri.query = URI.encode_www_form({
  "key" => "YOUR_API_KEY",
  "zip" => "10001"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/dispatch?" . http_build_query([
    "key" => "YOUR_API_KEY",
    "zip" => "10001"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Marketdata

Compatible to awattar (https://api.awattar.de/v1/marketdata) API interface but data comes from GreenPowerIndex instead of EPEXSpot.

https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/marketdata?zip=10001

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/marketdata?zip=10001"

import requests
params = {
    "zip": "10001"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/marketdata",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/marketdata');
url.searchParams.set('zip', '10001');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/marketdata")
	q := baseURL.Query()
	q.Set("zip", "10001")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/marketdata")
uri.query = URI.encode_www_form({
  "zip" => "10001"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/corrently.io/2.0.0/gsi/marketdata?" . http_build_query([
    "zip" => "10001"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Corrently.io?

Corrently.io is a Data API. Developers commonly use data APIs for:

enriching your app with third-party datasets
building data pipelines and ETL workflows
querying and searching large datasets
powering research, analysis, and reporting tools
syncing reference data into your own systems

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Corrently.io is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗