Account Delegations

GET /v1/accounts/:stakeAddress/delegations

Get delegation history for a stake account showing all pool changes.

Parameters:

Parameter	Type	Description
stakeAddress	string	The stake address (bech32 stake1... or 56 hex characters)

Query Parameters:

Parameter	Type	Default	Description
limit	integer	100	Results per page (max 500)
offset	integer	0	Pagination offset
order	string	desc	Sort order (asc or desc)

Example Request:

curl -X GET "https://api.fireblocks.partners.iagon.com/v1/accounts/stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7/delegations" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

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

{
  "success": true,
  "data": [
    {
      "active_epoch": 420,
      "pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
      "tx_hash": "abc123def456...",
      "cert_index": 0
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 5,
    "hasMore": false
  },
  "last_updated": {
    "slot_no": 123456789,
    "block_hash": "abc123...",
    "block_time": "2024-01-15T12:00:00Z"
  }
}

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

{
  "success": false,
  "error": "Invalid stake address format (expected stake1... or 56 hex chars)"
}

Response Fields:

Field	Type	Description
active_epoch	integer	Epoch when delegation became active (tx epoch + 2)
pool_id	string	Pool delegated to (bech32)
tx_hash	string	Transaction hash (hex)
cert_index	integer	Certificate index in transaction