List
status: stable
List all known stake pools ordered by descending non_myopic_member_rewards
.
The non_myopic_member_rewards
— and thus the ordering — depends on the ?stake
query
parameter.
Some pools may also have metadata attached to them.
Query parameters
-
stake
integer Required The stake the user intends to delegate in Lovelace. Required.
Minimum value is
0
, maximum value is45000000000000000
.
GET
/stake-pools
curl \
--request GET https://localhost:8090/v2/stake-pools?stake=42
Response examples (400)
{
"message": "string",
"code": "query_param_missing"
}
Response examples (200)
[
{
"id": "pool1wqaz0q0zhtxlgn0ewssevn2mrtm30fgh2g7hr7z9rj5856457mm",
"metrics": {
"non_myopic_member_rewards": {
"quantity": 42000000,
"unit": "lovelace"
},
"relative_stake": {
"quantity": 42,
"unit": "percent"
},
"saturation": 0.74,
"produced_blocks": {
"quantity": 1337,
"unit": "block"
}
},
"cost": {
"quantity": 42000000,
"unit": "lovelace"
},
"margin": {
"quantity": 42,
"unit": "percent"
},
"pledge": {
"quantity": 42000000,
"unit": "lovelace"
},
"metadata": {
"ticker": "IOHK",
"name": "string",
"description": "string",
"homepage": "https://iohk.io"
},
"retirement": {
"epoch_number": 14,
"epoch_start_time": "2019-02-27T14:46:45Z"
},
"flags": [
"delisted"
]
}
]