Specific stake pool
GET /pools/:pool_id
Pool information.
Request
Path Parameters
pool_id string required
Bech32 or hexadecimal pool ID.
Example: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy
Responses
- 200
- 400
- 403
- 404
- 418
- 429
- 500
Return the pool information content
application/json
Schema
Example (from schema)
Schema
pool_id string required
Bech32 pool ID
hex string required
Hexadecimal pool ID.
vrf_key string required
VRF key hash
blocks_minted integer required
Total minted blocks
blocks_epoch integer required
Number of blocks minted in the current epoch
live_stake string required
live_size number required
live_saturation number required
live_delegators number required
active_stake string required
active_size number required
declared_pledge string required
Stake pool certificate pledge
live_pledge string required
Stake pool current pledge
margin_cost number required
Margin tax cost of the stake pool
fixed_cost string required
Fixed tax cost of the stake pool
reward_account string required
Bech32 reward account of the stake pool
owners string[] required
registration string[] required
retirement string[] required
{
"pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
"hex": "0f292fcaa02b8b2f9b3c8f9fd8e0bb21abedb692a6d5058df3ef2735",
"vrf_key": "0b5245f9934ec2151116fb8ec00f35fd00e0aa3b075c4ed12cce440f999d8233",
"blocks_minted": 69,
"blocks_epoch": 4,
"live_stake": "6900000000",
"live_size": 0.42,
"live_saturation": 0.93,
"live_delegators": 127,
"active_stake": "4200000000",
"active_size": 0.43,
"declared_pledge": "5000000000",
"live_pledge": "5000000001",
"margin_cost": 0.05,
"fixed_cost": "340000000",
"reward_account": "stake1uxkptsa4lkr55jleztw43t37vgdn88l6ghclfwuxld2eykgpgvg3f",
"owners": [
"stake1u98nnlkvkk23vtvf9273uq7cph5ww6u2yq2389psuqet90sv4xv9v"
],
"registration": [
"9f83e5484f543e05b52e99988272a31da373f3aab4c064c76db96643a355d9dc",
"7ce3b8c433bf401a190d58c8c483d8e3564dfd29ae8633c8b1b3e6c814403e95",
"3e6e1200ce92977c3fe5996bd4d7d7e192bcb7e231bc762f9f240c76766535b9"
],
"retirement": [
"252f622976d39e646815db75a77289cf16df4ad2b287dd8e3a889ce14c13d1a8"
]
}
Bad request
application/json
Schema
Example (from schema)
Schema
status_code integer required
error string required
message string required
{
"status_code": 400,
"error": "Bad Request",
"message": "Backend did not understand your request."
}
Authentication secret is missing or invalid
application/json
Schema
Example (from schema)
Schema
status_code integer required
error string required
message string required
{
"status_code": 403,
"error": "Forbidden",
"message": "Invalid project token."
}
Component not found
application/json
Schema
Example (from schema)
Schema
status_code integer required
error string required
message string required
{
"status_code": 404,
"error": "Not Found",
"message": "The requested component has not been found."
}
IP has been auto-banned for extensive sending of requests after usage limit has been reached
application/json
Schema
Example (from schema)
Schema
status_code integer required
error string required
message string required
{
"status_code": 418,
"error": "Requested Banned",
"message": "IP has been auto-banned for flooding."
}
Usage limit reached
application/json
Schema
Example (from schema)
Schema
status_code integer required
error string required
message string required
{
"status_code": 429,
"error": "Project Over Limit",
"message": "Usage is over limit."
}
Internal Server Error
application/json
Schema
Example (from schema)
Schema
status_code integer required
error string required
message string required
{
"status_code": 500,
"error": "Internal Server Error",
"message": "An unexpected response was received from the backend."
}
Loading...