Account Registrations

GET /v1/accounts/:stakeAddress/registrations

Get registration and deregistration history for a stake account.

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/registrations" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

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

{
  "success": true,
  "data": [
    {
      "tx_hash": "abc123def456...",
      "action": "registered",
      "epoch": 412
    },
    {
      "tx_hash": "def789abc012...",
      "action": "deregistered",
      "epoch": 350
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 2,
    "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
tx_hash	string	Transaction hash (hex)
action	string	Either registered or deregistered
epoch	integer	Epoch when the action occurred