Pool Delegators

GET /v1/pools/:poolId/delegators

Get delegator count and total active stake for a pool. Returns aggregate data for privacy and performance.

Parameters:

Parameter	Type	Description
poolId	string	The pool ID (bech32 pool1... or 56 hex characters)

Example Request:

curl -X GET "https://api.fireblocks.partners.iagon.com/v1/pools/pool1qqqqpanw9zc0rzh0yp247nzf2s35uvnsm7aaesfl2nnejaev0uc/delegators" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

Content-Type: application/json;charset=utf-8

{
  "success": true,
  "data": {
    "pool_id": "pool1qqqqpanw9zc0rzh0yp247nzf2s35uvnsm7aaesfl2nnejaev0uc",
    "delegator_count": 1250,
    "active_stake": "64000000000000"
  }
}

Content-Type: application/json;charset=utf-8

{
  "success": false,
  "error": "Pool not found"
}

Content-Type: application/json;charset=utf-8

{
  "success": false,
  "error": "Invalid pool ID format (expected pool1... or 56 hex chars)"
}

Response Fields:

Field	Type	Description
pool_id	string	The bech32 pool ID
delegator_count	integer	Number of unique delegators
active_stake	string	Total active stake from epoch snapshot (lovelace)

Privacy Note

This endpoint returns aggregate statistics only. Individual delegator addresses and their stake amounts are not exposed to protect delegator privacy.