curl --request GET \
--url https://nexus.gerowallet.io/api/pools \
--header 'X-Api-Key: <api-key>'import requests
url = "https://nexus.gerowallet.io/api/pools"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://nexus.gerowallet.io/api/pools', 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://nexus.gerowallet.io/api/pools",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-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://nexus.gerowallet.io/api/pools"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-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://nexus.gerowallet.io/api/pools")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://nexus.gerowallet.io/api/pools")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body""[
{
"poolIdBech32": "<string>",
"poolIdHex": "<string>",
"poolStatus": "<string>",
"activeEpochNo": 123,
"retiringEpoch": 123,
"marginPct": 123,
"fixedCost": 123,
"pledgeDeclared": 123,
"deposit": 123,
"rewardAddr": "<string>",
"owners": [
"<string>"
],
"relays": [
{
"ipv4": "<string>",
"ipv6": "<string>",
"dns": "<string>",
"port": 123
}
],
"metaUrl": "<string>",
"metaHash": "<string>",
"metaJson": "<unknown>",
"vrfKeyHash": "<string>",
"opCertCounter": 123,
"blockCount": 123,
"blocksMinted": 123,
"activeStake": 123,
"liveStake": 123,
"livePledge": 123,
"sigma": 123,
"liveSaturationPct": 123,
"liveStakePct": 123,
"liveDelegators": 123,
"ticker": "<string>",
"poolGroup": "<string>",
"name": "<string>",
"homepage": "<string>",
"description": "<string>",
"ros": 123,
"extendedMetadata": "<unknown>"
}
][
{
"poolIdBech32": "<string>",
"poolIdHex": "<string>",
"poolStatus": "<string>",
"activeEpochNo": 123,
"retiringEpoch": 123,
"marginPct": 123,
"fixedCost": 123,
"pledgeDeclared": 123,
"deposit": 123,
"rewardAddr": "<string>",
"owners": [
"<string>"
],
"relays": [
{
"ipv4": "<string>",
"ipv6": "<string>",
"dns": "<string>",
"port": 123
}
],
"metaUrl": "<string>",
"metaHash": "<string>",
"metaJson": "<unknown>",
"vrfKeyHash": "<string>",
"opCertCounter": 123,
"blockCount": 123,
"blocksMinted": 123,
"activeStake": 123,
"liveStake": 123,
"livePledge": 123,
"sigma": 123,
"liveSaturationPct": 123,
"liveStakePct": 123,
"liveDelegators": 123,
"ticker": "<string>",
"poolGroup": "<string>",
"name": "<string>",
"homepage": "<string>",
"description": "<string>",
"ros": 123,
"extendedMetadata": "<unknown>"
}
][
{
"poolIdBech32": "<string>",
"poolIdHex": "<string>",
"poolStatus": "<string>",
"activeEpochNo": 123,
"retiringEpoch": 123,
"marginPct": 123,
"fixedCost": 123,
"pledgeDeclared": 123,
"deposit": 123,
"rewardAddr": "<string>",
"owners": [
"<string>"
],
"relays": [
{
"ipv4": "<string>",
"ipv6": "<string>",
"dns": "<string>",
"port": 123
}
],
"metaUrl": "<string>",
"metaHash": "<string>",
"metaJson": "<unknown>",
"vrfKeyHash": "<string>",
"opCertCounter": 123,
"blockCount": 123,
"blocksMinted": 123,
"activeStake": 123,
"liveStake": 123,
"livePledge": 123,
"sigma": 123,
"liveSaturationPct": 123,
"liveStakePct": 123,
"liveDelegators": 123,
"ticker": "<string>",
"poolGroup": "<string>",
"name": "<string>",
"homepage": "<string>",
"description": "<string>",
"ros": 123,
"extendedMetadata": "<unknown>"
}
][
{
"poolIdBech32": "<string>",
"poolIdHex": "<string>",
"poolStatus": "<string>",
"activeEpochNo": 123,
"retiringEpoch": 123,
"marginPct": 123,
"fixedCost": 123,
"pledgeDeclared": 123,
"deposit": 123,
"rewardAddr": "<string>",
"owners": [
"<string>"
],
"relays": [
{
"ipv4": "<string>",
"ipv6": "<string>",
"dns": "<string>",
"port": 123
}
],
"metaUrl": "<string>",
"metaHash": "<string>",
"metaJson": "<unknown>",
"vrfKeyHash": "<string>",
"opCertCounter": 123,
"blockCount": 123,
"blocksMinted": 123,
"activeStake": 123,
"liveStake": 123,
"livePledge": 123,
"sigma": 123,
"liveSaturationPct": 123,
"liveStakePct": 123,
"liveDelegators": 123,
"ticker": "<string>",
"poolGroup": "<string>",
"name": "<string>",
"homepage": "<string>",
"description": "<string>",
"ros": 123,
"extendedMetadata": "<unknown>"
}
]List and search Cardano stake pools
Retrieves brief information for registered stake pools on the Cardano network. Omit page and pageSize to receive the complete set in one response. Supplying either one pages the result: page defaults to 1 and pageSize defaults to 100. search filters by ticker, name or bech32 pool id; sort orders by ros (default), ticker or liveStake, descending with nulls last.
curl --request GET \
--url https://nexus.gerowallet.io/api/pools \
--header 'X-Api-Key: <api-key>'import requests
url = "https://nexus.gerowallet.io/api/pools"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://nexus.gerowallet.io/api/pools', 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://nexus.gerowallet.io/api/pools",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-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://nexus.gerowallet.io/api/pools"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-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://nexus.gerowallet.io/api/pools")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://nexus.gerowallet.io/api/pools")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body""[
{
"poolIdBech32": "<string>",
"poolIdHex": "<string>",
"poolStatus": "<string>",
"activeEpochNo": 123,
"retiringEpoch": 123,
"marginPct": 123,
"fixedCost": 123,
"pledgeDeclared": 123,
"deposit": 123,
"rewardAddr": "<string>",
"owners": [
"<string>"
],
"relays": [
{
"ipv4": "<string>",
"ipv6": "<string>",
"dns": "<string>",
"port": 123
}
],
"metaUrl": "<string>",
"metaHash": "<string>",
"metaJson": "<unknown>",
"vrfKeyHash": "<string>",
"opCertCounter": 123,
"blockCount": 123,
"blocksMinted": 123,
"activeStake": 123,
"liveStake": 123,
"livePledge": 123,
"sigma": 123,
"liveSaturationPct": 123,
"liveStakePct": 123,
"liveDelegators": 123,
"ticker": "<string>",
"poolGroup": "<string>",
"name": "<string>",
"homepage": "<string>",
"description": "<string>",
"ros": 123,
"extendedMetadata": "<unknown>"
}
][
{
"poolIdBech32": "<string>",
"poolIdHex": "<string>",
"poolStatus": "<string>",
"activeEpochNo": 123,
"retiringEpoch": 123,
"marginPct": 123,
"fixedCost": 123,
"pledgeDeclared": 123,
"deposit": 123,
"rewardAddr": "<string>",
"owners": [
"<string>"
],
"relays": [
{
"ipv4": "<string>",
"ipv6": "<string>",
"dns": "<string>",
"port": 123
}
],
"metaUrl": "<string>",
"metaHash": "<string>",
"metaJson": "<unknown>",
"vrfKeyHash": "<string>",
"opCertCounter": 123,
"blockCount": 123,
"blocksMinted": 123,
"activeStake": 123,
"liveStake": 123,
"livePledge": 123,
"sigma": 123,
"liveSaturationPct": 123,
"liveStakePct": 123,
"liveDelegators": 123,
"ticker": "<string>",
"poolGroup": "<string>",
"name": "<string>",
"homepage": "<string>",
"description": "<string>",
"ros": 123,
"extendedMetadata": "<unknown>"
}
][
{
"poolIdBech32": "<string>",
"poolIdHex": "<string>",
"poolStatus": "<string>",
"activeEpochNo": 123,
"retiringEpoch": 123,
"marginPct": 123,
"fixedCost": 123,
"pledgeDeclared": 123,
"deposit": 123,
"rewardAddr": "<string>",
"owners": [
"<string>"
],
"relays": [
{
"ipv4": "<string>",
"ipv6": "<string>",
"dns": "<string>",
"port": 123
}
],
"metaUrl": "<string>",
"metaHash": "<string>",
"metaJson": "<unknown>",
"vrfKeyHash": "<string>",
"opCertCounter": 123,
"blockCount": 123,
"blocksMinted": 123,
"activeStake": 123,
"liveStake": 123,
"livePledge": 123,
"sigma": 123,
"liveSaturationPct": 123,
"liveStakePct": 123,
"liveDelegators": 123,
"ticker": "<string>",
"poolGroup": "<string>",
"name": "<string>",
"homepage": "<string>",
"description": "<string>",
"ros": 123,
"extendedMetadata": "<unknown>"
}
][
{
"poolIdBech32": "<string>",
"poolIdHex": "<string>",
"poolStatus": "<string>",
"activeEpochNo": 123,
"retiringEpoch": 123,
"marginPct": 123,
"fixedCost": 123,
"pledgeDeclared": 123,
"deposit": 123,
"rewardAddr": "<string>",
"owners": [
"<string>"
],
"relays": [
{
"ipv4": "<string>",
"ipv6": "<string>",
"dns": "<string>",
"port": 123
}
],
"metaUrl": "<string>",
"metaHash": "<string>",
"metaJson": "<unknown>",
"vrfKeyHash": "<string>",
"opCertCounter": 123,
"blockCount": 123,
"blocksMinted": 123,
"activeStake": 123,
"liveStake": 123,
"livePledge": 123,
"sigma": 123,
"liveSaturationPct": 123,
"liveStakePct": 123,
"liveDelegators": 123,
"ticker": "<string>",
"poolGroup": "<string>",
"name": "<string>",
"homepage": "<string>",
"description": "<string>",
"ros": 123,
"extendedMetadata": "<unknown>"
}
]Authorizations
API key (programmatic access — recommended)
Send your API key in the X-Api-Key header. Keys start with nxs_ and are
created in the dashboard (or via POST /api/keys with a session JWT).
Each key is scoped to one chain and one network (for example
CARDANO_MAINNET), fixed at creation time. It cannot query a different network
on the same chain, and it cannot query a different chain at all. A mismatched
network parameter returns 400 Network Mismatch. Create one key per chain
and network under the same account.
This is the credential most integrations should use.
Query Parameters
Accepts either the value listed here (CARDANO_MAINNET) or its kebab-case alias (cardano-mainnet); matching is case-insensitive. Omit it and the network is taken from the API key. A value that disagrees with the key's own network returns 400 Network Mismatch.
CARDANO_MAINNET, CARDANO_PREPROD, CARDANO_PREVIEW, APEX_PRIME_MAINNET, APEX_VECTOR_MAINNET, APEX_VECTOR_TESTNET, MIDNIGHT_MAINNET, MIDNIGHT_PREPROD, MIDNIGHT_STAGENET, BITCOIN_MAINNET, BITCOIN_TESTNET4 Case-insensitive match against ticker, name or bech32 pool id
Sort field: ros (default), ticker or liveStake. Descending, nulls last.
Page number (1-based). Omit together with pageSize for the full set.
Pools per page. Defaults to 100 when page is supplied.
Response
Successfully retrieved stake pools
Show child attributes
Show child attributes