Pool Delegators List

GET /v1/pools/:poolId/delegators/list

Get a paginated list of individual delegators for a stake pool with their stake amounts.

Parameters:

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

Query Parameters:

Parameter	Type	Default	Description
limit	integer	100	Number of results per page (1-500)
offset	integer	0	Number of results to skip

Example Request:

# Get first 20 delegators (sorted by stake amount descending)
curl -X GET "https://api.fireblocks.partners.iagon.com/v1/pools/pool1qqqqpanw9zc0rzh0yp247nzf2s35uvnsm7aaesfl2nnejaev0uc/delegators/list?limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get next page
curl -X GET "https://api.fireblocks.partners.iagon.com/v1/pools/pool1qqqqpanw9zc0rzh0yp247nzf2s35uvnsm7aaesfl2nnejaev0uc/delegators/list?limit=20&offset=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

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

{
  "success": true,
  "data": {
    "pool_id": "pool1qqqqpanw9zc0rzh0yp247nzf2s35uvnsm7aaesfl2nnejaev0uc",
    "delegators": [
      {
        "stake_address": "stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7",
        "amount": "50000000000000",
        "active_epoch_no": 412
      },
      {
        "stake_address": "stake1uypq2zj9jmk5j82a0ndpv9k0hx7j2y9f7gsk9mprlg4p8sq9qz87m",
        "amount": "25000000000000",
        "active_epoch_no": 425
      }
    ]
  },
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 1250,
    "hasMore": true
  }
}

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
data.pool_id	string	The bech32 pool ID
data.delegators	array	Array of delegator objects
data.delegators[].stake_address	string	The delegator's bech32 stake address
data.delegators[].amount	string	Delegated stake amount (lovelace)
data.delegators[].active_epoch_no	integer	Epoch when delegation became active
pagination.limit	integer	Number of results requested
pagination.offset	integer	Number of results skipped
pagination.total	integer	Total number of delegators for this pool
pagination.hasMore	boolean	Whether more results are available

Pagination

Results are sorted by stake amount in descending order (largest delegators first). Use offset to paginate through results. The pagination.hasMore field indicates if there are more delegators beyond the current page.

Use Cases

This endpoint is useful for:

• Pool operator raffles and giveaways
• Delegator analytics dashboards
• Whale tracking and notifications
• Community engagement tools