GET One pool statistics per epoch
Pool activity statistics for a given pool per epoch number.
GET /api/bi/pools/{pool_hash}/stats
🎰 Parameters
| Name | Description | In | Type | Required |
|---|---|---|---|---|
| pool_hash | The Bech32 encoding of a given pool hash | path | string | true |
👨💻 Code samples
- Node.js
- Python
- Rust
const CBI = await new CardanoBI({ apiKey: 'YOUR-KEY', apiSecret: 'YOUR-SECRET' });
const stats = await CBI.bi.pools.stats_({ pool_hash: "pool1y24nj4qdkg35nvvnfawukauggsxrxuy74876cplmxsee29w5axc" });
console.log(stats);
CBI = CardanoBI(apiKey='YOUR-KEY', apiSecret='YOUR-SECRET' });
stats = await CBI.bi.pools.stats_(pool_hash='pool1y24nj4qdkg35nvvnfawukauggsxrxuy74876cplmxsee29w5axc');
print(stats);
let CBI = CardanoBI::new(Some("YOUR-KEY"), Some("YOUR-SECRET")).await.expect("Failed to initialize CardanoBI");
let stats_stats = CBI.bi.pools.stats_(Some("pool1y24nj4qdkg35nvvnfawukauggsxrxuy74876cplmxsee29w5axc"), HashMap::new()).await.expect("Failed to call endpoint");
println!("stats_stats: {:?}", stats_stats);
💌 Response Codes
- 200
- 400
- 401
- 402
- 403
- 404
- 429
OK: Successful request.
[
{
"epoch_no": 291,
"pool_hash": "pool1y24nj4qdkg35nvvnfawukauggsxrxuy74876cplmxsee29w5axc",
"tx_count": 0,
"block_count": 0,
"delegator_count": 1,
"delegated_stakes": 10003622270
},
"...",
{
"epoch_no": 390,
"pool_hash": "pool1y24nj4qdkg35nvvnfawukauggsxrxuy74876cplmxsee29w5axc",
"tx_count": 0,
"block_count": 0,
"delegator_count": 17,
"delegated_stakes": 209944176598
}
]
Bad Request: The request was unacceptable, often due to missing a required parameter.
Response schema is undefined.
Unauthorized: No valid API key provided.
Response schema is undefined.
Quota Exceeded: This API key has reached its usage limit on request.
Response schema is undefined.
Access Denied: The request is missing a valid API key or token.
Response schema is undefined.
Not Found: The requested resource cannot be found.
Response schema is undefined.
Too Many Requests: This API key has reached its rate limit.
Response schema is undefined.
💌 Response Schemas
- 200
- 400
- 401
- 402
- 403
- 404
- 429
Status Code 200
| Name | Type | Description |
|---|---|---|
| epoch_no | integer(int32) | The epoch number. |
| pool_hash | string | The Bech32 encoding of the pool hash. |
| tx_count | integer(int64) | The transaction count. |
| block_count | integer(int64) | The block count. |
| delegator_count | integer(int64) | The delegator count. |
| delegated_stakes | integer(int64) | The delegated stake for the given epoch and given pool (active stake). |
Status Code 400
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 401
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 402
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 403
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 404
| Name | Type | Description |
|---|
Response schema is undefined.
Status Code 429
| Name | Type | Description |
|---|
Response schema is undefined.