Account Withdrawals

GET /v1/accounts/:stakeAddress/withdrawals

Get reward withdrawal 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/withdrawals" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

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

{
  "success": true,
  "data": [
    {
      "tx_hash": "abc123def456...",
      "amount": "5000000000",
      "block_time": "2024-01-15T12:00:00.000Z"
    }
  ],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 3,
    "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)
amount	string	Withdrawal amount in lovelace
block_time	string	Block time (ISO 8601)