Account Rewards
GET /v1/accounts/:stakeAddress/rewards
Get reward 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:
bash
curl -X GET "https://api.fireblocks.partners.iagon.com/v1/accounts/stake1ux3g2c9dx2nhhehyrezyxpkstartcqmu9hk63qgfkccw5rqttygt7/rewards?limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"Response:
Content-Type: application/json;charset=utf-8
json
{
"success": true,
"data": [
{
"epoch": 480,
"amount": "1234567890",
"pool_id": "pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy",
"reward_type": "member"
}
],
"pagination": {
"limit": 10,
"offset": 0,
"total": 150,
"hasMore": true
},
"last_updated": {
"slot_no": 123456789,
"block_hash": "abc123...",
"block_time": "2024-01-15T12:00:00Z"
}
}Response Fields:
| Field | Type | Description |
|---|---|---|
epoch | integer | Epoch when reward was earned |
amount | string | Reward amount in lovelace |
pool_id | string | Pool that generated the reward (bech32) |
reward_type | string | Type: leader, member, reserves, treasury, or refund |