Stake pool history
curl --request GET \
--url https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history \
--header 'api-key: <api-key>'import requests
url = "https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history"
headers = {"api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'api-key': '<api-key>'}};
fetch('https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history")
.header("api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"epoch_no": 6,
"active_stake": 100000000000000,
"active_stake_pct": "33.33333333333333333300",
"saturation_pct": null,
"block_cnt": 7243,
"delegator_cnt": 1,
"margin": 1,
"fixed_cost": 500000000,
"pool_fees": 0,
"deleg_rewards": 0,
"epoch_ros": "0"
},
{
"epoch_no": 7,
"active_stake": 100000000000000,
"active_stake_pct": "33.33333333333333333300",
"saturation_pct": null,
"block_cnt": 7213,
"delegator_cnt": 1,
"margin": 1,
"fixed_cost": 500000000,
"pool_fees": 0,
"deleg_rewards": 0,
"epoch_ros": "0"
},
{
"epoch_no": 8,
"active_stake": 100000000000000,
"active_stake_pct": "33.33333333333333333300",
"saturation_pct": null,
"block_cnt": 7102,
"delegator_cnt": 1,
"margin": 1,
"fixed_cost": 500000000,
"pool_fees": 0,
"deleg_rewards": 0,
"epoch_ros": "0"
}
],
"last_updated": {
"timestamp": "2022-10-10 20:25:28",
"block_hash": "c8814a8d064e18b46ffbde6add240203df27533c3ca1fb91c8031b88029ec979",
"block_slot": 32288058
},
"next_cursor": null
}Pools
Stake pool history
Get historical performance data for a Cardano stake pool including rewards, blocks, and delegation metrics.
GET
/
pools
/
{pool_id}
/
history
Stake pool history
curl --request GET \
--url https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history \
--header 'api-key: <api-key>'import requests
url = "https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history"
headers = {"api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'api-key': '<api-key>'}};
fetch('https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history")
.header("api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://mainnet.gomaestro-api.org/v1/pools/{pool_id}/history")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"epoch_no": 6,
"active_stake": 100000000000000,
"active_stake_pct": "33.33333333333333333300",
"saturation_pct": null,
"block_cnt": 7243,
"delegator_cnt": 1,
"margin": 1,
"fixed_cost": 500000000,
"pool_fees": 0,
"deleg_rewards": 0,
"epoch_ros": "0"
},
{
"epoch_no": 7,
"active_stake": 100000000000000,
"active_stake_pct": "33.33333333333333333300",
"saturation_pct": null,
"block_cnt": 7213,
"delegator_cnt": 1,
"margin": 1,
"fixed_cost": 500000000,
"pool_fees": 0,
"deleg_rewards": 0,
"epoch_ros": "0"
},
{
"epoch_no": 8,
"active_stake": 100000000000000,
"active_stake_pct": "33.33333333333333333300",
"saturation_pct": null,
"block_cnt": 7102,
"delegator_cnt": 1,
"margin": 1,
"fixed_cost": 500000000,
"pool_fees": 0,
"deleg_rewards": 0,
"epoch_ros": "0"
}
],
"last_updated": {
"timestamp": "2022-10-10 20:25:28",
"block_hash": "c8814a8d064e18b46ffbde6add240203df27533c3ca1fb91c8031b88029ec979",
"block_slot": 32288058
},
"next_cursor": null
}Authorizations
Project API Key
Headers
Large numbers returned as strings if set to true
Path Parameters
Pool ID in bech32 format
Query Parameters
Epoch number to fetch results for
Required range:
x >= 0The max number of results per page
Required range:
x >= 0The order in which the results are sorted (by epoch number)
Available options:
asc, desc Pagination cursor string, use the cursor included in a page of results to fetch the next page
Response
An array of pool history information for each epoch (or containing one entry for a given epoch_no)
A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.
Was this page helpful?

